Lo que devuelve
Estado en vivo de trenes italianos desde ViaggiaTreno, la fuente oficial de Trenitalia/RFI en tiempo real: Frecciarossa, Frecciargento, Intercity y Regionale. Proporciona un número de tren y obtén dónde está, cuánto retraso tiene, y cada parada con horarios programados y reales de llegada y salida, retraso y la plataforma programada y real. O proporciona una estación y obtén su tablero de salidas o llegadas en vivo, el mismo que se muestra en las pantallas de la estación.
Filas de trenes: | campo | significado | |---|---| | tren, númeroDeTren, categoría | p. ej. FR 9600, FR (Frecciarossa), IC, REG | | origen, destino (+ ids) | Estaciones terminales | | salidaProgramada, llegadaProgramada | Horarios del horario, hora italiana con desplazamiento | | estado, retrasoMin | llegado, en marcha, no salido, cancelado; retraso actual en minutos | | últimaEstaciónVista, últimaVistaEn | Dónde se detectó al tren por última vez | | aviso | Aviso de servicio del operador, si aplica | | paradas | Cada parada: llegada y salida programadas y reales, retrasos, plataforma programada y real, cancelada |
Filas de tablero: estación, tren, categoría, destino (salidas) u origen (llegadas), hora programada, retrasoMin, plataformaProgramada, plataformaReal, estado.
Usos comunes
- Aplicaciones de viaje y planificadores de viaje que muestran retrasos en vivo y cambios de plataforma para el ferrocarril italiano
- Herramientas de compensación por retraso y reclamación de reembolsos (real versus programado en cada parada)
- Pantallas de estación, chatbots y alertas para usuarios de transporte
Solicitud
POST https://api.pushbuild.com/italy-train-status/run con un cuerpo JSON. Envía tu clave en el encabezado X-API-Key.
| Campo | Tipo | Descripción |
|---|---|---|
trainNumbers | lista de cadenas | Números de trenes como en el billete, p. ej. 9600 (Frecciarossa), 553 (Intercity), 2001 (Regionale). Hasta 50. |
stations | lista de cadenas | Nombres de estaciones para un tablero en vivo, p. ej. Roma Termini, Milano Centrale, Firenze Santa Maria Novella. Hasta 20. |
boards | lista de cadenas | salidas, llegadas o ambas (por defecto salidas). |
date | string | Fecha de salida del tren desde su origen el YYYY-MM-DD (por defecto hoy en Italia). El feed cubre hoy y días recientes. |
time | string | Hora italiana HH:MM desde la que comienza el tablero de la estación (por defecto ahora). |
maxItems | entero | Número máximo de elementos a devolver (1-500). Predeterminado: 100. |
Ejemplo
curl -X POST https://api.pushbuild.com/italy-train-status/run \
-H "X-API-Key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"trainNumbers": ["9600"], "boards": ["departures"], "maxItems": 20}'Respuesta
{"count": 20, "truncated": false, "seconds": 1.4, "items": [ { ... } ]}Cada llamada devuelve hasta 500 elementos. Los registros que no pasan la validación o no se encuentran se marcan en los elementos y no se cobran.
Precios
Pague solo por los resultados devueltos: $0,16 por 1.000 filas. Sin cargo por errores o búsquedas vacías.
Úselo desde Claude, ChatGPT o Cursor
Esta API también es un servidor MCP: https://api.pushbuild.com/mcp/italy-train-status. Agrégala a cualquier asistente que soporte servidores MCP remotos, con tu clave en el encabezado X-API-Key. Mismos precios. Configuración para cada aplicación.
Díganos qué necesitan construir.
Preguntas sobre esta API, volúmenes más altos, o una fuente de datos que necesiten que aún no cubrimos.
hello@pushbuild.com