Référence
Codes d’erreur
Chaque erreur de l’API porte un code stable et un type qui pointe vers sa page.
| Code | Statut | Signification |
|---|---|---|
validation_failed | 400 | La requête ne respecte pas le schéma documenté. |
bad_request | 400 | Requête mal formée (JSON invalide, en-tête incorrect). |
invalid_cursor | 400 | Curseur de pagination modifié, tronqué ou d’une autre version. |
idempotency_key_required | 400 | L’opération exige un en-tête Idempotency-Key. |
invalid_idempotency_key | 400 | La clé ne respecte pas le format (8 à 128 caractères parmi lettres, chiffres et _ . : -). |
invalid_token | 401 | Jeton absent, expiré, révoqué ou destiné à une autre ressource. |
insufficient_scope | 403 | Le jeton ne porte pas le scope requis, indiqué dans detail et WWW-Authenticate. |
module_unavailable | 403 | Le module nécessaire n’est pas activé pour l’organisation. |
not_found | 404 | Ressource inexistante ou appartenant à une autre organisation. |
user_not_found | 404 | Utilisateur inexistant dans votre organisation. |
session_not_found | 404 | Diffusion inexistante dans votre organisation (400 sur le webhook historique). |
account_suspended | 409 | Le compte est désactivé ou suspendu ; une intégration ne peut pas le réactiver. |
account_managed | 409 | Le compte est géré par une source d’identité (SCIM) ou ne peut pas être provisionné. |
idempotency_in_progress | 409 | Une requête avec la même clé est encore en cours. |
idempotency_key_reused | 422 | La clé a déjà servi pour une requête différente. |
payload_too_large | 413 | Corps de requête trop volumineux. |
rate_limited | 429 | Limite de débit du client dépassée. |
temporarily_unavailable | 503 | Dépendance momentanément indisponible ; réessayez. |
internal_error | 500 | Erreur inattendue côté InTeach. |