Authentifizierung

Einen Schlüssel erstellen

Öffnen Sie Settings und dann API keys. Geben Sie dem Schlüssel einen Namen, der sagt, wo er verwendet wird, und erstellen Sie ihn dann.

Der Schlüssel wird einmal angezeigt. Kopieren Sie ihn sofort und bewahren Sie ihn an einem sicheren Ort auf, zum Beispiel in den Umgebungsvariablen Ihres Servers. Setherion speichert nur einen Fingerabdruck davon, sodass ihn niemand Ihnen noch einmal zeigen kann, auch wir nicht. Wenn Sie ihn verlieren, widerrufen Sie ihn und erstellen Sie einen neuen.

Ein Schlüssel beginnt mit sth_, gefolgt von 43 zufälligen Buchstaben, Ziffern, - und _, insgesamt 47 Zeichen. Der Name darf bis zu 60 Zeichen lang sein; ein längerer wird abgeschnitten.

Mit jeder Anfrage mitsenden

Setzen Sie den Schlüssel in den Header Authorization:

curl https://www.setherion.com/api/v1/projects \
  -H "Authorization: Bearer $SETHERION_API_KEY"

const res = await fetch('https://www.setherion.com/api/v1/projects', {
  headers: { Authorization: `Bearer ${process.env.SETHERION_API_KEY}` },
})
const data = await res.json()

Nur das Schema Bearer wird gelesen. Eine Anfrage ohne gültigen Schlüssel erhält 401:

{
  "ok": false,
  "error": "A valid API key is required. Make one on your Setherion account page and send it as \"Authorization: Bearer sth_...\"."
}

Ein fehlender Header, ein falsch geschriebener Schlüssel, einer, den es nicht gibt, und einer, der widerrufen wurde, erhalten alle dieselbe Antwort, sodass sie nie verrät, welcher Fall vorlag.

Was ein Schlüssel kann

Ein Schlüssel handelt als Sie. Er kann tun, was Sie in Setherion tun können:

• die Apps in Ihrem Dashboard sehen, Ihre eigenen und die mit Ihnen geteilten;
• die Store-Anleitung und die Datenschutzantworten jeder App lesen, die Sie öffnen können;
• die Apps ändern, die Sie bearbeiten können, und dabei Credits ausgeben, so wie eine Änderung im Editor es tut;
• die Apps veröffentlichen, die Sie bearbeiten können, und ihre Store-Seite schreiben.

Ihre Rolle in der jeweiligen App entscheidet über den Rest. Ein Aufruf, der liest, braucht viewer oder mehr; ein Aufruf, der eine App ändert oder Credits ausgibt, braucht editor oder mehr. Welcher Aufruf was braucht, steht unter Einführung.

Ein Schlüssel kann weder Ihr Konto noch Ihren Tarif noch Ihre Abrechnung ändern, und er kann keine Schlüssel erstellen oder widerrufen: Das ist nur möglich, wenn Sie selbst bei Setherion angemeldet sind, sodass ein einziger durchgesickerter Schlüssel nie andere erzeugen kann.

Einen Schlüssel widerrufen

Klicken Sie unter API keys neben dem Schlüssel auf Revoke. Er funktioniert sofort nicht mehr. Widerrufene Schlüssel bleiben in der Liste, damit Sie sehen können, wann sie zuletzt verwendet wurden.

Sie können bis zu 10 aktive Schlüssel gleichzeitig haben. Ein elfter wird mit You have 10 active keys. Revoke one you no longer use to make another. abgelehnt. Die Liste zeigt, wann jeder Schlüssel zuletzt verwendet wurde, höchstens einmal pro Minute aktualisiert.

Anmelden ohne Schlüssel

KI-Assistenten verbinden sich über eine Anmeldeseite und eine Schaltfläche Allow statt über einen Schlüssel. Siehe MCP: einen KI-Assistenten verbinden.

Die Tokens, die diese Anmeldung erzeugt, funktionieren nur an der Adresse des Assistenten (/api/mcp). Die Endpunkte in dieser Referenz nehmen einen API-Schlüssel und sonst nichts.