聚合数据火车订票查询

解决的问题

很多前端或自动化流程需要查询两站之间未来车次的硬数据，但 12306 页面结构不稳定，直接抓取容易失败。这个技能把聚合数据的火车查询接口封装成稳定调用，适合根据出发站、到达站和日期拿到车次、时刻、运行时长、票价、余票等字段。

技能如何工作

• 调用 https://apis.juhe.cn/fapigw/train/query，支持 GET / POST 和 JSON 响应。
• 使用 search_type=1 按中文站名查询，或使用 search_type=2 按 3 位车站编码查询，编码可从随附车站对照表获取。
• 支持 filter 筛选 G、D、Z、T、K、F、S、O 等车次类型，departure_time_range 按凌晨、上午、下午、晚上筛选。
• 返回 train_no、departure_time、arrival_time、duration、prices、num、enable_booking 与 train_flags，便于做订票前展示或车次比较。

适用边界

• 仅查询当前日期起 15 天内 的车次，不支持历史日期。
• 需要聚合数据 API Key，并受套餐 QPS、日调用次数限制。
• 余票 num 可能是“有”、数字或“无”，不能等同于最终支付结果。
• 遇到 281701 时优先检查站名是否标准，或改用车站编码重试。