Gestion des erreurs
Apprenez à gérer les erreurs d'API avec élégance dans votre application
Lorsqu'une erreur survient lors d'une requête API, AllNewsAPI renvoie une réponse d'erreur JSON contenant un code d'état et une enveloppe standardisée. Le corps de la réponse inclut systématiquement un objet « detail » avec un champ « message » décrivant l'erreur. Ce guide explique chaque type d'erreur et comment la gérer.
Format de réponse d'erreur
Toutes les réponses d'erreur de l'API (4xx et 5xx) utilisent une enveloppe JSON standardisée. Le champ detail.message contient systématiquement une description de l'erreur lisible par un humain.
Codes d'erreur
400 Mauvaise requête
Votre requête est mal formée ou il manque des paramètres obligatoires. Vérifiez vos paramètres de requête et réessayez.
401 Non autorisé
Votre clé API est invalide ou manquante. Vérifiez que votre clé API est correcte et incluse dans la requête.
403 Interdit
Votre compte n'est pas autorisé à effectuer cette requête. Cela peut se produire si vous tentez d'accéder à des fonctionnalités premium avec un forfait gratuit.
429 Trop de requêtes
Vous avez dépassé votre limite de requêtes quotidienne. Veuillez patienter jusqu'à la réinitialisation de cette limite à 00h00 UTC ou passez à un forfait supérieur.
503 Service indisponible
L'API est temporairement indisponible pour maintenance. Veuillez réessayer dans quelques minutes.
Exemple:
Bonnes pratiques de gestion des erreurs
- Vérifiez toujours le code d'état de la réponse avant de traiter les données.
- Mettre en œuvre un mécanisme de temporisation exponentielle pour la nouvelle tentative des requêtes ayant échoué.
- Extrayez le message d'erreur de response.detail.message pour un affichage convivial.