火车订票查询

支持MCP

通过站到站查询火车班次时刻表等信息,同时已集成至聚合MCP Server。火车票订票MCP不仅能赋予你的Agent火车时刻查询,还能支持在线订票能力。

  • 接口文档

    接口文档
  • 列车站到站时刻表

  • 错误码
  • 错误码列表
  • 资源下载
  • 接口文档下载
列车站到站时刻表
接口地址:https://apis.juhe.cn/fapigw/train/query
请求方式:http get/post
返回类型:json
接口描述:通过站到站查询火车时刻表,支持通过站点名称或站点编码查询。
接口调试: API测试工具

请求Header:

名称
  Content-Type application/x-www-form-urlencoded

请求参数说明:

名称 必填 类型 说明
  key string 接口请求key,在个人中心->数据中心->我的API进行查看
  search_type string 查询方式。
1-通过站点名称,2-通过站点编码
  departure_station string 出发站。如:北京、VNP
  arrival_station string 到达站。如:北京、OHH
  date string 出发日期。如:2025-06-18。
仅允许15天内的日期
  filter string 车次筛选条件,默认所有。如:G。
从以下标志中选取多个条件组合[G(高铁/城际),D(动车),Z(直达特快),T(特快),K(快速),O(其他),F(复兴号),S(智能动车组)]
  enable_booking string 是否可预定班次,默认:1。
1-仅返回可预定的班次,2-所有
  departure_time_range string 出发时间选择,如:上午。
凌晨-[0:00-06:00),上午-[6:00-12:00),下午-[12:00-18:00),晚上-[18:00-24:00)

请求代码示例:

  • curl
  • PHP
  • Python
  • Go
  • C#
  • Node
  • Java
  • ObjectC
curl -k -i "https://apis.juhe.cn/fapigw/train/query?key=key&search_type=xxx&departure_station=xxx&arrival_station=xxx&date=xxx&filter=&enable_booking=&departure_time_range="

返回参数说明:

名称 类型 说明
  error_code int 返回码
  reason string 返回结果描述
  result array 返回结果集
  train_no string 车次号,如:G25
  departure_station string 出发站,如:北京南
  arrival_station string 到达站,如:苏州北
  departure_station_code string 出发站点编码,如:VNP
  arrival_station_code string 到达站点编码,如:OHH
  departure_time string 出发时间,如:18:04
  arrival_time string 到达时间,如:22:32
  duration string 历时,如:04:28
  enable_booking string 班次在12306上是否可预定。如:Y
  prices array 票价信息

其他使用说明:

火车车站站点清单下载:all_train_stations.json
本服务已经接入聚合MCP中心,您可以访问:https://juhe.cn/mcp 了解。
聚合火车票订票MCP Server,不仅能赋予你的Agent火车时刻查询,还能支持在线订票能力。

JSON返回示例:JSON在线格式化工具 >

      {
    "reason": "success.",
    "result": [
        {
            "train_no": "G25",
            "departure_station": "北京南",
            "arrival_station": "苏州北",
            "departure_station_code": "VNP",
            "arrival_station_code": "OHH",
            "departure_time": "18:04",
            "arrival_time": "22:32",
            "duration": "04:28",
            "enable_booking": "Y",
            "prices": [
                {
                    "seat_name": "商务座",
                    "seat_type_code": "9",
                    "price": 2194,
                    "discount": null,
                    "num": "无"
                },
                {
                    "seat_name": "一等座",
                    "seat_type_code": "M",
                    "price": 1003,
                    "discount": null,
                    "num": "无"
                },
                {
                    "seat_name": "二等座",
                    "seat_type_code": "O",
                    "price": 627,
                    "discount": null,
                    "num": "1"
                },
                {
                    "seat_name": "优选一等座",
                    "seat_type_code": "D",
                    "price": 1379,
                    "discount": null,
                    "num": "无"
                }
            ],
            "train_flags": [
                "智能动车组",
                "复兴号",
                "静音车厢"
            ]
        }
    ],
    "error_code": 0
}

服务级错误码参照(error_code):

  错误码 说明

系统级错误码参照:

  错误码 说明 旧版本(resultcode)
  10001 错误的请求KEY 101
  10002 该KEY无请求权限 102
  10003 KEY过期 103
  10004 错误的OPENID 104
  10005 应用未审核超时,请提交认证 105
  10007 未知的请求源 107
  10008 被禁止的IP 108
  10009 被禁止的KEY 109
  10011 当前IP请求超过限制 111
  10012 请求超过次数限制 112
  10013 测试KEY超过请求限制 113
  10014 系统内部异常(调用充值类业务时,请务必联系客服或通过订单查询接口检测订单,避免造成损失) 114
  10020 接口维护 120
  10021 接口停用 121

错误码格式说明(示例:200201):

  2 002 01
  服务级错误(1为系统级错误) 服务模块代码(即数据ID) 具体错误代码
火车订票查询
2154
申请次数
817
ID
0
收藏次数

推荐API

API资讯

数 据 驱 动 未 来
Data Drives The Future
0512-88869195
数 据 驱 动 未 来
Data Drives The Future