¿Qué códigos de estado HTTP se devuelven?
Cada error incluye un estado HTTP y un código de error estable. Base su lógica en el código, no en el mensaje.
Cada respuesta de error tiene un código de error y un mensaje redactado para una persona. Los códigos son:
- 400 invalid_parameter: un parámetro es desconocido, está mal formado o está fuera de rango
- 400 invalid_cursor: el cursor está mal formado, ha caducado o se emitió para otra clave u otros filtros
- 401 unauthenticated: no se envió ninguna clave, o no se reconoce o ha sido revocada
- 403 ip_not_allowed, key_paused, country_not_entitled o upgrade_required: consulte «¿Por qué recibo un error 403?»
- 404 not_found: la ruta no existe
- 405 method_not_allowed: todos los endpoints son GET
- 429 rate_limited o quota_exceeded: espere el periodo indicado en Retry-After
- 500 internal_error: vuelva a intentarlo más tarde
- 503 not_configured o service_unavailable: vuelva a intentarlo más tarde
Es posible que se añadan códigos nuevos. Trate un código que no reconozca como un fallo correspondiente al estado HTTP con el que llega.