jumdata

  博客园  :: 首页  :: 新随笔  :: 联系 :: 订阅 订阅  :: 管理

火车票余额票价查询-火车车次时刻查询-火车查询-火车车站查询API接口介绍

简介

本文介绍火车相关内容的查询,包括火车票余票、火车票价格、火车时刻、火车车次、火车车站等信息。和12306同步。
集成火车相关的API,可以实现将火车相关查询功能集成到自己的系统中。下面介绍火车相关的API。

API介绍

火车查询包括两个接口:

  1. 火车票查询:根据出发站和到达站,查询火车票信息。
  2. 过站停留信息查询: 根据车次,查询车辆过站停留信息。

详细说明请参阅此处

火车票查询

请求参数

名称 类型 必须 说明
start String 出发站,如:杭州东
end String 到达站,如:上海南
ishigh String 是否高铁,0:不是,1:是
date String 日期,格式yyyy-MM-dd。默认为当天

返回样例

{
  "code": 200,//返回码,详见返回码说明
  "msg": "成功",//返回码对应描述
  "charge": true,//计费标志
  "taskNo": "040056972246718444474454",//本次请求号
  "data": {
    "date": "2025-07-25",//日期
    "start": "杭州东",//出发站
    "end": "上海南",//查询到达站
    "list": [
      {
        "terminalstation_code": "IMH",//到达站code,可用于查询过站停留信息
        "is_start": "过",//是否始发[始/过]
        "costtime": "01时51分",//用时
        "terminalstation": "上海松江",//到达站
        "departstation_code": "XHH",//出发站code,可用于查询过站停留信息
        "is_end": "过",//是否终点[过/终]
        "trainno": "K528",//车次
        "type": "快速",//类型
        "departuretime": "01:55",//出发时间
        "sequenceno": 1,//顺序
        "departstation": "杭州南",//出发站
        "trainno_uuid": "650000K52805",//车次uuid
        "station": "广州白云",//始发站
        "arrivaltime": "03:46",//到达时间
        "endstation": "南京",//终点站
        "yz": {//硬座
          "price": "24.0",//票价(--:无席位)
          "num": "有" //余票(有:充足,无:无票,--:无席位)
        },
        "wz": {//无座
          "price": "24.0",
          "num": "有"
        },
        "rw": {//软卧
          "size": {
            "xp_price": 114.5,
            "sp_price": 108.5
          },
          "price": "108.0",
          "num": "1"
        },
        "ze": {//二等座
          "price": "--",
          "num": "--"
        },
        "swz": {//商务座
          "price": "--",
          "num": "--"
        },
        "yw": {//硬卧
          "size": {
            "xp_price": 78.5,
            "zp_price": 75.5,
            "sp_price": 70.5
          },
          "price": "70.0",
          "num": "8"
        },
        "zy": {//一等座
          "price": "--",
          "num": "--"
        }
      },...
    ]
  }
}

过站停留信息查询

请求参数

名称 类型 必须 说明
trainnoUuid String 车次uuid,火车票查询接口返回
departstationCode String 出发站Code,火车票查询接口返回
terminalstationCode String 到达站Code,火车票查询接口返回
date String 乘车日期,格式yyyy-MM-dd

返回样例

{
  "code": 200,//返回码,详见返回码说明
  "msg": "成功",//返回码对应描述
  "charge": true,//计费标志
  "taskNo": "040056972246718444474454",//本次请求号
  "data": {
    "train_class_name": "快速",//火车类型
    "start_station_name": "昆明",//始发站名称
    "service_type": "有空调",//服务内容
    "station_train_code": "K80",//车次代码
    "end_station_name": "上海松江",//终点站名称
    "list": [
      {
        "station_name": "昆明",//到站站点名称
        "isChina": "1",//是否国内站
        "start_time": "18:45",//出发时间
        "isEnabled": false,//是否启用(到达站范围内)
        "station_no": "01",//站序
        "stopover_time": "----",//站内停留时间
        "arrive_time": "----" //到站时间
      },
      ...
    ]
  }
}

posted on 2026-04-13 12:31  Jumdata  阅读(1)  评论(0)    收藏  举报