RailKit – Indian Railway Data

Live IRCTC data for PNR status, train routes, running status, station boards, seat availability, fares, train search, history, and cancellations.

原始信息汇总

数据集概述：RailKit – Indian Railway Data

RailKit 是一个提供印度铁路数据的 REST API，旨在帮助开发者构建行程规划器、列车追踪工具、铁路仪表盘、通知系统和后端集成等应用。该 API 通过 RapidAPI 平台分发，使用 JSON 格式响应，并采用 DD-MM-YYYY 日期格式（除非另有说明）以及大写印度铁路站点代码。

---

核心功能与端点

RailKit 提供 9 个端点，覆盖列车运行与票务的多个方面：

端点名称	功能描述	请求路径（GET）
Check PNR Status	查询 PNR 预订状态，包括乘客确认信息、行程、票价、车厢、铺位及当前确认情况。	/api/checkPNRStatus/{pnr}
Get Train Information	获取列车基本信息及逐站路线图。	/api/getTrainInfo/{trainNumber}
Track Live Train	追踪列车实时运行状态，包括当前位置、延误信息和预计时间。	/api/trackTrain/{trainNumber}/{date}
Get Train History	查询已完成列车行程的历史记录，包括到发时间、各站延误和站台信息。	/api/trainHistory/{trainNo}/{journeyDate}
Live Trains at Station	获取指定车站当前和即将到达/出发的列车信息。	/api/liveAtStation/{stnCode}
Search Trains Between Stations	查询两地之间的直达列车。	/api/searchTrainBetweenStations/{fromStnCode}/{toStnCode}
Check Seat Availability	查询特定列车、日期、席别和配额的座位/卧铺可用性。	/api/getAvailability/{trainNo}/{fromStnCode}/{toStnCode}/{date}/{coach}/{quota}
Get Train Fare	查询特定行程的票价明细，包括基础票价、预订费、GST 等。	/api/fareLookup/{trainNo}/{date}/{fromStation}/{toStation}/{class}/{quota}
Get Cancelled Trains	获取完全或部分取消的列车列表及摘要。	/api/cancelled

---

认证与接入信息

• 认证方式：使用 RapidAPI 认证，需在每个请求头中包含 X-RapidAPI-Key 和 X-RapidAPI-Host: railkit-indian-railway-data.p.rapidapi.com。
• 无需额外账户：通过 RapidAPI 订阅即可使用，无需单独的 RailKit 账户或 API 密钥。
• 主域名：https://railkit-indian-railway-data.p.rapidapi.com
• 请求示例（cURL）： bash curl --request GET --url https://railkit-indian-railway-data.p.rapidapi.com/api/getTrainInfo/12301 --header X-RapidAPI-Key: YOUR_RAPIDAPI_KEY --header X-RapidAPI-Host: railkit-indian-railway-data.p.rapidapi.com

---

数据格式与输入规范

• 响应格式：成功响应通常为 {"success": true, "data": {}}，部分端点可能包含 summary 字段。错误响应可能使用 error 或 message 字段。
• 日期格式：必须使用 DD-MM-YYYY（例如 11-08-2026），支持 today 关键字。
• 列车编号：必须为 5 位数字字符串。
• PNR 号码：必须为 10 位数字字符串。
• 站点代码：必须使用大写字母（如 NDLS 表示新德里）。
• 支持的席别（Train Classes）：1A, 2A, 3A, 3E, CC, EC, EA, FC, SL, 2S 等。
• 支持的配额（Booking Quotas）：GN（一般）、TQ（塔特卡尔）、LD（女士）、SS（老年人）、PT（高级塔特卡尔）、DF（国防）、FT（外国游客）等。

---

性能与可靠性

• 服务等级：100% 服务级别，平均延迟 940ms（根据页面提供数据）。
• 限流与配额：基于所选的 RapidAPI 订阅计划（BASIC: $0.00/mo, PRO: $2.00/mo, ULTRA: $5.00/mo），由 RapidAPI 处理配额和速率限制。
• 错误处理建议：建议对瞬时错误（HTTP 429, 502, 503, 504）进行重试，不应对永久性错误（400, 401, 403, 404）自动重试。

---

使用注意事项

• 数据独立性：RailKit 是一个独立开发者平台，不与印度铁路（Indian Railways）、IRCTC、CRIS 或印度政府有关联或认可。数据可能延迟、不完整或由上游来源更改，关键行程信息需通过官方渠道核实。
• 隐私提示：PNR 响应可能包含敏感的乘客及预订信息，不应公开暴露、在日志中记录完整 PNR 或超出必要期限留存数据。