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

BC-1002Parámetro no válido

Uno de los parámetros no vale, y el campo «detail» dice cuál: un «tipo» que no es subvenciones/licitaciones/ambos, un código de boletín que no existe, un CPV mal formado, un NIF que no lo parece o un «limite» fuera de 1 a 50.

Código: BC-1002
Estado HTTP: 400 Bad Request
Reintentable: No
type: https://boletinclaro.es/v1/errores/BC-1002

Qué respuesta recibes

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

{
  "type": "https://boletinclaro.es/v1/errores/BC-1002",
  "codigo": "BC-1002",
  "title": "Parámetro no válido",
  "status": 400,
  "detail": "El parámetro «tipo» debe ser «subvenciones», «licitaciones» o «ambos»."
}

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

«tipo» con un valor que no es «subvenciones», «licitaciones» ni «ambos».
«fuentes» con un código de boletín que no publicamos: la lista es cerrada y está en la referencia.
«cpv» con un código que no tiene entre 6 y 8 dígitos. El dígito de control se acepta; los guiones y los espacios, no.
«nif» con puntos, guiones o espacios.
«limite» a 0, negativo, o por encima de 50, que es el máximo de esta API.

Cómo se arregla

Lee el campo «detail»: nombra el parámetro exacto que ha fallado.
Compara el valor con el enum del documento OpenAPI. Son listas cerradas, y un cliente generado del spec ya las trae.
En las listas separadas por comas («fuentes», «cpv», «tipos») no pongas espacios alrededor de la coma.

¿Merece la pena reintentar?

No. Corrige el parámetro que nombra el «detail» y vuelve a llamar.

No lo confundas con

BC-1001 · Consulta no válida 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.