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

BC-4003Cuota mensual agotada

Has consumido los créditos mensuales de tu saldo. En Gratis y Pro es un saldo del workspace compartido entre MCP, API y web; en Mega, la API y la aplicación tienen cada una el suyo. Se renuevan el día 1 a las 00:00 UTC.

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 cuenta. 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

• Búsquedas y lecturas sencillas cuestan 1 crédito; buscar empresa, perfil y detalles cuestan 5. Se cuentan las admisiones incluso con caché o error posterior.
• En Gratis y Pro todas las claves, usuarios y clientes MCP del workspace comparten los créditos; en Mega, todas las claves comparten los de la API.
• 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 la cuenta en Ajustes → API.
3. Si la cuota se te queda corta de forma sostenida, escríbenos.

¿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 de la cuenta

No lo confundas con

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

Los 16 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.