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

BC-3002Ruta no encontrada

Esa URL no existe en la versión 1 de la API. Casi siempre es una errata o un endpoint que imaginaste: la lista completa de rutas está en la referencia y en el documento OpenAPI.

Código

BC-3002

Estado HTTP

404 Not Found

Reintentable

No

type

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

Qué respuesta recibes

HTTP/1.1 404 Not Found
Content-Type: application/problem+json

{
  "type": "https://boletinclaro.es/v1/errores/BC-3002",
  "codigo": "BC-3002",
  "title": "Ruta no encontrada",
  "status": 404,
  "detail": "La ruta «/v1/subvenciones» no existe en esta API."
}

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

• Errata en el nombre, o singular donde va plural: es «/v1/empresas», no «/v1/empresa».
• Un endpoint que no existe. Los que hay son seis y están todos en la referencia.
• Falta el prefijo de versión: todas las rutas cuelgan de «/v1».
• Un identificador pegado a una ruta que no lo acepta. Solo «/v1/empresas/{nif}» lleva uno.

Cómo se arregla

1. Compara la URL con la lista de rutas de la referencia.
2. Genera el cliente desde el documento OpenAPI: las rutas dejan de escribirse a mano.

¿Merece la pena reintentar?

No. Corrige la URL.

No lo confundas con

• BC-3001 · No encontrado 404

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.