Authentification
Chaque requête v3 est authentifiée par un jeton Bearer envoyé dans l’en-tête Authorization. Une clé qui ne s’authentifie pas et une clé authentifiée mais dépourvue du bon scope échouent de deux manières différentes, faciles à distinguer.
Les scopes sont documentés ailleurs
Cette page couvre l’en-tête et les cas d’échec. La liste complète des scopes v3, le format d’un jeton et la gestion des clés font l’objet d’une page dédiée. Clés d’API, scopes et contraintes de plateforme
Un exemple complet
Un appel minimal et authentifié à l’API v3 — la liste des conteneurs :
curl https://client-api.v5.livstick.com/api/v3/containers \
-H "Authorization: Bearer liv_<prefix>_<secret>"Clés inconnues, expirées ou révoquées
Une clé qui ne s’authentifie pas — parce qu’elle n’existe pas, a expiré ou a été révoquée — est signalée de la même façon : par UNAUTHORIZED, dans l’enveloppe d’erreur v3.
{
"error": {
"code": "UNAUTHORIZED",
"message": "..."
}
}Authentifiée, mais non autorisée
Une clé correctement authentifiée peut tout de même échouer sur une requête hors de ses scopes ou de ses contraintes. C’est un autre échec — FORBIDDEN, et non UNAUTHORIZED — qui signifie que la clé elle-même est valide.
{
"error": {
"code": "FORBIDDEN",
"message": "..."
}
}- UNAUTHORIZED signifie que la clé elle-même ne s’est pas authentifiée — absente, inconnue, expirée ou révoquée.
- FORBIDDEN signifie que la clé s’est authentifiée, mais que cette requête précise sort de ses scopes ou de sa contrainte de plateforme.
Chaque opération exige un scope
L’authentification confirme seulement qui appelle. Ce que la clé a le droit de faire se décide opération par opération, selon les scopes qu’elle porte — une clé qui peut lire les conteneurs ne peut ni en notifier ni en déverrouiller un, sauf si ces scopes lui ont été accordés séparément.