• 173
  • 4026
  • 118

火车票订票

聚合数据 支持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):

  错误码 说明
  217300 网络错误或内部错误
  217301 参数错误
  217302 订单处理错误或查询错误
  217303 无此订单号
  217304 只有占座成功的订单才可以支付
  217305 不存在这个站点
  217306 您输入的乘车日期有误,不在可预订日期范围内
  217307 您提交的无效订单较多,请两个小时后再试

系统级错误码参照:

  错误码 说明 旧版本(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) 具体错误代码

完整教学代码示例:

  语言 标题 提供者 时间

常见问题:

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

联系我们

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

猜你喜欢

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

免费注册