Stable Pro API · v1

401 · unauthorized

La clé de l'API manque ou n'est pas valide

Quand cela arrive

L'en-tête Authorization: Bearer manque, ou la clé ne peut pas être utilisée. La réponse porte WWW-Authenticate: Bearer.

Champs supplémentaires

reason: Pourquoi la clé n'est pas valide : l'un des motifs ci-dessous.

Motifs

`reason`	Signification
`missing`	Aucune clé dans l'en-tête `Authorization: Bearer`.
`malformed`	La clé n'a pas la forme d'une clé de Stable Pro (`sp_live_` ou `sp_test_` suivi de 40 lettres et chiffres).
`wrong_environment`	Une clé `sp_test_` en production, ou une clé `sp_live_` sur le staging.
`unknown`	Aucune clé de ce type n'existe.
`connection_revoked`	Le titulaire de l'écurie a révoqué la connexion : toutes ses clés ont cessé de fonctionner.
`revoked`	Le titulaire de l'écurie a révoqué cette clé.
`expired`	La clé a atteint sa date d'expiration.
`rotated`	Une nouvelle clé a remplacé celle-ci, et les 7 jours pendant lesquels les deux fonctionnaient sont écoulés.

Que faire

Demandez au titulaire de l'écurie une clé valide (Paramètres → Connexions dans Stable Pro).

La réponse

{
  "type": "https://stable-pro.com/docs/api/problems/unauthorized",
  "title": "The API key is missing or not valid",
  "status": 401,
  "detail": "…"
}

Dans title, l'API écrit toujours le texte anglais : « The API key is missing or not valid ».

Décidez selon type, jamais selon detail : voir Erreurs.