Quels codes d’état HTTP sont renvoyés?
Chaque erreur comporte un code d’état HTTP et un code d’erreur stable. Basez votre logique sur le code, et non sur le message.
Chaque réponse d’erreur comporte un code d’erreur et un message rédigé pour une personne. Les codes sont les suivants :
- 400 invalid_parameter : un paramètre est inconnu, mal formé ou hors limites
- 400 invalid_cursor : le curseur est mal formé, a expiré ou a été émis pour une autre clé ou d’autres filtres
- 401 unauthenticated : aucune clé n’a été envoyée, ou elle n’est pas reconnue ou a été révoquée
- 403 ip_not_allowed, key_paused, country_not_entitled ou upgrade_required : voir « Pourquoi est-ce que je reçois une erreur 403? »
- 404 not_found : le chemin n’existe pas
- 405 method_not_allowed : tous les points de terminaison sont en GET
- 429 rate_limited ou quota_exceeded : attendez la durée indiquée par Retry-After
- 500 internal_error : réessayez plus tard
- 503 not_configured ou service_unavailable : réessayez plus tard
De nouveaux codes peuvent être ajoutés. Traitez un code que vous ne reconnaissez pas comme un échec correspondant au code d’état HTTP avec lequel il arrive.