Errori

Ogni codice di errore restituito dall'API PkmnPrices, cosa lo causa e la struttura JSON di una risposta di errore.

L'API usa i codici di stato HTTP standard. Ogni risposta di errore contiene un body JSON con error.code, error.message e error.docs_url; quest'ultimo punta alla pagina che spiega cosa fare, così il client può mostrare un link utile senza scriverlo nel codice.

Stato	Codice	Descrizione
`400`	`bad_request`	Parametri della richiesta non validi
`401`	`unauthorized`	Chiave API mancante o non valida
`403`	`forbidden`	La chiave API non ha i permessi per questa risorsa
`404`	`not_found`	Risorsa non trovata
`429`	`rate_limited`	Troppe richieste, rallenta
`500`	`internal_error`	Qualcosa è andato storto da parte nostra

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"
  }
}

Un 429 significa che i crediti del giorno sono esauriti o che è stato superato il limite al minuto; limiti di richieste e crediti copre entrambi i casi. Un 403 di solito riguarda dati riservati a un altro piano più che una chiave sbagliata, e il confronto dei piani lo chiarisce.

Un endpoint ignora un parametro di query che non legge invece di rifiutarlo, e lo nomina in un header di risposta Warning, uno per parametro, insieme ai parametri che accetta. Se i risultati sembrano non filtrati, controlla prima quell’header: di solito la causa è un filtro scritto male. Alcune alternative comuni vengono lette come il nome documentato, ad esempio limit per per_page, q per name e days per period.