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

BC-2001Clave de API no válida

Falta la clave o no existe o fue revocada. Todas las rutas de datos requieren clave; la documentación es pública.

Código

BC-2001

Estado HTTP

401 Unauthorized

Reintentable

No

type

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

Qué respuesta recibes

HTTP/1.1 401 Unauthorized
Content-Type: application/problem+json

{
  "type": "https://boletinclaro.es/v1/errores/BC-2001",
  "codigo": "BC-2001",
  "title": "Clave de API no válida",
  "status": 401,
  "detail": "Clave de API no válida o revocada."
}

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

• La clave fue revocada desde Ajustes → API.
• Está copiada a medias: el secreto solo se enseña una vez, al crearla.
• Se coló un espacio, un salto de línea o las comillas del ejemplo al pegarla.
• Estás mandando el identificador de la clave en lugar del secreto. El que vale empieza por «bc_live_».
• La cabecera no tiene la forma esperada: «Authorization: Bearer bc_live_…» o «X-API-Key: bc_live_…».

Cómo se arregla

1. En Ajustes → API puedes ver qué claves siguen vivas y cuándo se usó cada una por última vez.
2. Si perdiste el secreto, crea una clave nueva y revoca la vieja: no hay forma de volver a enseñar el de una clave que ya existe.
3. Crea una cuenta Gratis y emite una clave en Ajustes → API para probar con 100 créditos al mes.

¿Merece la pena reintentar?

No. La misma clave dará el mismo error hasta que la cambies.

Dónde mirar

• Ajustes → API: crear y revocar claves, y ver el consumo

No lo confundas con

• BC-2002 · Tu plan no incluye la API 403
• BC-4001 · Demasiadas solicitudes 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.