India Rail Intelligence API

Enterprise-grade REST API for real-time Indian Railways train tracking, master schedules, live station arrivals/departures, 10-minute delay time-series, and 30-day punctuality analytics with sub-second response times.

原始信息汇总

India Rail Intelligence API 数据集详情总结

一、数据集概述

India Rail Intelligence API 是一个企业级REST API，专注于印度铁路实时列车追踪、时刻表查询和准点率分析。该API覆盖2,110+列火车和45,000+个车站，提供亚秒级响应速度的结构化JSON数据。

二、关键功能特性

功能类别	具体描述
实时列车状态	通过GPS与运输网关追踪，提供精确延误分钟数、当前车站、速度、站台号和下一停靠站
数据库快速路径	索引云数据库支持低于15毫秒的时刻表和历史行程查询
10分钟快照延误时间序列	按车站逐一显示延误累积的时间序列数据
30天准点率分析	统计准点百分比、平均延误分钟和可靠性评级（高/中/低）
主列车时刻表	完整计划到达/出发时间、停留时长、距离偏移和天数计数
实时车站运行板	展示1至12小时窗口内所有到达和出发列车

三、常见应用场景

• 移动与网页旅行应用：旅客实时列车追踪与行程状态更新
• 票务与预订辅助平台：预订流程中展示实时准点历史和主时刻表
• AI聊天机器人与虚拟助手：即时回答“我的火车在哪里”和延误问题
• 乘客警报与通知系统：自动发送WhatsApp、短信或推送通知
• 运输分析与物流仪表板：深度历史准点率和可靠性情报
• 车站显示屏与自助系统：公共交通枢纽的公共到达/出发实时看板

四、API端点目录

方法	端点	功能描述	认证要求
POST	/api/v1/auth/token	生成访问令牌	❌ 无需
GET	/api/v1/auth/verify	验证令牌范围与配额使用	✅ Bearer Token
GET	/api/v1/trains/{trainNo}/live	实时GPS列车状态	✅ Bearer Token
GET	/api/v1/trains/{trainNo}	历史数据库时刻表与延误	✅ Bearer Token
GET	/api/v1/trains/{trainNo}/timeline	10分钟历史进展时间序列	✅ Bearer Token
GET	/api/v1/trains/{trainNo}/stats	30天准点率与平均延误分析	✅ Bearer Token
GET	/api/v1/trains/{trainNo}/schedule	静态主列车时刻表与路线	✅ Bearer Token
GET	/api/v1/stations/{stationCode}/trains	实时车站运行板	✅ Bearer Token
GET	/api/v1/health	公共健康检查探针	❌ 无需

五、认证流程

该API采用两步认证工作流：

1. 生成访问令牌（无需认证）：发送POST /api/v1/auth/token请求，传入应用名称，返回JWT令牌
2. 携带令牌访问数据：在API请求的Authorization头中使用Bearer <TOKEN>进行认证

六、示例参数

热门列车编号：

• 12301 — 豪拉拉吉达尼快车（HWH↔NDLS）
• 22861 — Kantabanji Ispat快车
• 12951 — 孟买拉吉达尼快车
• 12002 — 新德里沙塔布迪快车
• 22691 — KSR班加罗尔拉吉达尼

热门车站代码：

• NDLS — 新德里
• HWH — 豪拉枢纽
• CSMT — 孟买
• MAS — 钦奈中央
• SDAH — 锡尔达
• PNBE — 巴特那枢纽

日期格式：支持YYYY-MM-DD和DD-MM-YYYY

七、基础设施与可靠性

• 计算层：全球Vercel Edge Serverless运行时，多区域故障转移（孟买bom1/新加坡sin1）
• 数据库层：分布式Turso LibSQL云引擎，含主键和复合B-Tree索引
• 弹性引擎：飞行中请求去重、连接池管理和低于10秒超时处理

八、定价方案

方案	月费
BASIC	$0.00
PRO	$10.00
ULTRA	$25.00

九、法律与支持信息

该API是独立开发者服务，与IRCTC、印度铁路、CRIS或任何政府组织无关联。用户需自行确保符合适用的服务条款和当地法规。

支持联系方式：

• 支持邮箱：[e-mail]
• 交互式Swagger UI文档：https://irctc-live-status-api.vercel.app/docs