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

BC-1001Consulta no válida

El parámetro «consulta» tiene menos de 2 caracteres, o no viaja en la petición. Por arriba no hay error: una consulta de más de 2.000 caracteres se recorta y la búsqueda sigue adelante.

Código

BC-1001

Estado HTTP

400 Bad Request

Reintentable

No

type

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

Qué respuesta recibes

HTTP/1.1 400 Bad Request
Content-Type: application/problem+json

{
  "type": "https://boletinclaro.es/v1/errores/BC-1001",
  "codigo": "BC-1001",
  "title": "Consulta no válida",
  "status": 400,
  "detail": "El parámetro «consulta» debe tener entre 2 y 2000 caracteres."
}

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

• El parámetro no llega: la API lo lee como «consulta», no como «q», «query» ni «busqueda».
• Llega vacío, o solo con espacios: se recortan antes de contar.
• Mandaste un único carácter.
• El valor no va codificado en la URL, y los espacios o las tildes se pierden por el camino.

Cómo se arregla

1. Manda en «consulta» una descripción de al menos dos caracteres.
2. Descríbelo en lenguaje natural, no en palabras clave sueltas: la búsqueda es semántica y «obras de reforma en colegios públicos» encuentra más que «obras colegios».
3. Codifica el valor en la URL (encodeURIComponent, urllib.parse.quote) antes de montar la petición.

¿Merece la pena reintentar?

No. La petición es la que está mal; reintentarla tal cual da el mismo error.

No lo confundas con

• BC-1002 · Parámetro no válido 400

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.