API de Boletín Claro · Errores · BC-4003

BC-4003Cuota mensual agotada

Has consumido la cuota mensual de tu clave. Es el otro 429, y no se parece en nada al anterior: este no se despeja esperando un rato.

Código

BC-4003

Estado HTTP

429 Too Many Requests

Reintentable

No

type

https://boletinclaro.es/v1/errores/BC-4003

Qué respuesta recibes

HTTP/1.1 429 Too Many Requests
Content-Type: application/problem+json

{
  "type": "https://boletinclaro.es/v1/errores/BC-4003",
  "codigo": "BC-4003",
  "title": "Cuota mensual agotada",
  "status": 429,
  "detail": "Has agotado la cuota mensual de tu clave de API. Se renueva el día 1."
}

El campo estable es codigo, y es el final de type. El title y el detail están para leerlos: podemos reescribirlos sin avisar.

Por qué ocurre BC-4003

• La clave llegó a su cuota del mes. Se cuenta una por petición admitida, sin importar cuántos resultados devuelva.
• La cuota es por clave, no por espacio de trabajo: dos claves del mismo espacio tienen cada una la suya.
• Un bucle de reintentos consumió la cuota sin que nadie lo mirara.

Cómo se arregla

1. Trata la clave como agotada hasta el día 1 en vez de sondearla: «Retry-After» trae los segundos exactos y «X-RateLimit-Reset» la fecha en RFC 3339.
2. Mira el consumo del mes de cada clave en Ajustes → API.
3. Si la cuota se te queda corta de forma sostenida, escríbenos antes de repartir la carga entre varias claves.

¿Merece la pena reintentar?

No hasta el día 1 del mes que viene. Reintentar antes no puede funcionar: para el resto del mes trata la clave como agotada en vez de sondearla.

Dónde mirar

• Ajustes → API: el consumo del mes, por clave

No lo confundas con

• BC-4002 · Límite de peticiones superado 429
• BC-2002 · Tu plan no incluye la API 403

Los 11 errores de la API

El catálogo completo, con el código y el estado de cada uno, está en https://boletinclaro.es/v1/errores. Responde también en JSON con Accept: application/json. La referencia de la API está en https://boletinclaro.es/v1.