GET/v1/healthRequiere X-API-Key

Estado del sistema

Frescura del paquete de datos GTFS activo y estado de las comprobaciones internas.

Ejemplo

Request

curl "https://api.bonovia.app/v1/health" \
  -H "X-API-Key: tu_key_aqui"

Response

{
  "ok": true,
  "package_date": "2026-09-23",
  "package_age_days": 1,
  "checks": {
    "API Exploración": { "ok": true, "ms": 12 },
    "API Estaciones": { "ok": true, "ms": 8 },
    "API Estado": { "ok": true, "ms": 5 }
  },
  "ms": 25
}

Devuelve 503 (no 200) si el paquete de datos tiene más de 10 días — trátalo como una señal de que algo está desactualizado, no como un error tuyo.

Errores posibles de este endpoint

401

Falta la cabecera X-API-Key, o la key no es válida, ha sido revocada, o ha expirado.

{ "error": "Missing or invalid X-API-Key" }

429

Superaste el límite de peticiones (60/min por key, o el respaldo por IP).

{ "error": "Too many requests" }

503

El paquete de datos GTFS activo tiene más de 10 días de antigüedad.

{ "ok": false, "package_date": "2026-09-10", "package_age_days": 14, "checks": { "...": "..." }, "ms": 30 }

500

Fallo interno inesperado al comprobar la base de datos.

{ "ok": false, "ms": 12 }

Formato general de errores →