⚡ LIBTRAIN DEVELOPERS & AI AGENTS

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

HTTPCodeSignificado
401UNAUTHENTICATEDToken Bearer ausente o inválido.
404NOT_FOUNDCódigo de estación o tren no encontrado.
429RATE_LIMITEDLímite de peticiones excedido; respeta Retry-After.
503UPSTREAM_DEGRADEDFuente 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

PlanModelo IACuota Mensual
Free / ExploradorGemini Flash-Lite50.000 tokens
Pro / PasajeroGemini Flash500.000 tokens
Maquinista / EmpresaGemini Pro + RFIG Grounding2.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.

✓ Android (Disponible) ✓ Web / PWA (Disponible) ⏳ iOS · Windows · Linux · macOS
LibTrain

Acceso al Portal LibTrain

Entorno seguro con autenticación de dos factores (2FA) para maquinistas, operadoras y viajeros.

Arquitectura Multi-Rol y Acceso Unificado Al autenticarte, el backend detectará automáticamente tu perfil (Maquinista, Operador, Auditor, Pasajero o Administrador) y te dirigirá a tu panel correspondiente.
Acceder al Portal Registrarse
¿Deseas explorar la plataforma sin iniciar sesión? Acceso Demo

Verificación Telefónica 2FA (SMS)

Introduce tu número móvil para recibir un código de seguridad de 6 dígitos vía SMS.

🇪🇸 +34
Incluye el prefijo internacional (ej: +34 para España).