Errores

API BCE usa códigos de estado HTTP convencionales. 2xx = éxito, 4xx = problema con tu solicitud, 5xx = problema de nuestro lado.

Códigos de estado#

Tipo	Descripción
`400`	Solicitud mal formada o falta un parámetro requerido.
`401`	Credenciales API ausentes o inválidas.
`402`	Suscripción inactiva o cuota mensual agotada.
`403`	Tu clave no tiene permiso para acceder a este recurso.
`404`	La entidad solicitada no existe.
`412`	No se cumplió una precondición requerida (p. ej. cabeceras).
`429`	Límite por hora o cuota mensual superado.
`500`	Algo falló de nuestro lado. Reinténtalo más tarde.

Los errores usan el mismo envelope; el mensaje está en error. Los errores de cuota y límite añaden plan, limit y resetAt.

{
  "success": false,
  "error": "Monthly quota exceeded",
  "plan": "free",
  "limit": 1000,
  "resetAt": "2026-07-01T00:00:00.000Z"
}

ℹ️

Reintenta las respuestas 429 y 5xx con backoff exponencial. No reintentes errores 4xx salvo el 429.