Erreurs

Gestion des erreurs

L'API utilise des codes de réponse HTTP conventionnels pour indiquer le succès ou l'échec des requêtes.

Codes de statut HTTP

Code	Description
`200`	Succès - Requête complétée avec succès
`400`	Requête incorrecte - Paramètres de requête invalides
`401`	Non autorisé - Clé API invalide ou manquante
`404`	Non trouvé - La ressource demandée n'existe pas
`500`	Erreur serveur interne - Une erreur serveur s'est produite

Toutes les réponses d'erreur suivent un format cohérent:

Structure de la réponse d'erreurjson

{
  "success": false,
  "error": "Human-readable error message",
  "code": "ERROR_CODE"
}

Code	Description
`UNAUTHORIZED`	Clé API invalide ou manquante
`INVALID_PARAMS`	Échec de validation des paramètres de requête
`INVALID_ID`	Format UUID invalide pour l'ID du tarif
`NOT_FOUND`	Le tarif demandé n'existe pas
`DATABASE_ERROR`	Échec de la requête de base de données
`INTERNAL_ERROR`	Erreur serveur inattendue

Clé API manquante ou invalidejson

{
  "success": false,
  "error": "Unauthorized",
  "code": "UNAUTHORIZED"
}

Paramètres de requête invalidesjson

{
  "success": false,
  "error": "Invalid query parameters",
  "code": "INVALID_PARAMS"
}

Ressource introuvablejson

{
  "success": false,
  "error": "Tariff not found",
  "code": "NOT_FOUND"
}

1.Vérifiez toujours le champ success dans la réponse pour déterminer si la requête a réussi
2.Utilisez le champ code pour gérer les erreurs de manière programmatique dans votre application
3.Affichez le message error aux utilisateurs pour leur fournir un retour lisible
4.Mettez en œuvre un backoff exponentiel pour réessayer les requêtes échouées, en particulier pour les erreurs 5xx