Codes d'erreur
Cette page constitue la source de vérité unique pour la gestion des erreurs. Les codes d'erreur spécifiques aux SDK sont documentés dans la page Gestion des erreurs de chaque SDK ; cette page couvre les erreurs au niveau du contrat API.
Codes de statut HTTP
| Code | Signification |
|---|---|
200 OK | La requête a réussi. |
400 Bad Request | Le payload est mal formé ou des champs obligatoires sont manquants. Le corps identifie les champs problématiques. |
401 Unauthorized | Authentification manquante, expirée ou invalide. |
403 Forbidden | L'authentification est valide, mais le tenant n'est pas activé pour la ressource demandée (ex. : appel d'une capacité absente de votre APIKEY). |
404 Not Found | La ressource n'existe pas ou n'appartient pas au tenant authentifié. |
409 Conflict | La ressource existe, mais n'est pas dans l'état adéquat pour cette opération (ex. : récupération de documents d'un processus encore en cours). |
410 Gone | La ressource existait, mais a été supprimée conformément à la politique de rétention (endpoints de récupération de documents), ou le processus existe mais s'est terminé en état d'erreur — voir Récupérer un processus. |
429 Too Many Requests | Vous avez atteint la limite de débit. Réessayez avec un backoff exponentiel. |
5xx | Erreur de plateforme. Réessayez avec un backoff ; en cas de persistance, contactez le support avec le corps de la réponse et l'horodatage. |
Politique de réessai
| Statut | Doit réessayer ? | Comment |
|---|---|---|
5xx | Oui | Backoff exponentiel (1s, 2s, 4s, 8s, …). Plafonné à 5 tentatives. |
429 | Oui | Respectez l'en-tête Retry-After si présent ; sinon, backoff exponentiel. |
4xx (autre) | Non | La requête est incorrecte. Corrigez les données avant de réessayer. |
401 | Conditionnellement | Actualisez le jeton d'accès une fois. Si la nouvelle requête retourne également 401, le problème est structurel — ne réessayez pas. |
La plateforme IDCloud n'expose actuellement pas de mécanisme de clé d'idempotence sur les endpoints de création. Soyez prudent lorsque vous réessayez Créer un processus — une erreur réseau sur un 5xx peut avoir réellement réussi côté serveur, et un nouvel essai créerait un processus en double. En cas de doute, récupérez les processus récents via votre ID de corrélation interne avant de réessayer.
Où vivent les erreurs SDK
Les catalogues d'erreurs du Android SDK, iOS SDK et Flutter SDK sont documentés dans la page Gestion des erreurs dédiée à chaque SDK :
Ces pages couvrent les erreurs côté appareil (permission caméra refusée, délai de capture dépassé, réseau inaccessible sur l'appareil) — distinctes des erreurs côté API documentées ici.