API de Boletín Claro · Errores · BC-2001
BC-2001Clave de API no válida
La clave que mandaste no existe o fue revocada. Ojo con esta: sin clave la API responde igualmente, con el límite compartido por IP, así que una clave mal copiada te deja peor que no mandar ninguna.
- Código
BC-2001- Estado HTTP
- 401 Unauthorized
- Reintentable
- No
typehttps://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
- En Ajustes → API puedes ver qué claves siguen vivas y cuándo se usó cada una por última vez.
- 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.
- Si solo estabas probando, quita la cabecera entera: la API responde sin clave, con el límite compartido por IP.
¿Merece la pena reintentar?
No. La misma clave dará el mismo error hasta que la cambies.
Dónde mirar
No lo confundas con
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.