火车票抢票API 根据乘客的车次与座席要求快速订票出票:https://www.juhe.cn/docs/api/id/257
1.站站查询
接口地址:http://v.juhe.cn/grabTicket/action/search.php
支持格式:json
请求方式:get post
请求示例:http://v.juhe.cn/grabTicket/action/search.php?from=苏州&to=昆山&date=20161130&type=1&key=你申请的key
接口备注:根据发车站、到达站、发车日期等条件查询所有符合条件的车次信息、票价、剩余票量等信息
调用样例及调试工具:
API测试工具
请求参数说明: 名称 类型 必填 说明
key | string | 是 | 您申请的key | |
from | string | 是 | 出发地(中文或拼音) | |
to | string | 是 | 目的地(中文或拼音) | |
date | string | 是 | 发车日期,如:20161130 | |
type | int | 否 | 票种类型 ,为空则默认为1 , 1:正常票 2:学生票(暂不支持下单) |
返回参数说明: 名称 类型 说明
返回字段及相关数据字典见json示例 |
JSON返回示例:
{
"reason": "0",
"result": {
"queryKey": "6d31300d58be4d239af4039c71ddc313", //下单接口使用queryKey(重要)
"fromStation": "上海西",
"fromStationCode": "shanghaixi",
"toStation": "苏州园区",
"toStationCode": "suzhouyuanqu",
"trainDate": "20150514",
"pageIndex": 0,
"pageSize": 0,
"totalCount": 1,
"totalSize": 0,
"trains": [
{
"serialNumber": 1,
"trainNo": "G7066",
"fromTime": "09:02", //从该站发车时间
"toTime": "09:00", //到达该站时间(如果是首发站则没有到达时间)
"fromStation": "上海西",
"fromStationCode": "shanghaixi",
"toStation": "苏州园区",
"toStationCode": "suzhouyuanqu",
"runTimeSpan": "28", //历时(分钟)
"fromPassType": 1, //发站类别(始、过) 0:始发 1:路过
"toPassType": 1, //到站类别(过、终) 2:终点 1:路过
"bookState": 1, //可预订级别(0:不可预订 1:可预订 2:全部不可预订 3:发车前半小时车次不可预订)
"trainClass": "GD"
"tickets": {
"secondseat": {
"seatName": "二等座",
"price": 29.5,
"seatState": 1, // 0:不可预定 1:可预定
"seats": "490" //余票数量
"upPrice":1029.5,//商铺价格,若无则为0
"midPrice":0,//中铺价格,若无则为0
"downPrice":1075.5//下铺价格,若无则为0
},
"firstseat": {
"seatName": "一等座",
"price": 49.5,
"seatState": 1,
"seats": "28",
"upPrice":1029.5,
"midPrice":0,
"downPrice":1075.5
},
"businessseat": {
"seatName": "商务座",
"price": 99.5,
"seatState": 1,
"seats": "10",
"upPrice":1029.5,
"midPrice":0,
"downPrice":1075.5
},
"softsleeperdown":{
"seatName":"软卧",
"price":1075.5,
"seatState":0,
"seats":"0",
"upPrice":1029.5,
"midPrice":0,
"downPrice":1075.5
}
},
"miles": 0,
"pullInByIdCard": 1,
"note": ""
}
],
"froms": [
{
"station": "上海西",
"location": ""
}
],
"tos": [
{
"station": "苏州园区",
"location": ""
}
]
},
"error_code": 0
}
2.创建抢票单
接口地址: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、选择备选车次、备选坐席、购买保险等均可提高抢票成功率
调用样例及调试工具:
API测试工具
请求参数说明: 名称 类型 必填 说明
key | string | 是 | 你申请的key | |
queryKey | string | 是 | QueryKey(注意:这里的querykey一定要与你站站查询的querykey对应) | |
outOrderNo | string | 是 | 外部订单号(6-32位数字英文字母组合) | |
ticketModel | int | 否 | 0:代购模式;1:自购模式(用户使用自己的12306账号进行购买,可以在自己的12306账号下查询所购买车票) | |
a |