Gestion des erreurs

Notre API utilise des codes de réponse HTTP standard pour indiquer la réussite ou l'échec des requêtes. Voici les codes d'erreur courants que vous pourriez rencontrer et comment les gérer.

Codes de statut HTTP
200 OK

La requête a réussi.

400 Bad Request

La requête était invalide ou ne peut pas être traitée.

401 Unauthorized

L'authentification a échoué ou n'a pas été fournie.

403 Forbidden

La requête est comprise mais a été refusée, ou l'accès n'est pas autorisé.

404 Not Found

La ressource demandée est introuvable.

429 Too Many Requests

Vous avez dépassé la limite de débit.

500 Internal Server Error

Une erreur s'est produite de notre côté.

Format de réponse d'erreur
Toutes les réponses d'erreur suivent ce format :
{
  "error": "error_code",
  "message": "Human-readable error message",
  "details": {}
}
Codes d'erreur courants

invalid_api_key: La clé API fournie est invalide.

missing_api_key: Aucune clé API n'a été fournie.

invalid_ip: L'adresse IP fournie est invalide.

invalid_domain: Le domaine fourni est invalide.

rate_limit_exceeded: Vous avez dépassé votre limite de débit.

quota_exceeded: Vous avez dépassé votre quota mensuel.

server_error: Une erreur interne du serveur s'est produite.

Bonnes pratiques de gestion des erreurs

Vérifiez les codes de statut : Vérifiez toujours le code de statut HTTP avant de traiter la réponse.

Gérez les limites de débit : Mettez en œuvre une logique appropriée de délai d'attente et de nouvelle tentative pour les erreurs 429.

Journalisez les erreurs : Journalisez des informations d'erreur détaillées à des fins de débogage.

Dégradation gracieuse : Prévoyez des mécanismes de repli lorsque l'API est indisponible.