Aller au contenu

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.
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.

  • Testez le code, jamais le message.
  • Journalisez le request_id de chaque erreur.
  • Traitez un code inconnu comme son statut HTTP : de nouveaux codes peuvent apparaître.

© 2026 Qalebasse · Tano, plateforme de confiance numériquetano.africaDemander un accès[email protected]