Authentification

Créer une clé

Ouvrez Settings, puis API keys. Donnez à la clé un nom qui dit où elle sera utilisée, puis créez-la.

La clé n’est affichée qu’une seule fois. Copiez-la tout de suite et gardez-la en lieu sûr, par exemple dans les variables d’environnement de votre serveur. Setherion n’en conserve qu’une empreinte, donc personne ne peut vous la montrer de nouveau, nous compris. Si vous la perdez, révoquez-la et créez-en une nouvelle.

Une clé commence par sth_, suivi de 43 lettres, chiffres, - et _ aléatoires, soit 47 caractères au total. Le nom peut compter jusqu’à 60 caractères ; un nom plus long est coupé.

L’envoyer avec chaque requête

Placez la clé dans l’en-tête 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()

Seul le schéma Bearer est lu. Une requête sans clé valide reçoit 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 en-tête absent, une clé mal orthographiée, une clé qui n’existe pas et une clé révoquée reçoivent tous la même réponse, qui ne vous dit donc jamais lequel de ces cas c’était.

Ce qu’une clé peut faire

Une clé agit comme vous. Elle peut faire ce que vous pouvez faire dans Setherion :

• voir les applications de votre tableau de bord, les vôtres et celles qui sont partagées avec vous ;
• lire le guide des stores et les réponses de confidentialité de toute application que vous pouvez ouvrir ;
• modifier les applications que vous pouvez modifier, en dépensant des crédits comme le fait une modification dans l’éditeur ;
• publier les applications que vous pouvez modifier, et rédiger leur fiche du store.

Votre rôle sur chaque application décide du reste. Un appel qui lit exige viewer ou plus ; un appel qui modifie une application ou dépense des crédits exige editor ou plus. Consultez Introduction pour savoir quel appel exige quoi.

Une clé ne peut pas modifier votre compte, votre forfait ou votre facturation, et elle ne peut pas créer ni révoquer de clés : cela n’est possible que lorsque vous êtes vous-même connecté à Setherion, si bien qu’une clé divulguée ne peut jamais en engendrer d’autres.

Révoquer une clé

Dans API keys, appuyez sur Revoke à côté de la clé. Elle cesse de fonctionner immédiatement. Les clés révoquées restent dans la liste pour que vous puissiez voir quand elles ont été utilisées pour la dernière fois.

Vous pouvez avoir jusqu’à 10 clés actives à la fois. En demander une 11e est refusé avec You have 10 active keys. Revoke one you no longer use to make another. La liste indique quand chaque clé a été utilisée pour la dernière fois, mis à jour au plus une fois par minute.

Se connecter sans clé

Les assistants d’IA se connectent avec une page de connexion et un bouton Allow au lieu d’une clé. Consultez MCP : connecter un assistant d’IA.

Les jetons que cette connexion produit ne fonctionnent que sur l’adresse de l’assistant (/api/mcp). Les endpoints de cette référence acceptent une clé d’API et rien d’autre.