Documentación de la API

Referencia técnica de cada endpoint: parámetros, ejemplos de petición y respuesta reales. Para conseguir una key, visita /developers.

Autenticación en una línea

Toda la API va detrás de una API key, salvo la propia alta. Envíala siempre en la cabecera X-API-Key.

curl "https://api.bonovia.app/v1/stations?q=madrid" \
  -H "X-API-Key: tu_key_aqui"

Autenticación

Cómo conseguir y revocar tu propia API key. Todo lo demás en esta API va detrás de X-API-Key.

Crear una API key

Alta self-service, sin autenticación previa — así es como consigues tu primera key.

Revocar tu API key

Auto-revocación: la key que envías en X-API-Key es tanto la autenticación como la que se revoca.

Los datos de transporte en sí: buscar estaciones, ver qué se puede alcanzar desde una, y consultar horarios.

Buscar estaciones

Búsqueda de estaciones y agrupaciones de ciudad por nombre, sin distinguir acentos ni mayúsculas.

Explorar destinos alcanzables

Todos los destinos alcanzables desde una estación de origen, en trayecto directo, con duración y operador. Paginado.

Próximas salidas

Salidas ordenadas por hora desde una estación, para un día concreto.

Lo que puedes consultar sobre tu propia API key.

Estadísticas de uso

El uso de tu propia key — nunca el de otras. La autenticación de esta llamada ya identifica de quién son los datos.

Salud y frescura de los datos que sirve la API.

Estado del sistema

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