Errores

Cada código de error que devuelve la API de PkmnPrices, qué lo provoca y la estructura JSON de una respuesta de error.

La API usa códigos de estado HTTP estándar. Cada respuesta de error lleva un cuerpo JSON con error.code, error.message y error.docs_url; este último apunta a la página que explica qué hacer, para que quien llama pueda mostrar un enlace útil sin escribirlo a mano en el código.

Estado	Código	Descripción
`400`	`bad_request`	Parámetros de solicitud no válidos
`401`	`unauthorized`	Clave de API ausente o no válida
`403`	`forbidden`	La clave de API no tiene permiso para este recurso
`404`	`not_found`	Recurso no encontrado
`429`	`rate_limited`	Demasiadas solicitudes, ve más despacio
`500`	`internal_error`	Algo ha fallado por nuestra parte

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 que se han agotado los créditos del día o que se ha superado el límite por minuto; límites de solicitudes y créditos cubre ambos casos. Un 403 suele deberse a datos reservados a otro plan, no a una clave incorrecta, y la comparativa de planes lo aclara.

Un endpoint ignora un parámetro de consulta que no lee en lugar de rechazarlo, y lo nombra en una cabecera de respuesta Warning, una por parámetro, junto con los parámetros que acepta. Si los resultados parecen sin filtrar, mira primero esa cabecera: lo habitual es un filtro mal escrito. Algunas alternativas comunes se leen como el nombre documentado, como limit por per_page, q por name y days por period.