API de Datos Ferroviarios y Telemetría LibTrain
Pasarela REST JSON unificada que agrega en tiempo real la telemetría de ADIF, Renfe GTFS-RT, FGC, Euskotren, Metro y Metro Ligero en toda España con caché inteligente.
2. Inicio rápido
Consulta la flota ferroviaria en circulación en toda España con una sola petición HTTP GET:
curl -s https://www.libtrain.com/api/v1/radar/vehicles | jq '.vehicles[:3]'
3. Cuándo usar esta API
- Paneles de salidas/llegadas en directo en webs, pantallas de estación o apps móviles.
- Analítica de retrasos, monitorización de puntualidad por corredor y avisos a viajeros.
- Agentes de IA y copilotos ferroviarios que requieran telemetría verificada RFIG/ADIF.
4. Endpoints y Explorador en Vivo
Pulsa cualquier endpoint superior para inspeccionar la respuesta JSON en vivo...
5. Autenticación y registro de agentes
Los endpoints públicos de lectura operan sin token bajo límites estándar. Los partners y agentes IA autenticados envían su cabecera Bearer Sanctum:
Authorization: Bearer lt_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxx
6. Tiempo real con Servidor LibTrain
TrainIngestionService fusiona Renfe GTFS-RT (LD y Cercanías), FGC OpenData, Euskotren y telemetría verificada de cabina LibTrain cada 15–20 segundos con deduplicación automática.
7. Errores
| HTTP | Code | Significado |
|---|---|---|
401 | UNAUTHENTICATED | Token Bearer ausente o inválido. |
404 | NOT_FOUND | Código de estación o tren no encontrado. |
429 | RATE_LIMITED | Límite de peticiones excedido; respeta Retry-After. |
503 | UPSTREAM_DEGRADED | Fuente externa temporalmente degradada. |
8. Límites de uso y caché
Los endpoints públicos permiten hasta 120 req/min por IP con caché compartida en servidor (15s vehículos en vivo, 600s avisos/RSS) evitando saturar los portales oficiales.
9. Archivos de uso para agentes
Los agentes de IA pueden consumir los manifiestos estructurados de descubrimiento:
GET /api/v1/radar/vehicles # Normalized telemetry schema GET /api/v1/radar/stats # Windowed fleet KPIs (live, 1d, 7d, 30d, all_time) GET /api/v1/radar/algorithms # Delay propagation & eco-cruising indices
10. Insertar tablón en una estación
Inserta el teleindicador de cualquier estación ADIF en tu web o pantalla mediante parámetro directo:
<iframe src="https://www.libtrain.com/radar-en-vivo?tab=board" width="100%" height="620" style="border:0;border-radius:14px;"></iframe>
11. Datos, atribución y límites
Cartografía © OpenStreetMap & OpenRailwayMap. Datos ferroviarios procedentes de fuentes públicas oficiales: ADIF, Renfe Datos Abiertos, FGC Dades Obertes y Open Data Euskadi.
12. Planes, Precios y condiciones de uso
Consulta los planes Gratuito, Pro, Maquinista Cabina y Enterprise con acuerdos SLA y cuotas comerciales.
Ver Planes y Precios →13. Tokens y modelos de IA usados adaptados a cada plan
| Plan | Modelo IA | Cuota Mensual |
|---|---|---|
| Free / Explorador | Gemini Flash-Lite | 50.000 tokens |
| Pro / Pasajero | Gemini Flash | 500.000 tokens |
| Maquinista / Empresa | Gemini Pro + RFIG Grounding | 2.500.000+ tokens |
14. Versiones, desaprobación, Soporte y Ayuda
La API v1 es estable. Cualquier desaprobación de campos se notifica con 90 días de antelación mediante cabeceras HTTP Deprecation y notas de versión.
15. Apps Multiplataforma: Android, iOS, Windows, Linux, macOS
Disponible ahora en Android y Web. Las compilaciones de escritorio (Windows, Linux, macOS) e iOS están en despliegue progresivo.