API
Gestion des erreurs
Comprendre les codes d'erreur et les formats de réponse de l'API.
Gestion des erreurs
Format des erreurs
Toutes les erreurs suivent un format JSON standard :
{
"type": "/errors/validation",
"title": "Validation Error",
"status": 422,
"detail": "Le champ 'recipient_phone' est invalide.",
"violations": [
{
"propertyPath": "recipientPhone",
"message": "Ce numéro de téléphone n'est pas valide."
}
]
}Codes HTTP
| Code | Signification | Action recommandée |
|---|---|---|
400 | Requête malformée | Vérifiez le format JSON et les paramètres |
401 | Non authentifié | Vérifiez votre token ou clé API |
403 | Accès refusé | Vérifiez vos permissions |
404 | Ressource introuvable | Vérifiez l'identifiant |
409 | Conflit | La ressource a été modifiée entre-temps |
422 | Erreur de validation | Corrigez les champs indiqués |
429 | Trop de requêtes | Attendez et réessayez |
500 | Erreur serveur | Contactez le support |
Erreurs de validation
Les erreurs 422 contiennent un tableau violations avec le détail par champ :
{
"violations": [
{
"propertyPath": "recipientAddress",
"message": "L'adresse est obligatoire."
},
{
"propertyPath": "weight",
"message": "Le poids doit être supérieur à 0."
}
]
}Bonnes pratiques
- Vérifiez toujours le code HTTP avant de parser le body
- Logguez les erreurs 5xx pour le debugging
- Implémentez un retry automatique pour les erreurs 429 et 503
- Affichez les messages de
violationsà l'utilisateur pour les 422
Voir aussi : Endpoints | Limites de débit