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

BC-4001Demasiadas solicitudes

Has pasado el límite anónimo de 20 peticiones por minuto. Ese cubo va por IP y se comparte con todo el que salga por la misma, así que puedes toparte con él sin haber hecho tú las peticiones.

Código

BC-4001

Estado HTTP

429 Too Many Requests

Reintentable

Sí

type

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

Qué respuesta recibes

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

{
  "type": "https://boletinclaro.es/v1/errores/BC-4001",
  "codigo": "BC-4001",
  "title": "Demasiadas solicitudes",
  "status": 429,
  "detail": "Demasiadas solicitudes desde esta IP. Inténtalo de nuevo más tarde, o usa una clave de API para tu propio límite."
}

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

• Estás llamando sin clave y has pasado de 20 peticiones en un minuto.
• Compartes IP de salida con más gente: una oficina, un CI, una función serverless o el NAT de una nube.
• Varios procesos tuyos llaman a la vez sin coordinarse.

Cómo se arregla

1. Lee la cabecera «Retry-After» y espera esos segundos: siempre son menos de un minuto.
2. Si te pasa a menudo, usa una clave. Con clave tienes tu propio cubo y dejas de competir por el compartido.
3. Espacia las llamadas en lugar de lanzarlas en paralelo.

¿Merece la pena reintentar?

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

No lo confundas con

• BC-4002 · Límite de peticiones superado 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.