Autentificare

Fă o cheie

Deschide Settings, apoi API keys. Dă cheii un nume care spune unde va fi folosită, apoi creează-o.

Cheia este arătată o singură dată. Copiază-o imediat și păstrează-o undeva sigur, de exemplu în variabilele de mediu ale serverului tău. Setherion păstrează doar o amprentă a ei, așa că nimeni nu ți-o mai poate arăta, nici noi. Dacă o pierzi, revocă-o și fă una nouă.

O cheie începe cu sth_, urmat de 43 de litere, cifre, - și _ alese la întâmplare, în total 47 de caractere. Numele poate avea până la 60 de caractere; unul mai lung este tăiat.

Trimite-o cu fiecare cerere

Pune cheia în antetul 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()

Se citește doar schema Bearer. O cerere fără o cheie validă primește 401:

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

Un antet lipsă, o cheie scrisă greșit, una care nu există și una care a fost revocată primesc toate același răspuns, așa că nu îți spune niciodată care dintre ele a fost.

Ce poate face o cheie

O cheie acționează ca tine. Poate face ce poți face tu în Setherion:

• vede aplicațiile din panoul tău de control, ale tale și cele partajate cu tine;
• citește ghidul pentru magazine și răspunsurile de confidențialitate ale oricărei aplicații pe care o poți deschide;
• modifică aplicațiile pe care le poți modifica, consumând credite în felul în care o modificare din editor le consumă;
• publică aplicațiile pe care le poți modifica și scrie pagina lor din magazin.

Rolul tău din fiecare aplicație hotărăște restul. Un apel care citește cere viewer sau mai mult; un apel care modifică o aplicație sau consumă credite cere editor sau mai mult. Vezi Introducere pentru ce apel cere ce.

O cheie nu îți poate schimba contul, planul sau facturarea și nu poate face sau revoca chei: asta se poate doar când ești tu însuți autentificat în Setherion, așa că o singură cheie scursă nu poate crea niciodată altele.

Revocă o cheie

În API keys, apasă Revoke lângă cheie. Încetează să mai funcționeze pe loc. Cheile revocate rămân în listă, ca să vezi când au fost folosite ultima oară.

Poți avea cel mult 10 chei active deodată. A 11-a este refuzată cu You have 10 active keys. Revoke one you no longer use to make another. Lista arată când a fost folosită ultima oară fiecare cheie, actualizat cel mult o dată pe minut.

Autentificarea fără cheie

Asistenții AI se conectează printr-o pagină de autentificare și un buton Allow, în loc de o cheie. Vezi MCP: conectează un asistent AI.

Tokenurile pe care le produce acea autentificare merg doar la adresa asistentului (/api/mcp). Endpointurile din această referință primesc o cheie API și nimic altceva.