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

BC-4004Límite mensual de perfiles alcanzado

Gratis permite cinco llamadas mensuales a perfil_empresa o /v1/empresas/{nif}, compartidas entre MCP y API, aunque se repita el NIF.

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

Qué respuesta recibes

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

{
  "type": "https://boletinclaro.es/v1/errores/BC-4004",
  "codigo": "BC-4004",
  "title": "Límite mensual de perfiles alcanzado",
  "status": 429,
  "detail": "Has alcanzado las cinco llamadas mensuales a perfiles de empresa del plan Gratis."
}

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

El workspace agotó su tope de perfiles, aunque todavía tenga créditos.

Cómo se arregla

Espera hasta el día 1 a las 00:00 UTC o cambia de plan en /planes.
Consulta X-Profiles-Remaining y Retry-After. Los rechazos no consumen.

¿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-4002 · Límite de peticiones superado 429

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