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

BC-5002Servicio no disponible temporalmente

Una pieza de la que dependemos no responde ahora mismo: el motor de búsqueda, BigQuery, la validación de claves o el resolutor de geografía.

Código

BC-5002

Estado HTTP

503 Service Unavailable

Reintentable

Sí

type

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

Qué respuesta recibes

HTTP/1.1 503 Service Unavailable
Content-Type: application/problem+json

{
  "type": "https://boletinclaro.es/v1/errores/BC-5002",
  "codigo": "BC-5002",
  "title": "Servicio no disponible temporalmente",
  "status": 503,
  "detail": "La búsqueda no está disponible en este momento."
}

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

• El motor de búsqueda o BigQuery no responden.
• No se pudo comprobar tu clave contra el almacén de claves. Ese caso falla cerrado a propósito: preferimos no admitir la petición a admitirla sin comprobarla.
• No pudimos resolver la «zona» que pediste. También deliberado: si no podemos filtrar por geografía preferimos fallar a devolverte resultados de toda España como si hubieras filtrado.

Cómo se arregla

1. Espera los segundos de «Retry-After» y reintenta; a partir de ahí, backoff exponencial.
2. Si el que falla es el resolutor de geografía, repetir la búsqueda sin «zona» funciona ya.

¿Merece la pena reintentar?

Sí. «Retry-After» trae una espera prudente; a partir de ahí, backoff exponencial.

No lo confundas con

• BC-5001 · Error interno 500

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.