火车时刻与余票查询

接口能力

本接口提供全国火车时刻表及余票状态的查询服务。用户输入出发站、到达站和指定日期，即可获取符合条件的列车车次列表、出发与到达时间、历时，以及不同席位（如二等座、一等座等）的价格和余票快照信息。

请求与返回

• 请求参数：需提供出发站（start）、到达站（end）、乘车日期（date，格式 YYYY-MM-DD），并可通过 ishigh 参数筛选是否仅查询高铁/动车。
• 返回结果：返回包含列车信息的列表。每条记录包括车次号（trainno）、出发时间（departuretime）、到达时间（arrivaltime），以及各席位的价格（price）和余票数量/状态（num）。

使用场景

• 出行规划应用：集成至旅游、日历或行程管理工具中，为用户提供便捷的车次查询服务。
• 票务信息展示：用于企业差旅系统或本地生活服务平台，展示列车时刻与大致余票情况。
• 数据分析辅助：为交通流量分析、热门路线研究提供基础的时刻表数据支持。

使用说明与限制

• 接口返回的余票和价格信息为查询时点的参考快照，由于票务数据实时变动剧烈，不保证与实际购票时的绝对一致。
• 本接口仅提供信息查询，不具备购票、改签或退票功能。
• 实际的列车停运、晚点、票价调整及最终购票结果，请务必以 12306 官方网站及车站实时公告为准。