• 257
  • 64
  • 53

火车票抢票

聚合数据 企业专用

根据乘客的车次与座席要求快速订票出票,业务特殊需要请联系在线客服

  • API文档
  • 错误码参照
  • 示例代码
  • 联系我们
立即调用
接口地址:http://v.juhe.cn/grabTicket/action/submitOrder.php
返回格式:json
请求方式:post
请求示例:http://v.juhe.cn/grabTicket/action/submitOrder.php
接口备注:建议先配置回调地址。须知: 1、抢票单仅支持占座和出票合并通知; 2、距离发车时间太近无法抢票,建议距离发车前3小时以上的车次才可创建抢票单;3、在抢票有效时间内会持续抢票,抢票成功后直接出票并推送回调; 4、正在抢票中的订单可以取消,取消后不可再次开启;5、抢票有效时间内未抢到票会主动推送抢票单过期;6、选择备选车次、备选坐席、购买保险等均可提高抢票成功率

请求参数说明:

名称 必填 类型 说明
  key string 在个人中心->我的数据,接口名称上方查看
  queryKey string QueryKey(注意:这里的querykey一定要与你站站查询的querykey对应
  outOrderNo string 外部订单号(6-32位数字英文字母组合)
  ticketModel int 0:代购模式;1:自购模式(用户使用自己的12306账号进行购买,可以在自己的12306账号下查询所购买车票)
  accountNo string 12306帐号
  accountPwd string 12306密码
  trainNo string 车次号 ,如:G7211,如果有多车次请用英文中竖线隔开
  seatClassCode string 座席代号,如:firstseat,若有多坐席,请用英文中竖线隔开
  mainTrainNo string 主车次,如:G7211,多车次或多坐席时必须指定
  mainSeatClass string 主坐席,如:secondseat,多车次或多坐席时必须指定
  fromStation string 出发车站名称,中文(请一定要与你站站查询的结果里面的对应车次的fromStation对应)
  toStation string 到达车站名称,中文(请一定要与你站站查询的结果里面的对应车次的toStation对应)
  departDate string 发车日期(如果下单成功就可能出票,如果是测试,请至少预定20天以后的票,如果出票成功,请及时退票,具体扣除费用规则请查看12306官网)(如:2016-12-01) 如果选择单车次或者多车次多坐席的时候要传主车次的具体发车时间,(如:2016-12-01 12:00),参数值必须与querykey里的值保持一致
  closeTime string 抢票截止时间(格式如:2016-12-01 18:00:00
  acceptNoSeat string 是否接受无座,0:不接受 1:接受
  person string 联系人姓名
  cellphone string 联系人手机
  email string 联系人邮箱
  passengers json数组 乘客信息(每个订单最多五位乘客),格式如:[{"passengerName": "乘客姓名", "passengerType": "乘客类型 1:成人 2:儿童 3:学生票 4:残军票(暂不支持学生票和残军票)","idCardType": "证件类型 0:身份证 1:护照 2:台胞证 3:港澳通行证", "idCardNo": "证件号码","birthday": "生日" },{"passengerName": "XXX","passengerType": "1","idCardType": "0","idCardNo": "XXXXXXXXXXXXXXXXXXXXXXXXX","birthday": "1989-02-18"}]
 

返回参数说明:

名称 类型 说明
  见json示例

JSON返回示例:

{
  "reason": "success",
  "result": {
    "orderNo": "TFT583U752U210D284004800356",//内部订单号
    "outOrderNo": "2016113001"//订单号(用户自定义)
  },
  "error_code": 0
}

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

  错误码 说明

系统级错误码参照:

  错误码 说明 旧版本(resultcode)

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

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

完整教学代码示例:

  语言 标题 提供者 时间

常见问题:

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

联系我们

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

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

免费注册