• 173
  • 4150
  • 123

火车票订票

聚合数据 支持HTTPS 企业专用

服务费2元/笔,更多优惠请咨询客服(注意:非正式用户,测试期间有查询次数限制)

  • API文档
  • 错误码参照
  • 示例代码
  • 联系我们
立即调用
接口地址:http://op.juhe.cn/trainTickets/ticketsAvailable
返回格式:json/xml
请求方式:http get/post
请求示例:http://op.juhe.cn/trainTickets/ticketsAvailable?key=您申请到的appkey&train_date=2015-07-11&from_station=BJP&to_station=SHH
接口备注:查询余票信息,请配合买票接口使用,仅使用本接口可能会受限(不能大量的只查不买)

请求参数说明:

名称 必填 类型 说明
  dtype string 返回的格式,json或xml,默认json
  key string 您申请到的APPKEY
  train_date string 发车日期,如:2015-07-01(务必按照此格式)
  from_station string 出发站简码,如:BJP
  to_station string 到达站简码,如:SHH
 

返回参数说明:

名称 类型 说明
  error_code int 返回码
  reason string 返回说明
  result string 返回结果集

JSON返回示例:

/*如有问题,请先阅读 http://code.juhe.cn/docs/201 */

{
    "reason": "成功的返回",
    "result": {
        "list": [  /*有省略*/
            {
                 "sale_date_time": "1230", /*车票开售时间*/
                 "can_buy_now": "Y",   /*当前是否可以接受预定*/
                  "arrive_days": "0",  /*列车从出发站到达目的站的运行天数 0:当日到达1,: 次日
                    到达,2:三日到达,3:四日到达,依此类推*/
                 "train_start_date": "20150711", /*列车从始发站出发的日期*/
                 "train_code": "G101", /*车次*/
                 "access_byidcard": "1", /*是否可凭二代身份证直接进出站*/
                 "train_no": "240000G1010A", /*列车号*/   
                 "train_type": "G", /*列车类型*/
                 "from_station_code": "VNP", /*出发车站简码*/
                 "from_station_name": "北京南", /*出发车站名*/
                 "to_station_code": "AOH", /*到达车站简码*/
                 "to_station_name": "上海虹桥", /*到达车站名*/
                 "start_station_name": "北京南", /*始发站名*/
                 "end_station_name": "上海虹桥", /*终到站名*/
                 "start_time": "07:00", /*当前站出发时刻*/
                 "arrive_time": "12:37", /*到达时刻*/
                 "run_time": "05:37", /*历时(出发站到目的站)*/
                 "run_time_minute": "337", /*历时分钟合计*/
                "gjrw_num": "--", /*高级软卧余票数量*/
                 "gjrws_price":0, /* 高级软卧(上)票价*/
                "gjrw_price": 0, /*高级软卧票价*/
                "qtxb_num": "--", /*其他席别余票数量*/
                "qtxb_price": 0, /*其他席别对应的票价*/
                "rw_num": "--", /*软卧余票数量*/
                "rw_price": 0, /*软卧(上)票价*/
                "rwx_price":10, /*软卧(下)票价*/
                "rz_num": "--", /*软座的余票数量*/
                "rz_price": 0, /*软座的票价*/   
                "swz_num": "15", /*商务座余票数量*/    
                "swz_price": 1748, /*商务座票价*/
                "tdz_num": "--", /*特等座的余票数量*/
                "tdz_price": 0,  /*特等座票价*/
                "wz_num": "--", /*无座的余票数量*/       
                "wz_price": 0, /*无座票价*/
                "dw_num":"8",/*动卧的余票数量*/
                "dw_price":"",/*动卧(上)票价[12306新增]*/
                "dwx_price":"",/*动卧(下)票价[12306新增]*/
               "yw_num": "--", /*硬卧的余票数量*/
               "yw_price": 0, /*硬卧(上)票价(因为硬卧上中下铺价格不同,这个价格一般是均价),
            请务必阅读 http://code.juhe.cn/docs/201 中第15条*/     
              " ywz_price":90,/*硬卧(中)票价*/        
               "ywx_price":86.5,/*硬卧(下)票价*/        
                "yz_num": "--", /*硬座的余票数量*/
                "yz_price": 0, /*硬座票价*/   
                "edz_num": "900", /*二等座的余票数量*/
                "edz_price": 553, /*二等座票价*/ 
                "ydz_num": "54", /*一等座余票数量*/
                "ydz_price": 933, /*一等座票价*/
                "distance":0, /*里程数*/
            },
            {
                "end_station_name": "上海虹桥",
                "swz_price": 1748,
                "swz_num": "15",
                "to_station_name": "上海虹桥",
                "ydz_num": "53",
                "yz_num": "--",
                "rw_num": "--",
                "arrive_days": "0",
                "rz_num": "--",
                "access_byidcard": "1",
                "yz_price": 0,
                "sale_date_time": "1230",
                "from_station_code": "VNP",
                "rz_price": 0,
                "gjrw_num": "--",
                "to_station_code": "AOH",
                "ydz_price": 933,
                "wz_price": 0,
                "tdz_price": 0,
                "run_time": "05:45",
                "yw_num": "--",
                "distance": 0,
                "edz_price": 553,
                "qtxb_price": 0,
                "can_buy_now": "Y",
                "rw_price": 0,
                "train_type": "G",
                "yw_price": 0,
                "note": "",
                "train_no": "240000G1050D",
                "train_code": "G105",
                "from_station_name": "北京南",
                "run_time_minute": "345",
                "arrive_time": "13:21",
                "start_station_name": "北京南",
                "start_time": "07:36",
                "edz_num": "878",
                "wz_num": "--",
                "qtxb_num": "--",
                "train_start_date": "20150711",
                "gjrw_price": 0,
                "tdz_num": "--"
            },
        ]
    },
    "error_code": 0
}

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

  错误码 说明

系统级错误码参照:

  错误码 说明 旧版本(resultcode)

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

  2 002 01
  服务级错误(1为系统级错误) 服务模块代码(即数据ID) 具体错误代码

完整教学代码示例:

  语言 标题 提供者 时间

常见问题:

  内容 详细
  常见问题: http://www.juhe.cn/qa/index/1548226362

联系我们

  内容 详细
  接口测试: API测试工具
  技术支持: info@juhe.cn
  联系电话: 400-882-7715
  在线客服QQ: 800076065

现在注册,百款接口免费测试

免费注册