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

BC-4002Límite de peticiones superado

Has pasado el ritmo por minuto de tu clave. Este cubo es tuyo y no lo comparte nadie.

Código

BC-4002

Estado HTTP

429 Too Many Requests

Reintentable

Sí

type

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

Qué respuesta recibes

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

{
  "type": "https://boletinclaro.es/v1/errores/BC-4002",
  "codigo": "BC-4002",
  "title": "Límite de peticiones superado",
  "status": 429,
  "detail": "Has superado el límite de peticiones por minuto de tu clave."
}

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

• Una ráfaga en paralelo: varios trabajadores compartiendo la misma clave.
• Un reintento inmediato detrás de otro error, sin esperar.

Cómo se arregla

1. Espera los segundos de «Retry-After» y sigue. No hace falta backoff exponencial: la ventana es de un minuto.
2. Limita la concurrencia de los procesos que comparten una clave.
3. Las cabeceras «X-RateLimit-*» dicen cuánto te queda antes de chocar, en toda respuesta autenticada.

¿Merece la pena reintentar?

Sí, y pronto: «Retry-After» trae los segundos que faltan, siempre menos de un minuto. Espera eso y sigue.

No lo confundas con

• BC-4001 · Demasiadas solicitudes 429
• BC-4003 · Cuota mensual agotada 429

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.