Erreurs

Chaque code d'erreur renvoyé par l'API PkmnPrices, sa cause et la structure JSON d'une réponse d'erreur.

L'API utilise les codes de statut HTTP standard. Chaque réponse d'erreur contient un corps JSON avec error.code, error.message et error.docs_url, ce dernier pointant vers la page qui explique quoi faire : un client peut ainsi afficher un lien utile sans le coder en dur.

Statut	Code	Description
`400`	`bad_request`	Paramètres de requête invalides
`401`	`unauthorized`	Clé API absente ou invalide
`403`	`forbidden`	La clé API n'a pas accès à cette ressource
`404`	`not_found`	Ressource introuvable
`429`	`rate_limited`	Trop de requêtes, ralentissez
`500`	`internal_error`	Une erreur s'est produite de notre côté

json

{
  "error": {
    "code": "unauthorized",
    "message": "Missing or invalid API key. Pass a valid key in the X-API-Key header.",
    "docs_url": "https://www.pkmnprices.com/docs#authentication"
  }
}

Une erreur 429 signifie que les crédits du jour sont épuisés ou que la limite par minute a été dépassée ; la page limites de requêtes et crédits couvre les deux cas. Une erreur 403 concerne généralement des données réservées à une autre offre plutôt qu'une mauvaise clé, ce que la comparaison des offres permet de trancher.

Un endpoint ignore un paramètre de requête qu’il ne lit pas au lieu de le rejeter, et le nomme dans un en-tête de réponse Warning, un par paramètre, avec la liste des paramètres qu’il accepte. Si les résultats semblent non filtrés, regardez d’abord cet en-tête : un filtre mal orthographié en est la cause habituelle. Quelques variantes courantes sont lues comme le nom documenté, par exemple limit pour per_page, q pour name et days pour period.