Gestion des erreurs

Toutes les erreurs de l'API suivent un format cohérent. Voici comment les gérer proprement.

Format de la réponse d'erreur

En cas d'erreur, l'API renvoie un objet JSON avec cette structure :

json

{
  "error": "Validation Error",
  "message": "The email field is required.",
  "status_code": 422
}

Codes d'erreur

Code de statut	Erreur	Cause et solution
`400`	Requête incorrecte	JSON mal formé ou champs obligatoires manquants. Vérifiez le corps de votre requête.
`401`	Non autorisé	Clé API manquante ou invalide. Vérifiez votre en-tête `Authorization` .
`402`	Paiement requis	Crédits insuffisants. Achetez des crédits supplémentaires ou attendez la réinitialisation de la limite quotidienne.
`422`	Erreur de validation	Le format de l'adresse e-mail est invalide. Vérifiez la valeur que vous envoyez.
`429`	Trop de requêtes	Limite de requêtes dépassée. Consultez l'en-tête `Retry-After` et patientez.
`500`	Erreur interne du serveur	Un problème est survenu de notre côté. Réessayez dans quelques secondes. Contactez le support si l'erreur persiste.

401 Unauthorized

json

{
  "error": "Unauthorized",
  "message": "Invalid or missing API key",
  "status_code": 401
}

Solution : Vérifiez que votre en-tête Authorization est correctement formaté sous la forme Bearer YOUR_API_KEY. Vérifiez votre clé dans le tableau de bord.

422 Validation Error

json

{
  "error": "Validation Error",
  "message": "The email field must be a valid email address.",
  "status_code": 422
}

Solution : Assurez-vous que la valeur de l'e-mail respecte un format valide (par ex. user@example.com). Nettoyez vos données avant l'envoi.

429 Too Many Requests

json

{
  "error": "Too Many Requests",
  "message": "Rate limit exceeded. Please slow down.",
  "status_code": 429,
  "retry_after": 15
}

Solution : Attendez le nombre de secondes indiqué dans retry_after avant de réessayer. Voir Limites de requêtes →

Checklist de dépannage

✅ La clé API commence par ev_ et elle est correcte
✅ Authorization format de l'en-tête : Bearer YOUR_KEY (et non Token ou Basic)
✅ Content-Type: application/json l'en-tête est défini
✅ Le corps de la requête est un JSON valide
✅ email le champ est une chaîne, ni null ni absent
✅ Il vous reste des crédits (vérifiez Crédits →)