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

BC-4007Máximo mensual de consultas de empresa y fichas alcanzado

El saldo de API de un workspace Mega ha agotado su tope mensual de llamadas de cinco créditos: buscar empresa, perfil de empresa y fichas de detalle. Mega permite 500 al mes. Las búsquedas sencillas siguen funcionando.

Código

BC-4007

Estado HTTP

429 Too Many Requests

Reintentable

Sí

type

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

Qué respuesta recibes

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

{
  "type": "https://boletinclaro.es/v1/errores/BC-4007",
  "codigo": "BC-4007",
  "title": "Máximo mensual de consultas de empresa y fichas alcanzado",
  "status": 429,
  "detail": "Has alcanzado el máximo mensual de consultas de empresa y fichas de detalle. Las búsquedas sencillas siguen disponibles."
}

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

• Muchas consultas de empresa o fichas de detalle en el mes: son las que más recursos consumen, por eso tienen su propio tope además del saldo de créditos.

Cómo se arregla

1. Espera hasta el día 1 a las 00:00 UTC. Las búsquedas de oportunidades y boletines no se ven afectadas.
2. Guarda en tu lado las fichas que ya has consultado en vez de volver a pedirlas.
3. «X-Heavy-Remaining» indica cuántas te quedan antes de chocar.

¿Merece la pena reintentar?

Retry-After indica los segundos hasta el siguiente mes UTC.

No lo confundas con

• BC-4003 · Cuota mensual agotada 429
• BC-4004 · Límite mensual de perfiles alcanzado 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.