火車票搶票API 根據(jù)乘客的車次與座席要求快速訂票出票：https://www.juhe.cn/docs/api/id/257
1.站站查詢
接口地址：http://v.juhe.cn/grabTicket/action/search.php
支持格式：json
請(qǐng)求方式：get post
請(qǐng)求示例：http://v.juhe.cn/grabTicket/action/search.php?from=蘇州&to=昆山&date=20161130&type=1&key=你申請(qǐng)的key
接口備注：根據(jù)發(fā)車站、到達(dá)站坊夫、發(fā)車日期等條件查詢所有符合條件的車次信息砖第、票價(jià)、剩余票量等信息
調(diào)用樣例及調(diào)試工具：API測(cè)試工具
請(qǐng)求參數(shù)說(shuō)明：
| 名稱 | 類型 | 必填 | 說(shuō)明 |
|---|---|---|---|
| key | string | 是 | 您申請(qǐng)的key |
| from | string | 是 | 出發(fā)地(中文或拼音) |
| to | string | 是 | 目的地(中文或拼音) |
| date | string | 是 | 發(fā)車日期,如:20161130 |
| type | int | 否 | 票種類型 环凿，為空則默認(rèn)為1 梧兼， 1：正常票 2：學(xué)生票(暫不支持下單) |
返回參數(shù)說(shuō)明：
| 名稱 | 類型 | 說(shuō)明 |
|---|---|---|
| 返回字段及相關(guān)數(shù)據(jù)字典見(jiàn)json示例 | - | - |
JSON返回示例：
(http://blog.csdn.net/ishxiao/article/details/54573147#) [copy](http://blog.csdn.net/ishxiao/article/details/54573147#)
[[圖片上傳中。智听。羽杰。（1）]](https://code.csdn.net/snippets/2130051)[[圖片上傳中。到推。考赛。（2）]](https://code.csdn.net/snippets/2130051/fork)
{
"reason": "0",
"result": {
"queryKey": "6d31300d58be4d239af4039c71ddc313", //下單接口使用queryKey(重要)
"fromStation": "上海西",
"fromStationCode": "shanghaixi",
"toStation": "蘇州園區(qū)",
"toStationCode": "suzhouyuanqu",
"trainDate": "20150514",
"pageIndex": 0,
"pageSize": 0,
"totalCount": 1,
"totalSize": 0,
"trains": [
{
"serialNumber": 1,
"trainNo": "G7066",
"fromTime": "09:02", //從該站發(fā)車時(shí)間
"toTime": "09:00", //到達(dá)該站時(shí)間（如果是首發(fā)站則沒(méi)有到達(dá)時(shí)間）
"fromStation": "上海西",
"fromStationCode": "shanghaixi",
"toStation": "蘇州園區(qū)",
"toStationCode": "suzhouyuanqu",
"runTimeSpan": "28", //歷時(shí)(分鐘)
"fromPassType": 1, //發(fā)站類別（始、過(guò)） 0：始發(fā) 1：路過(guò)
"toPassType": 1, //到站類別（過(guò)莉测、終） 2：終點(diǎn) 1：路過(guò)
"bookState": 1, //可預(yù)訂級(jí)別（0:不可預(yù)訂 1：可預(yù)訂 2:全部不可預(yù)訂 3:發(fā)車前半小時(shí)車次不可預(yù)訂）
"trainClass": "GD"
"tickets": {
"secondseat": {
"seatName": "二等座",
"price": 29.5,
"seatState": 1, // 0：不可預(yù)定 1：可預(yù)定
"seats": "490" //余票數(shù)量
"upPrice":1029.5,//商鋪價(jià)格,若無(wú)則為0
"midPrice":0,//中鋪價(jià)格,若無(wú)則為0
"downPrice":1075.5//下鋪價(jià)格,若無(wú)則為0
},
"firstseat": {
"seatName": "一等座",
"price": 49.5,
"seatState": 1,
"seats": "28",
"upPrice":1029.5,
"midPrice":0,
"downPrice":1075.5
},
"businessseat": {
"seatName": "商務(wù)座",
"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": "蘇州園區(qū)",
"location": ""
}
]
},
"error_code": 0
}
2.創(chuàng)建搶票單
接口地址：http://v.juhe.cn/grabTicket/action/submitOrder.php
支持格式：json
請(qǐng)求方式：post
請(qǐng)求示例：http://v.juhe.cn/grabTicket/action/submitOrder.php
接口備注：建議先配置回調(diào)地址颜骤。須知：
1、搶票單僅支持占座和出票合并通知捣卤；
2忍抽、距離發(fā)車時(shí)間太近無(wú)法搶票，建議距離發(fā)車前3小時(shí)以上的車次才可創(chuàng)建搶票單腌零；
3梯找、在搶票有效時(shí)間內(nèi)會(huì)持續(xù)搶票，搶票成功后直接出票并推送回調(diào)益涧；
4、正在搶票中的訂單可以取消驯鳖，取消后不可再次開(kāi)啟闲询；
5久免、搶票有效時(shí)間內(nèi)未搶到票會(huì)主動(dòng)推送搶票單過(guò)期；
6扭弧、選擇備選車次阎姥、備選坐席、購(gòu)買保險(xiǎn)等均可提高搶票成功率
調(diào)用樣例及調(diào)試工具：API測(cè)試工具
請(qǐng)求參數(shù)說(shuō)明：
| 名稱 | 類型 | 必填 | 說(shuō)明 |
|---|---|---|---|
| key | string | 是 | 你申請(qǐng)的key |
| queryKey | string | 是 | QueryKey（注意:這里的querykey一定要與你站站查詢的querykey對(duì)應(yīng)） |
| outOrderNo | string | 是 | 外部訂單號(hào)(6-32位數(shù)字英文字母組合) |
| ticketModel | int | 否 | 0:代購(gòu)模式;1:自購(gòu)模式(用戶使用自己的12306賬號(hào)進(jìn)行購(gòu)買,可以在自己的12306賬號(hào)下查詢所購(gòu)買車票) |
| accountNo | string | 否 | 12306帳號(hào) |
| accountPwd | string | 否 | 12306密碼 |
| trainNo | string | 是 | 車次號(hào) 鸽捻，如:G7211呼巴，如果有多車次請(qǐng)用英文中豎線隔開(kāi) |
| seatClassCode | string | 是 | 座席代號(hào)，如:firstseat御蒲，若有多坐席衣赶，請(qǐng)用英文中豎線隔開(kāi) |
| mainTrainNo | string | 是 | 主車次，如:G7211厚满，多車次或多坐席時(shí)必須指定 |
| mainSeatClass | string | 是 | 主坐席府瞄，如:secondseat，多車次或多坐席時(shí)必須指定 |
| fromStation | string | 是 | 出發(fā)車站名稱碘箍，中文(請(qǐng)一定要與你站站查詢的結(jié)果里面的對(duì)應(yīng)車次的fromStation對(duì)應(yīng)) |
| toStation | string | 是 | 到達(dá)車站名稱遵馆，中文(請(qǐng)一定要與你站站查詢的結(jié)果里面的對(duì)應(yīng)車次的toStation對(duì)應(yīng)) |
| departDate | string | 是 | 發(fā)車日期(如果下單成功就可能出票,如果是測(cè)試,請(qǐng)至少預(yù)定20天以后的票,如果出票成功,請(qǐng)及時(shí)退票,具體扣除費(fèi)用規(guī)則請(qǐng)查看12306官網(wǎng))（如:2016-12-01） 如果選擇單車次或者多車次多坐席的時(shí)候要傳主車次的具體發(fā)車時(shí)間，（如:2016-12-01 12:00）丰榴，參數(shù)值必須與querykey里的值保持一致 |
| closeTime | string | 是 | 搶票截止時(shí)間（格式如:2016-12-01 18:00:00） |
| acceptNoSeat | string | 是 | 是否接受無(wú)座货邓，0：不接受 1：接受 |
| person | string | 是 | 聯(lián)系人姓名 |
| cellphone | string | 是 | 聯(lián)系人手機(jī) |
| string | 否 | 聯(lián)系人郵箱 | |
| passengers | json數(shù)組 | 是 | 乘客信息(每個(gè)訂單最多五位乘客),格式如:[{"passengerName": "乘客姓名", "passengerType": "乘客類型 1：成人 2：兒童 3：學(xué)生票 4：殘軍票(暫不支持學(xué)生票和殘軍票)","idCardType": "證件類型 0：身份證 1：護(hù)照 2：臺(tái)胞證 3：港澳通行證", "idCardNo": "證件號(hào)碼","birthday": "生日" },{"passengerName": "XXX","passengerType": "1","idCardType": "0","idCardNo": "XXXXXXXXXXXXXXXXXXXXXXXXX","birthday": "1989-02-18"}] |
| 名稱 | 類型 | 說(shuō)明 |
|---|---|---|
| 見(jiàn)json示例 | - | - |
返回參數(shù)說(shuō)明：
| 名稱 | 類型 | 說(shuō)明 |
|---|---|---|
| 見(jiàn)json示例 | - | - |
JSON返回示例：
{
"reason": "success",
"result": {
"orderNo": "TFT583U752U210D284004800356",//內(nèi)部訂單號(hào)
"outOrderNo": "2016113001"http://訂單號(hào)(用戶自定義)
},
"error_code": 0
}
3.訂單詳情
接口地址：http://v.juhe.cn/grabTicket/action/orderDetail.php
支持格式：json
請(qǐng)求方式：get post
請(qǐng)求示例：http://v.juhe.cn/grabTicket/action/orderDetail.php?outOrderNo=123456&key=你申請(qǐng)的key
接口備注：查詢訂單的詳細(xì)信息、車票狀態(tài)四濒、以及車票號(hào)等
調(diào)用樣例及調(diào)試工具：API測(cè)試工具
請(qǐng)求參數(shù)說(shuō)明：
| 名稱 | 類型 | 必填 | 說(shuō)明 |
|---|---|---|---|
| key | string | 是 | 你申請(qǐng)的key |
| outOrderNo | string | 是 | 訂單號(hào) |
| issue | int | 否 | 0:未出票 1:已經(jīng)出票,默認(rèn)0(如果訂單還未出票則不需要此參數(shù),否則傳1,退票時(shí)候需要傳passengerId,可以通過(guò)輸入此參數(shù)查詢,未出票也可以加入此參數(shù),若加上此參數(shù)則沒(méi)有搶票的狀態(tài)) |
返回參數(shù)說(shuō)明：
| 名稱 | 類型 | 說(shuō)明 |
|---|---|---|
| 見(jiàn)json示例 | - | - |
JSON返回示例：
未出票(不傳issue參數(shù))json示例:
----------------------------------------
{
"reason": "success",
"result": {
"status": "U",
"fromStation": "蘇州",
"toStation": "昆山",
"departDate": "2016-12-30T02:29:00",
"orderNo": "TFT583U2D6U21011A3068416353",
"trainNo": "Z175",
"seatClass": "硬座",
"passengers": [
{
"passengerName": "魏XX",
"passengerType": 1,
"certificateNo": "320382XXXXXXX3916",
"ticketPrice": 0
}
],
"phone": "1599XXXXXXX",
"mainTrainNo": "",
"failMsg": "乘客身份信息未通過(guò)驗(yàn)證_訂票失敗 添加乘客 未通過(guò)身份效驗(yàn) XXX 320382XXXXXXX3916 ",
"mainSeatClass": "",
"grabEndTime": "2016-11-30T18:00:00"
},
"error_code": 0
}
已出票(加issue參數(shù))json示例:
----------------------------------------
{
"reason": "success",
"result": {
"orderNo": "FT584505292101648041264455",
"outOrderNo": "2016120501",
"trainNo": "K8371",
"trainDate": "2016-12-29",
"fromStation": "蘇州",
"toStation": "昆山",
"departureTime": "2016-12-29 03:34:00",
"arrivalTime": "2016-12-29 03:58:00",
"orderState": "已出票",
"orderStateCode": "F",
"failureReason": "",
"bookTime": "2016-12-05 14:11:52",//可忽略
"payTime": "2016-12-05 14:13:13",//可忽略
"issueTime": "2016-12-05 14:13:13",
"payType": "暫存單支付",//可忽略
"orderPrice": "9.00",
"ticketNo": "E345091034",
"placeTime": "2016-12-05 14:12:29",//可忽略
"payStatus": "0",//可忽略
"payInfo": "",//可忽略
"passengers": [
{
"passengerId": "623838773",
"passengerName": "XXX",
"passengerType": "1",
"idType": "1",
"idCard": "XXXXXXXXXXXXXXXXXX",
"birthday": "1976-06-13",
"seatClass": "hardseat",
"seatClassName": "硬座",
"seatNo": "07車廂,009號(hào)",
"pTicketNo": "E3450910341070009",
"ticketStateCode": "F",
"ticketState": "已出票",
"ticketPrice": "9.00",
"insureUnitPrice": "0.00",//可忽略
"insureState": null,//可忽略
"insureBillNo": null//可忽略
}
],
"contactInfo": {
"person": "1599****577",
"cellphone": "1599****577",
"email": ""
},
"postalInfo": {//可忽略
"person": null,
"cellphone": null,
"province": null,
"city": null,
"district": null,
"address": null,
"zip": null
},
"juheServiceFee": "8"
},
"error_code": 0
}
4.取消訂單
接口地址：http://v.juhe.cn/grabTicket/action/cancelOrder.php
支持格式：json
請(qǐng)求方式：get post
請(qǐng)求示例：http://v.juhe.cn/grabTicket/action/cancelOrder.php?outOrderNo=123456&key=你申請(qǐng)的key
接口備注：正在搶票中的訂單可以取消换况，取消后的訂單不再搶票； 取消前提： 1峻黍、訂單還未搶到票复隆； 2、搶票單未過(guò)期姆涩；
調(diào)用樣例及調(diào)試工具：API測(cè)試工具
請(qǐng)求參數(shù)說(shuō)明：
| 名稱 | 類型 | 必填 | 說(shuō)明 |
|---|---|---|---|
| outOrderNo | string | 是 | 訂單號(hào) |
| key string | 是 | 您申請(qǐng)的key |
返回參數(shù)說(shuō)明：
| 名稱 | 類型 | 說(shuō)明 |
|---|---|---|
| 見(jiàn)json示例 | - | - |
JSON返回示例：
取消失敗:
{
"reason": "搶票取消失敗",
"result": null,
"error_code": 223801
}
取消成功:
{
"reason": "success",
"result": {
"orderNo": "TFT583U7A64210D1BB016912627"
},
"error_code": 0
}
5.申請(qǐng)退票
接口地址：http://v.juhe.cn/grabTicket/action/applyRefundOrder.php
支持格式：json
請(qǐng)求方式：get post
請(qǐng)求示例：http://v.juhe.cn/grabTicket/action/applyRefundOrder.php
接口備注：對(duì)已出票的訂單發(fā)起退票請(qǐng)求挽拂，只支持每次申請(qǐng)1名乘客退票，接口返回申請(qǐng)結(jié)果骨饿，實(shí)際退票結(jié)果通過(guò)消息推送進(jìn)行異步通知亏栈； 退票成功后會(huì)自動(dòng)給用戶退保，無(wú)需分銷商主動(dòng)申請(qǐng)宏赘，退保結(jié)果通過(guò)消息推送進(jìn)行異步通知绒北；
調(diào)用樣例及調(diào)試工具：API測(cè)試工具
請(qǐng)求參數(shù)說(shuō)明：
| 名稱 | 類型 | 必填 | 說(shuō)明 |
|---|---|---|---|
| key | string | 是 | 你申請(qǐng)的key |
| outOrderNo | string | 是 | 訂單號(hào) |
| passengerId | string | 是 | 乘客id |
返回參數(shù)說(shuō)明：
| 名稱 | 類型 | 說(shuō)明 |
|---|---|---|
| 見(jiàn)json示例 | - | - |
JSON返回示例：
失敗：
{
"reason": "參數(shù)錯(cuò)誤:訂單號(hào)或passengerId不存在",
"result": null,
"error_code": 223804
}
成功：
{
"reason": "success",
"result": {
"orderNo": "TFT583U7D552101629055112720",
"passengerId": "615151438"
},
"error_code": 0
}
6.配置回調(diào)地址
接口地址：http://v.juhe.cn/grabTicket/action/addCallbackUrl.php
支持格式：json
請(qǐng)求方式：get post
請(qǐng)求示例：http://v.juhe.cn/grabTicket/action/addCallbackUrl.php?url=xxxx&type=1&key=您申請(qǐng)的key
接口備注：配置回調(diào)地址,如果出票失敗,可以通過(guò)訂單詳情查看失敗原因
調(diào)用樣例及調(diào)試工具：API測(cè)試工具
請(qǐng)求參數(shù)說(shuō)明：
| 名稱 | 類型 | 必填 | 說(shuō)明 |
|---|---|---|---|
| key | string | 是 | 你申請(qǐng)的key |
| url | string | 是 | 回調(diào)地址 |
| type | string | 是 | 回調(diào)類型(1:占座和出票結(jié)果合并推送(包含成功和失敗)察署； 2:退票退款推送 闷游；3:搶票過(guò)期推送 ) |
返回參數(shù)說(shuō)明：
| 名稱 | 類型 | 說(shuō)明 |
|---|---|---|
| 見(jiàn)json示例 | - | - |
JSON返回示例：
配置成功json示例:
----------------------------------------
{
"error_code": 0,
"reason": "success",
"data": null
}
出票成功推送示例:
----------------------------------------
{
"orderNo": "TFT583U7D552101629055112720",
"outOrderNo": "2016113006",
"msgCode": "100",//詳見(jiàn)下方字段說(shuō)明
"msgInfo": "出票成功",
"fromStationCode": "226",
"toStationCode": "226",
"departureTime": "2016-12-29 02:29:00",//發(fā)車時(shí)間
"arrivalTime": "2016-12-29 02:53:00",//到達(dá)時(shí)間
"trainNo": "Z175",
"ticketNo": "E566781381",//票號(hào)
"orderAmount": "9.00",//訂單價(jià)格
"fromStation": "蘇州",
"toStation": "昆山",
"issueTime": "2016-11-30 15:21:53",//出票時(shí)間
"mailCharge": "0.00",//郵寄費(fèi)用,可忽略
"msgDetail": null,//msgDetail有值時(shí)表示該失敗原因針對(duì)這些乘客，格式：姓名|證件號(hào),姓名|證件號(hào)
"passengers": [
{
"passengerName": "奧巴馬",
"passengerType": "1",
"cardType": "1",
"cardNo": "xxxxxxxxxxxxxxx",
"passengerId": "615151438",
"seatClass": "1",
"seatNo": "02車廂,007號(hào)",
"price": "9.00",
"pTicketNo": "E5667813811020007",
"serviceCharge": "0",
"insuranceCharge": "0.00"
}
],
"isChangedOrder": "0",
"originalOrderNo": "",
"changedType": "",
"serviceCharge": "",
"changePriceDiff": "",
"juheServiceFee": "8"
}
出票失敗推送示例:
----------------------------------------
{
"orderNo": "TFT583U752U210D284004800356",
"outOrderNo": "2016113001",
"msgCode": "101",//詳見(jiàn)下方
"msgInfo": "出票失敗",
"fromStationCode": null,
"toStationCode": null,
"departureTime": null,
"arrivalTime": null,
"trainNo": null,
"ticketNo": null,
"orderAmount": null,
"fromStation": null,
"toStation": null,
"issueTime": "",
"mailCharge": null,
"msgDetail": null,
"passengers": [
{
"passengerName": "張三",
"passengerType": "1",
"cardType": "1",
"cardNo": "XXXXXXXXXX",
"passengerId": "123",//退票時(shí)候需要此字段
"seatClass": "1",
"seatNo": "",
"price": "100.00",
"pTicketNo": "",
"serviceCharge": "0",
"insuranceCharge": "0.00"
}
],
"isChangedOrder": "0",
"originalOrderNo": "",
"changedType": "",
"serviceCharge": "",
"changePriceDiff": "",
"juheServiceFee": "0"
}
訂單過(guò)期推送示例:
----------------------------------------
{
"msgCode": "101",
"msgInfo": "搶票單過(guò)期",
"orderNo": "TFT583U7C4921011A3062532520",
"outOrderNo": "2016113005"
}
退款成功推送示例:
----------------------------------------
{
"orderNo": "TFT583U7D552101629055112720",
"outOrderNo": "2016113006",
"refundTime": "2016-11-30 15:32:00",
"refundPrice": "9.00",
"refundType": "online",
"passengers": [
{
"passengerId": "615151438",
"pTicketNo": "E5667813811020007",
"passengerName": "奧巴馬",
"passengerType": "1",
"cardType": "1",
"cardNo": "",
"refundPrice": "9.00"
}
],
"msgCode": "100",
"msgInfo": "線上退票成功"
}
退款失敗推送示例:
----------------------------------------
{
"msgCode": "101",
"msgInfo": "參數(shù)無(wú)效",
"orderNo": "FT123456789",
"outOrderNo": "XXXXXX",
"refundTime": "2016-06-22 09:56:16",
"refundPrice": "0.00",
"refundType": "online",
"passengers": [
{
"passengerId": "123",
"passengerName": "張三",
"passengerType": "1",
"cardType": "1",
"cardNo": "",
"refundPrice": "0.00",
"pTicketNo": "E1234567890001"
}
]
}
7.數(shù)據(jù)字典
接口地址：http://v.juhe.cn/grabTicket/action/dataDictionary.php
支持格式：json
請(qǐng)求方式：get post
請(qǐng)求示例：http://v.juhe.cn/grabTicket/action/dataDictionary.php?key=你申請(qǐng)的key
接口備注：返回接口相關(guān)的字段使用場(chǎng)景及含義
調(diào)用樣例及調(diào)試工具：[API測(cè)試工具](https://www.juhe.cn/box/index/id/257)
JSON返回示例：
**[html]** [view plain](http://blog.csdn.net/ishxiao/article/details/54573147#) [copy](http://blog.csdn.net/ishxiao/article/details/54573147#)
[[圖片上傳中。脐往。休吠。（13）]](https://code.csdn.net/snippets/2130051)[[圖片上傳中。业簿。瘤礁。（14）]](https://code.csdn.net/snippets/2130051/fork)
{
"reason": "success",
"result": {
"tips": [
"搶票單暫時(shí)不可以購(gòu)買保險(xiǎn)",
"搶票單目前最多支持五名乘客",
"搶票單目前暫不支持學(xué)生票和殘軍票",
"選擇備選車次、備選坐席等均可提高搶票成功率",
"申請(qǐng)退票流程是針對(duì)訂單中的車票而非針對(duì)訂單",
"申請(qǐng)退票只支持單張車票梅尤，如多人退票需每張車票單獨(dú)申請(qǐng)",
"測(cè)試單請(qǐng)創(chuàng)建發(fā)車日期在20天以后的柜思，因?yàn)闀?huì)產(chǎn)生真實(shí)的費(fèi)用",
"在搶票有效時(shí)間內(nèi)會(huì)持續(xù)搶票，搶票成功后直接出票并回調(diào)給用戶",
"搶票有效時(shí)間內(nèi)未搶到票巷燥，我們會(huì)主動(dòng)推送搶票單過(guò)期信息",
"正在搶票中的訂單可以取消赡盘，取消后不可再次開(kāi)啟。建議您不要輕易取消搶票",
"搶票單默認(rèn)使用合并推送矾湃，用戶需要提供占座和出票合并網(wǎng)關(guān)以便正常接收到數(shù)據(jù)",
"距離發(fā)車時(shí)間太近無(wú)法搶票亡脑，建議用戶限制距離發(fā)車前3小時(shí)以上的車次才可創(chuàng)建搶票單",
"搶票單的訂單狀態(tài)可以調(diào)用訂單詳情接口查看，搶票成功后更為詳盡的訂單信息可調(diào)用訂單詳情接口獲取邀跃，此時(shí)需要加上issue參數(shù)"
],
"idType": {
"msg": "證件類型,一般用在創(chuàng)建訂單的idType字段",
"data": {
"1": "身份證",
"2": "護(hù)照",
"3": "臺(tái)胞證",
"4": "港澳通行證"
}
},
"passengerType": {
"msg": "乘客類型,一般用在創(chuàng)建訂單的passengerType字段",
"data": {
"1": "成人",
"2": "兒童",
"3": "學(xué)生票",
"4": "殘軍票"
}
},
"refundType": {
"msg": "退款類型,一般用在退款結(jié)果推送接口",
"data": {
"0": "change：改簽差價(jià)退款",
"1": "repeatpay：重復(fù)支付退款",
"2": "delaypay：延遲支付退款",
"online": "線上退票退款",
"offline": "車站退票退款",
"issuefail": "出票失敗退款",
"other": "其他原因退款"
}
},
"seatClass": {
"msg": "一般用在回調(diào)出票成功后的passengers數(shù)組中的seatClass中",
"data": {
"1": "硬座",
"2": "軟座",
"3": "一等座",
"4": "二等座",
"5": "硬臥上鋪",
"6": "硬臥",
"7": "硬臥下鋪",
"8": "軟臥上鋪",
"9": "軟臥",
"10": "無(wú)座",
"11": "商務(wù)座",
"12": "特等座",
"13": "其它",
"14": "高級(jí)軟臥",
"15": "動(dòng)臥上鋪",
"16": "動(dòng)臥下鋪",
"17": "高級(jí)動(dòng)臥上鋪",
"18": "高級(jí)動(dòng)臥下鋪",
"33": "一等軟座",
"44": "二等軟座"
}
},
"seatClassCode": {
"msg": "一般用在站站查詢返回的json數(shù)據(jù)及創(chuàng)建訂單時(shí)候的seatClassCode和mainSeatClass字段",
"data": {
"hardseat": "硬座",
"softseat": "軟座",
"firstseat": "一等座",
"secondseat": "二等座",
"hardsleeperup": "硬臥上鋪",
"hardsleepermid": "硬臥中鋪",
"hardsleeperdown": "硬臥下鋪",
"softsleeperup": "軟臥上鋪",
"softsleeperdown": "軟臥下鋪",
"noseat": "無(wú)座",
"businessseat": "商務(wù)座",
"specialseat": "特等座",
"advancedsoftsleeper": "高級(jí)軟臥",
"otherseat": "其他"
}
},
"trainClass": {
"msg": "一般用在站站查詢返回的json數(shù)據(jù)中的trains數(shù)組中的trainClass字段",
"data": {
"C": "城際高速",
"D": "動(dòng)車組",
"KT": "空調(diào)特快",
"KKS": "空調(diào)快速",
"KPK": "空調(diào)普快",
"KPM": "空調(diào)普慢",
"KS": "快速",
"PK": "普快",
"PM": "普慢",
"XGZ": "香港直通車",
"Z": "直達(dá)特快",
"GD": "高速動(dòng)車"
}
},
"ticketStateCode": {
"msg": "一般用在訂單詳情接口返回json數(shù)據(jù)中的passengers數(shù)組中的ticketStateCode字段(如無(wú),請(qǐng)忽略)",
"data": {
"N": "未出票",
"F": "已出票",
"C": "退票中",
"T": "已退票",
"O": "退票失敗",
"Y": "改簽中",
"G": "已改簽"
}
},
"orderStatus": {
"msg": "一般用在訂單詳情接口返回的json數(shù)據(jù)中的grabOrderDetailInfo中的status字段",
"data": {
"N": "搶票單已創(chuàng)建",
"B": "未到開(kāi)搶時(shí)間",
"D": "搶票中",
"F": "搶票成功（出票成功）",
"U": "出票失敗",
"O": "已過(guò)期",
"C": "已取消",
"T": "已退票",
"E": "已改簽"
}
},
"msgCode": {
"msg": "一般用在回調(diào)接口中(所有的回調(diào)的接口),所有的狀態(tài)都是有可能返回的",
"data": {
"100": "請(qǐng)求成功",
"101": "參數(shù)無(wú)效",
"102": "簽名驗(yàn)證失敗",
"103": "該IP沒(méi)有權(quán)限訪問(wèn)此接口",
"104": "請(qǐng)求過(guò)于頻繁霉咨，請(qǐng)稍后重試",
"105": "沒(méi)有權(quán)限訪問(wèn)此接口",
"201": "該訂單不存在",
"202": "當(dāng)前訂單狀態(tài)不允許執(zhí)行此操作",
"203": "當(dāng)前時(shí)間不支持此服務(wù)",
"204": "坐席無(wú)效",
"205": "發(fā)車日期無(wú)效",
"206": "取消次數(shù)過(guò)多，取消請(qǐng)求已鎖定",
"207": "訂單已過(guò)期",
"208": "車次號(hào)無(wú)效",
"209": "該坐席已售完",
"210": "該賬號(hào)有未完成的訂單拍屑，無(wú)法繼續(xù)執(zhí)行此操作",
"211": "分銷商身份驗(yàn)證無(wú)效",
"212": "該訂單未付款途戒，無(wú)法出票",
"213": "坐席價(jià)格錯(cuò)誤",
"214": "占座排隊(duì)中，請(qǐng)等待占座結(jié)果",
"215": "站站查詢結(jié)果已過(guò)期僵驰，請(qǐng)重新查詢",
"216": "距離發(fā)車時(shí)間太近喷斋，無(wú)法執(zhí)行此操作",
"217": "實(shí)際占座為無(wú)座，乘客制定不接受無(wú)座",
"218": "測(cè)試訂單不允許預(yù)定20天以內(nèi)發(fā)車的車次",
"219": "搶票單已達(dá)預(yù)約上限",
"220": "搶票單乘客數(shù)蒜茴，車次數(shù)星爪，坐席數(shù)超過(guò)配置上限",
"221": "搶票取消失敗",
"222": "搶票功能關(guān)閉",
"301": "該訂單中無(wú)此乘客",
"302": "乘客身份信息涉嫌被他人冒用",
"303": "當(dāng)前車票狀態(tài)不允許執(zhí)行此操作",
"304": "乘客信息不正確",
"305": "乘客已預(yù)訂過(guò)與該行程有沖突的車票",
"306": "乘客已被法院依法限制高消費(fèi)",
"307": "乘客已預(yù)訂過(guò)該車次，無(wú)法重復(fù)預(yù)訂",
"308": "乘客身份信息未通過(guò)驗(yàn)證",
"309": "出票5分鐘內(nèi)無(wú)法提交退票",
"310": "距離發(fā)車時(shí)間太近粉私，無(wú)法申請(qǐng)退票",
"311": "訂單中包含兒童票顽腾，如需退票請(qǐng)先退兒童票",
"312": "不支持網(wǎng)上退票",
"313": "訂單中包含兒童票，該乘客無(wú)法改簽",
"314": "距離發(fā)車時(shí)間太近诺核，無(wú)法改簽",
"315": "要改簽的車次不在預(yù)售期內(nèi)抄肖，無(wú)法改簽",
"316": "該訂單不支持改簽",
"317": "改簽次數(shù)過(guò)多，改簽請(qǐng)求已鎖定",
"318": "當(dāng)天取消改簽次數(shù)過(guò)多窖杀，取消請(qǐng)求已鎖定",
"319": "購(gòu)保失敗",
"320": "退保失敗",
"401": "購(gòu)票所使用的12306賬號(hào)未進(jìn)行手機(jī)核驗(yàn)",
"402": "購(gòu)票所使用的12306賬號(hào)被封漓摩，無(wú)法執(zhí)行此操作",
"403": "12306賬號(hào)登錄失敗",
"404": "12306賬號(hào)尚未激活，請(qǐng)用注冊(cè)時(shí)的郵箱激活后重試",
"405": "12306賬號(hào)未通過(guò)身份信息核驗(yàn)入客，請(qǐng)核驗(yàn)后重試",
"406": "12306賬號(hào)已被鎖定",
"407": "登錄驗(yàn)證碼錯(cuò)誤",
"408": "12306賬號(hào)格式不正確",
"409": "12306賬號(hào)常用聯(lián)系人已達(dá)上限管毙，無(wú)法繼續(xù)添加",
"410": "當(dāng)日獲取短信驗(yàn)證碼次數(shù)已達(dá)上限",
"411": "郵箱已被注冊(cè)",
"412": "用戶名已被注冊(cè)",
"413": "手機(jī)號(hào)碼已被注冊(cè)",
"414": "證件號(hào)碼已被注冊(cè)",
"415": "12306賬號(hào)不可用",
"416": "手機(jī)號(hào)或證件號(hào)碼不正確",
"417": "該聯(lián)系人已存在",
"999": "未知的失敗原因"
}
}
},
"error_code": 0
}
