Gérer les erreurs
Toute erreur de l’API a la même forme, sur toutes les routes et dans tous les modules :
{ "error": { "type": "validation_error", "code": "unsupported_document_type", "message": "Le parcours n'accepte pas les pièces émises par ML.", "doc_url": "https://docs.tano.africa/errors/unsupported_document_type", "request_id": "req_…", "field": "subject" }}| Champ | Ce qu’il dit |
|---|---|
type |
La famille de l’erreur, qui suit le statut HTTP. |
code |
La cause exacte. Stable : c’est lui que votre code teste. |
message |
Une phrase pour le développeur. Elle peut changer : ne la testez pas, ne l’affichez pas telle quelle à vos clients. |
doc_url |
La page de ce code dans cette documentation. |
request_id |
L’identifiant de la requête. Donnez-le au support : il la retrouve sans rien vous redemander. |
field |
Le champ en cause, quand il y en a un. |
Que faire selon le statut
Section intitulée « Que faire selon le statut »| Statut | Ce qui se passe | Que faire |
|---|---|---|
400 |
La requête est mal formée ou un champ est refusé. | Corriger la requête. La réessayer telle quelle échouera encore. |
401 |
La clé ou la signature de la requête n’est pas acceptée. | Vérifier la clé, l’horloge et la signature. |
403 |
La clé n’a pas le droit : portée, permission, contrat, adresse IP. | Changer de clé ou de contrat ; voir Clés et environnements. |
404 |
La ressource n’existe pas, ou pas dans l’environnement de la clé. | Vérifier l’identifiant et l’environnement de la clé. |
409 |
La ressource n’est pas dans le bon état pour cette action. | Relire son état (GET), puis agir en conséquence. |
429 |
Trop de requêtes. | Attendre, puis réessayer en espaçant. |
500, 502, 503 |
Un incident de notre côté ou chez un fournisseur. | Réessayer plus tard, avec la même Idempotency-Key. |
Réessayer une création avec la même Idempotency-Key ne crée jamais de doublon : voir
l’idempotence.
Conseils
Section intitulée « Conseils »- Testez le
code, jamais lemessage. - Journalisez le
request_idde chaque erreur. - Traitez un code inconnu comme son statut HTTP : de nouveaux codes peuvent apparaître.
Étapes suivantes
Section intitulée « Étapes suivantes »- Le catalogue des erreurs, rangé par module.
- Passer en production.
© 2026 Qalebasse · Tano, plateforme de confiance numériquetano.africaDemander un accès[email protected]