Autenticazione

Creare una chiave

Apri Settings, poi API keys. Dai alla chiave un nome che dica dove verrà usata, poi creala.

La chiave viene mostrata una sola volta. Copiala subito e conservala in un posto sicuro, come le variabili d’ambiente del tuo server. Setherion ne conserva solo un’impronta, quindi nessuno può mostrartela di nuovo, noi compresi. Se la perdi, revocala e creane una nuova.

Una chiave inizia con sth_, seguito da 43 lettere casuali, cifre, - e _, 47 caratteri in tutto. Il nome può arrivare a 60 caratteri; uno più lungo viene tagliato.

Inviarla con ogni richiesta

Metti la chiave nell’intestazione 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()

Viene letto solo lo schema Bearer. Una richiesta senza una chiave valida riceve 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’intestazione mancante, una chiave scritta male, una che non esiste e una che è stata revocata ricevono tutte la stessa risposta, quindi non ti dice mai quale fosse.

Cosa può fare una chiave

Una chiave agisce come te. Può fare ciò che puoi fare tu in Setherion:

• vedere le app sulla tua dashboard, le tue e quelle condivise con te;
• leggere la guida agli store e le risposte sulla privacy di qualsiasi app che puoi aprire;
• modificare le app che puoi modificare, spendendo crediti come fa una modifica nell’editor;
• pubblicare le app che puoi modificare, e scrivere la loro scheda dello store.

Il tuo ruolo su ciascuna app decide il resto. Una chiamata che legge richiede viewer o più; una chiamata che modifica un’app o spende crediti richiede editor o più. Vedi Introduzione per sapere quale chiamata richiede cosa.

Una chiave non può modificare il tuo account, il tuo piano o la tua fatturazione, e non può creare né revocare chiavi: è possibile solo quando hai effettuato tu stesso l’accesso a Setherion, così una chiave trapelata non può mai generarne altre.

Revocare una chiave

In API keys, premi Revoke accanto alla chiave. Smette di funzionare subito. Le chiavi revocate restano nell’elenco così puoi vedere quando sono state usate l’ultima volta.

Puoi avere fino a 10 chiavi attive alla volta. Chiedere l’undicesima viene rifiutato con You have 10 active keys. Revoke one you no longer use to make another. L’elenco mostra quando ogni chiave è stata usata l’ultima volta, aggiornato al massimo una volta al minuto.

Accedere senza una chiave

Gli assistenti IA si collegano con una pagina di accesso e un pulsante Allow invece di una chiave. Vedi MCP: collegare un assistente IA.

I token che quell’accesso produce funzionano solo sull’indirizzo dell’assistente (/api/mcp). Gli endpoint di questo riferimento accettano una chiave API e nient’altro.