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

BC-4005Límite diario de créditos alcanzado

El saldo de API de un workspace Mega ha consumido su tope diario de créditos, compartido por todas sus claves. Mega permite 1.500 créditos al día en la API y otros 1.500 en la aplicación, cada uno por separado. Se renueva a las 00:00 UTC.

Código: BC-4005
Estado HTTP: 429 Too Many Requests
Reintentable: Sí
type: https://boletinclaro.es/v1/errores/BC-4005

Qué respuesta recibes

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

{
  "type": "https://boletinclaro.es/v1/errores/BC-4005",
  "codigo": "BC-4005",
  "title": "Límite diario de créditos alcanzado",
  "status": 429,
  "detail": "Tu cuenta ha alcanzado el límite diario de créditos. Se renueva a las 00:00 UTC."
}

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-4005

Mucho tráfico en un solo día, por ejemplo un rastreador o un bucle de reintentos en tu integración.
Todas las claves del workspace suman en el mismo tope diario, aunque todavía queden créditos del mes.

Cómo se arregla

Espera hasta las 00:00 UTC: «Retry-After» trae los segundos exactos y «X-Quota-Daily-Reset» la hora en RFC 3339.
Si tu web es pública, pon una caché o un límite por visitante delante de la API: «X-Quota-Daily-Remaining» te dice cuánto queda hoy.
Si el tope diario se te queda corto de forma sostenida, escríbenos.

¿Merece la pena reintentar?

Sí, pero no antes de las 00:00 UTC: «Retry-After» indica los segundos que faltan. Reintentar antes no puede funcionar.

No lo confundas con

BC-4003 · Cuota mensual agotada 429
BC-4002 · Límite de peticiones superado 429

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.