查询火车票查询(站站、余票等)、订购(预定、抢购等)、需要提前预充值金额,订购抢购时实时扣除费用 订购过程:1、先使用站站查询获取queryKey、车次、座位类型、票价 2、查询保险获取保险相关单号价格 3、订购页面填入相关参数订票
站站查询
接口地址:http://route.showapi.com/1651-1 (注意:接口支持https,更安全,但稍慢一些,你懂的。请根据自己的情况进行选择。)
支持格式:json
请求方法:HTTP协议,支持GET/POST方法。
二、请求参数/ Request parameter
非文件上传的POST时,enctype=application/x-www-form-urlencoded。
文件上传的POST时,enctype=multipart/form-data。
1、系统级参数(所有接入点都需要的参数):
参数名称 | 类型 | 示例值 | 必须 | 描述 |
---|
showapi_appid | String | 100 | 是 | 易源应用id |
---|
showapi_sign | String | 698d51a19d8a121ce581499d7b701668 | 是 | 为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。 可选,在url后带上appid和secret即可 |
---|
showapi_timestamp | String | 20141114142239 | 否 | 客户端时间。 格式yyyyMMddHHmmss,如20141114142239 为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。 |
---|
showapi_res_gzip | String | 1或0 | 否 | 返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩。 |
---|
... |
---|
2、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表): 展开收起
参数名称 | 类型 | 默认值 | 示例值 | 必须 | 描述 |
---|
departStation | String | | 上海 | 是 | 出发地 |
---|
arrivalStation | String | | 北京 | 是 | 目的地 |
---|
date | String | | | 是 | 出发日期(格式yyyyMMdd) |
---|
type | String | | 1 | 否 | 票种类型:1、普通票 2、学生票 |
---|
... |
---|
请求示例:String res=new ShowApiRequest("http://route.showapi.com/1651-1","my_appId","my_appSecret")
.addTextPara("departStation","上海")
.addTextPara("arrivalStation","北京")
.addTextPara("date","")
.addTextPara("type","1")
.post();
System.out.println(res);
三、返回参数/ Return parameter
以JSON格式返回结果。
1、系统级参数(所有接入点都会返回的参数): 展开收起
名称 | 类型 | 示例值 | 描述 |
---|
showapi_res_body | String | {"city":"昆明","prov":"云南"} | 消息体的JSON封装,所有应用级的返回参数将嵌入此对象 。 |
---|
showapi_res_code | int | 0 | 易源返回标志,0为成功,其他为失败。 0成功 -1,系统调用错误 -2,可调用次数或金额为0 -3,读取超时 -4,服务端返回数据解析错误 -5,后端服务器DNS解析错误 -6,服务不存在或未上线 -7, API创建者的网关资源不足 -1000,系统维护 -1002,showapi_appid字段必传 -1003,showapi_sign字段必传 -1004,签名sign验证有误 -1005,showapi_timestamp无效 -1006,app无权限调用接口 -1007,没有订购套餐 -1008,服务商关闭对您的调用权限 -1009,调用频率受限 -1010,找不到您的应用 -1011,子授权app_child_id无效 -1012,子授权已过期或失效 -1013,子授权ip受限 -1014,token权限无效 |
---|
showapi_res_error | String | 用户输入有误! | 错误信息的展示 |
---|
showapi_res_id | String | ce135f6739294c63be0c021b76b6fbff | 本次请求id |
---|
... |
---|
2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构): 展开收起
名称 | 类型 | 示例值 | 描述 |
---|
ret_code | String | 0 | 接口调用是否成功,0为成功,其他为失败 |
---|
remark | String | 查询成功! | 提示信息 |
---|
departStation | String | | 出发站 |
---|
departStationEn | String | | 出发站英文 |
---|
arrivalStation | String | | 到达站 |
---|
arrivalStationEn | String | | 到达站英文 |
---|
date | String | | 日期 |
---|
totalTrains | String | | 总数 |
---|
trains | Object[] | | 火车详情 |
---|
- serialNum | String | | 顺序号码 |
---|
- trainNum | String | | 车次号 |
---|
- departTime | String | | 从该站发车时间 如: |
---|
- arrivalTime | String | | 到达该站时间(如果是首发站则没有到达时间) |
---|
- startPassType | String | | 发站类别(始、过) 0:始发 1:路过 |
---|
- arrivalPassType | String | | 到站类别(过、终) 2:终点 1:路过 |
---|
- bookingState | String | | 可预订级别(0:不可预订 1:可预订 2:全部不可预订 3:发车前半小时车次不可预订) |
---|
- trainType | String | | 火车类型 |
---|
- identityCard | String | | 身份证进站标识 0 不可 1 可以 |
---|
- saleType | String | | 0.正常车次,不受控 1.列车运行图调整,暂停发售 2.未开售,可预约 3暂售至 |
---|
- saleTime | String | | saleType等于2或者3 对应的订购起始时间 |
---|
- tickets | Object | | 车票信息(包含的对象里key之为座位类型英文,可在帮助文档对应) |
---|
- price | String | | 价格 |
---|
- seatState | String | | 0:不可预定 1:可预定 |
---|
- midPrice | String | | 中铺价格,若无则为0(该字段仅卧铺才有具体价格,且部分卧铺无中铺,如动卧等) |
---|
- downPrice | String | | 下铺价格,若无则为0(该字段仅卧铺才有具体价格) |
---|
- seats | String | | 余票数量 |
---|
- seatName | String | | 座位中文 |
---|
- upPrice | String | | 上铺价格(该字段仅卧铺才有具体价格) |
---|
- runTime | String | | 历时(分钟)如: |
---|
- departStation | String | | 出发站站名 |
---|
- arrivalStation | String | | 到达站站名 |
---|
- note | String | | 预售信息描述(预售时间已过返回为空) |
---|
- trainLongNum | String | | 长车次号 |
---|
departs | String | | 出发站站点 |
---|
arrivals | String | | 到达站站点 |
---|
uniqueKey | String | | 唯一识别key(可用于订购车票) |
---|
paraName | String | | 请填写参数描述 |
---|
... |
---|
返回示例:{
"showapi_res_error": "",
"showapi_res_id": "581281a9ac2745ffb94bd87773ada87d",
"showapi_res_code": 0,
"showapi_res_body": {
"departStation": "上海",
"arrivalStation": "北京",
"remark": "查询成功!",
"showapi_fee_code": 0,
"arrivals": [
"北京南",
"北京"
],
"date": "20190826",
"uniqueKey": "d5c9bfcff5db680a4ed081f97d20d2b9",
"ret_code": "0",
"arrivalStationEn": "beijing",
"totalTrains": 51,
"departStationEn": "shanghai",
"trains": [
{
"departStation": "上海虹桥",
"arrivalStation": "北京南",
"trainNum": "G102",
"trainLongNum":"560000D71800",
"bookingState": 1,
"arrivalPassType": 2,
"departTime": "06:26",
"runTime": "363",
"identityCard": 1,
"startPassType": 0,
"arrivalTime": "12:29",
"saleType": "0",
"saleTime": "",
"trainType": "GD",
"serialNum": 1,
"note": "",
"tickets": {
"businessseat": {
"price": 1748,
"seatState": 1,
"midPrice": 0,
"downPrice": 0,
"seats": "2",
"seatName": "商务座",
"upPrice": 0
},
"secondseat": {
"price": 553,
"seatState": 1,
"midPrice": 0,
"downPrice": 0,
"seats": "21",
"seatName": "二等座",
"upPrice": 0
},
"firstseat": {
"price": 933,
"seatState": 1,
"midPrice": 0,
"downPrice": 0,
"seats": "21",
"seatName": "一等座",
"upPrice": 0
}
}
}
],
"departs": [
"上海虹桥",
"上海",
"上海南"
]
}
}
车次查询
接口地址:http://route.showapi.com/1651-2 (注意:接口支持https,更安全,但稍慢一些,你懂的。请根据自己的情况进行选择。)
支持格式:json
请求方法:HTTP协议,支持GET/POST方法。
二、请求参数/
Request parameter
非文件上传的POST时,enctype=application/x-www-form-urlencoded。
文件上传的POST时,enctype=multipart/form-data。
1、系统级参数(所有接入点都需要的参数):
参数名称 |
类型 |
示例值 |
必须 |
描述 |
showapi_appid |
String |
100 |
是 |
易源应用id |
showapi_sign |
String |
698d51a19d8a121ce581499d7b701668 |
是 |
为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。
可选,在url后带上appid和secret即可
|
showapi_timestamp |
String |
20141114142239 |
否 |
客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。
|
showapi_res_gzip |
String |
1或0 |
否 |
返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩。 |
... |
2、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表):
参数名称 |
类型 |
默认值 |
示例值 |
必须 |
描述 |
trainNum |
String |
|
|
是 |
|
date |
String |
|
|
是 |
|
请求示例:String res=new ShowApiRequest("http://route.showapi.com/1651-2","my_appId","my_appSecret")
.addTextPara("trainNum","G101")
.addTextPara("date","")
.post();
System.out.println(res);
三、返回参数/
Return parameter
以JSON格式返回结果。
1、系统级参数(所有接入点都会返回的参数):
展开收起
名称 |
类型 |
示例值 |
描述 |
showapi_res_body |
String |
{"city":"昆明","prov":"云南"} |
消息体的JSON封装,所有应用级的返回参数将嵌入此对象 。 |
showapi_res_code |
int |
0 |
易源返回标志,0为成功,其他为失败。
0成功
-1,系统调用错误
-2,可调用次数或金额为0
-3,读取超时
-4,服务端返回数据解析错误
-5,后端服务器DNS解析错误
-6,服务不存在或未上线
-7, API创建者的网关资源不足
-1000,系统维护
-1002,showapi_appid字段必传
-1003,showapi_sign字段必传
-1004,签名sign验证有误
-1005,showapi_timestamp无效
-1006,app无权限调用接口
-1007,没有订购套餐
-1008,服务商关闭对您的调用权限
-1009,调用频率受限
-1010,找不到您的应用
-1011,子授权app_child_id无效
-1012,子授权已过期或失效
-1013,子授权ip受限
-1014,token权限无效
|
showapi_res_error |
String |
用户输入有误! |
错误信息的展示 |
showapi_res_id |
String |
ce135f6739294c63be0c021b76b6fbff |
本次请求id |
... |
2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构):
展开收起
名称 |
类型 |
示例值 |
描述 |
ret_code
|
String |
|
|
remark
|
String |
|
|
trainNum
|
String |
|
|
trainType
|
String |
|
|
departStation
|
String |
|
|
departStationCode
|
String |
|
|
departStationNum
|
String |
|
|
departureTime
|
String |
|
|
arrivalStation
|
String |
|
|
arrivalStationCode
|
String |
|
|
arrivalStationNum
|
String |
|
|
date
|
String |
|
|
arrivalTime
|
String |
|
|
runTime
|
String |
|
|
ticketPrices
|
String |
|
|
trainStations
|
Object[] |
|
|
-
serialNum
|
String |
|
|
-
trainNum
|
String |
|
|
-
departStation
|
String |
|
|
-
departStationCode
|
String |
|
|
-
departStationNum
|
String |
|
|
-
departureTime
|
String |
|
|
-
arrivalTime
|
String |
|
|
-
stayTime
|
String |
|
|
-
runTime
|
String |
|
|
trainSeats
|
Object[] |
|
|
-
seatType
|
String |
|
座位席别代码,对应类型见文档(只显示有票的座位类型)
|
-
seatPrice
|
String |
|
|
-
standbyTickets
|
String |
|
|
-
bookingState
|
String |
|
|
... |
返回示例:{
"showapi_res_code": 0,
"showapi_res_error": "",
"showapi_res_body": {
"ret_code": "0",
"remark": "查询成功!",
"trainNum": "G101",
"trainType": "GD",
"departStation": "北京南",
"departStationCode": "beijingnan",
"departStationNum": "53",
"departureTime": "06:43",
"arrivalStation": "上海虹桥",
"arrivalStationCode": "shanghaihongqiao",
"arrivalStationNum": "321",
"date": "2018-08-01",
"arrivalTime": "12:40",
"miles": "0",
"runTime": "357",
"ticketPrices": "",
"trainStations": [
{
"serialNum": "1",
"trainNum": "G101",
"departStation": "北京南",
"departStationCode": "beijingnan",
"departStationNum": "53",
"departureTime": "06:43",
"arrivalTime": "始发站",
"stayTime": "0",
"runTime": "0",
"miles": "0"
},
{
"serialNum": "2",
"trainNum": "G101",
"departStation": "沧州西",
"departStationCode": "cangzhouxi",
"departStationNum": "140",
"departureTime": "07:38",
"arrivalTime": "07:35",
"stayTime": "3",
"runTime": "52",
"miles": "0"
}
........
],
"trainSeats": [
{
"seatType": "3",
"seatPrice": "933.00",
"standbyTickets": "",
"bookingState": ""
}
........
]
}
}
车站查询
接口地址:http://route.showapi.com/1651-3 (注意:接口支持https,更安全,但稍慢一些,你懂的。请根据自己的情况进行选择。)
支持格式:json
请求方法:HTTP协议,支持GET/POST方法。
二、请求参数/
Request parameter
非文件上传的POST时,enctype=application/x-www-form-urlencoded。
文件上传的POST时,enctype=multipart/form-data。
1、系统级参数(所有接入点都需要的参数):
参数名称 |
类型 |
示例值 |
必须 |
描述 |
showapi_appid |
String |
100 |
是 |
易源应用id |
showapi_sign |
String |
698d51a19d8a121ce581499d7b701668 |
是 |
为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。
可选,在url后带上appid和secret即可
|
showapi_timestamp |
String |
20141114142239 |
否 |
客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。
|
showapi_res_gzip |
String |
1或0 |
否 |
返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩。 |
... |
2、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表):
展开收起
参数名称 |
类型 |
默认值 |
示例值 |
必须 |
描述 |
station |
String |
|
|
是 |
|
trainType |
String |
|
|
否 |
|
sort |
String |
|
|
否 |
|
passType |
String |
|
|
否 |
车站类型1、SF:起始站
2、ZD:终点站
3、GL:过路
|
departTimeRange |
String |
|
|
否 |
出发时间固定范围 0:凌晨(00:00-06:00)
1:上午(06:00-12:00)
2:下午(12:00-18:00)
3:晚上(18:00-24:00)
注:传递值只能是数字0,1,2,3(换乘情况时失效)
|
arrivalTimeRange |
String |
|
|
否 |
到达时间范围 0:凌晨(00:00-06:00)
1:上午(06:00-12:00)
2:下午(12:00-18:00)
3:晚上(18:00-24:00)
注:传递值只能是数字0,1,2,3(换乘情况时失效)
|
maxResult |
String |
|
|
否 |
每页显示的条数,必需为整数(默认20,不能超过100)
|
page |
String |
|
|
否 |
|
... |
请求示例:String res=new ShowApiRequest("http://route.showapi.com/1651-3","my_appId","my_appSecret")
.addTextPara("station","上海")
.addTextPara("trainType","GD,D")
.addTextPara("sort","")
.addTextPara("passType","")
.addTextPara("departTimeRange","")
.addTextPara("arrivalTimeRange","")
.addTextPara("maxResult","20")
.addTextPara("page","1")
.post();
System.out.println(res);
三、返回参数/
Return parameter
以JSON格式返回结果。
1、系统级参数(所有接入点都会返回的参数):
展开收起
名称 |
类型 |
示例值 |
描述 |
showapi_res_body |
String |
{"city":"昆明","prov":"云南"} |
消息体的JSON封装,所有应用级的返回参数将嵌入此对象 。 |
showapi_res_code |
int |
0 |
易源返回标志,0为成功,其他为失败。
0成功
-1,系统调用错误
-2,可调用次数或金额为0
-3,读取超时
-4,服务端返回数据解析错误
-5,后端服务器DNS解析错误
-6,服务不存在或未上线
-7, API创建者的网关资源不足
-1000,系统维护
-1002,showapi_appid字段必传
-1003,showapi_sign字段必传
-1004,签名sign验证有误
-1005,showapi_timestamp无效
-1006,app无权限调用接口
-1007,没有订购套餐
-1008,服务商关闭对您的调用权限
-1009,调用频率受限
-1010,找不到您的应用
-1011,子授权app_child_id无效
-1012,子授权已过期或失效
-1013,子授权ip受限
-1014,token权限无效
|
showapi_res_error |
String |
用户输入有误! |
错误信息的展示 |
showapi_res_id |
String |
ce135f6739294c63be0c021b76b6fbff |
本次请求id |
... |
2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构):
展开收起
名称 |
类型 |
示例值 |
描述 |
ret_code
|
String |
|
|
remark
|
String |
|
|
station
|
String |
|
|
stationEn
|
String |
|
|
stationNum
|
String |
|
|
page
|
String |
|
|
maxResult
|
String |
|
|
pageSize
|
String |
|
|
totalCount
|
String |
|
|
stations
|
String |
|
|
tickets
|
String |
|
|
trains
|
Object[] |
|
|
-
serialNum
|
String |
|
|
-
trainNum
|
String |
|
|
-
trainType
|
String |
|
|
-
departStation
|
String |
|
|
-
departStationEn
|
String |
|
|
-
departStationNum
|
String |
|
|
-
departTime
|
String |
|
|
-
arrivalStation
|
String |
|
|
-
arrivalStationEn
|
String |
|
|
-
arrivalStationNum
|
String |
|
|
-
arrivalTime
|
String |
|
|
-
stayStation
|
String |
|
|
-
stayStationNum
|
String |
|
|
-
stayStationEn
|
String |
|
|
-
stayDepartTime
|
String |
|
|
-
stayArrivalTime
|
String |
|
|
-
prices
|
String |
|
|
-
seats
|
String |
|
|
... |
返回示例:{
"showapi_res_code": 0,
"showapi_res_error": "",
"showapi_res_body": {
"ret_code": "0",
"remark": "查询成功!",
"station": "上海",
"stationEn": "shanghai",
"stationNum": "321",
"page": 1,
"maxResult": 20,
"pageSize": 77,
"totalCount": 1536,
"stations": [
{
"station": "上海西",
"stationEn": "ShangHaiXi"
},
{
"station": "上海",
"stationEn": "ShangHai"
},
{
"station": "上海南",
"stationEn": "ShangHaiNan"
},
{
"station": "上海虹桥",
"stationEn": "ShangHaiHongQiao"
}
],
"tickets": [
{
"trainType": "D",
"tickets": "336"
},
{
"trainType": "GD",
"tickets": "1200"
}
],
"trains": [
{
"serialNum": 0,
"trainNum": "G9449",
"trainType": "GD",
"departStation": "滁州",
"departStationEn": "chuzhou",
"departStationNum": "40",
"departTime": "21:58",
"arrivalStation": "上海虹桥",
"arrivalStationEn": "shanghaihongqiao",
"arrivalStationNum": "321",
"arrivalTime": "00:02",
"stayStation": "上海虹桥",
"stayStationNum": "321",
"stayStationEn": "shanghaihongqiao",
"stayDepartTime": "00:02",
"stayArrivalTime": "00:02",
"miles": 0,
"prices": "",
"seats": [
]
},
{
"serialNum": 18,
"trainNum": "D5451",
"trainType": "D",
"departStation": "蚌埠南",
"departStationEn": "bengbunan",
"departStationNum": "37",
"departTime": "22:07",
"arrivalStation": "上海虹桥",
"arrivalStationEn": "shanghaihongqiao",
"arrivalStationNum": "321",
"arrivalTime": "00:45",
"stayStation": "上海虹桥",
"stayStationNum": "321",
"stayStationEn": "shanghaihongqiao",
"stayDepartTime": "00:45",
"stayArrivalTime": "00:45",
"miles": 0,
"prices": "",
"seats": []
},
{
"serialNum": 19,
"trainNum": "G4938",
"trainType": "GD",
"departStation": "长沙南",
"departStationEn": "changshanan",
"departStationNum": "199",
"departTime": "19:31",
"arrivalStation": "上海虹桥",
"arrivalStationEn": "shanghaihongqiao",
"arrivalStationNum": "321",
"arrivalTime": "00:45",
"stayStation": "上海虹桥",
"stayStationNum": "321",
"stayStationEn": "shanghaihongqiao",
"stayDepartTime": "00:45",
"stayArrivalTime": "00:45",
"miles": 0,
"prices": "",
"seats": [
]
}
]
}
}
经停站查询
接口地址:http://route.showapi.com/1651-4 (注意:接口支持https,更安全,但稍慢一些,你懂的。请根据自己的情况进行选择。)
支持格式:json
请求方法:HTTP协议,支持GET/POST方法。
二、请求参数/
Request parameter
非文件上传的POST时,enctype=application/x-www-form-urlencoded。
文件上传的POST时,enctype=multipart/form-data。
1、系统级参数(所有接入点都需要的参数):
参数名称 |
类型 |
示例值 |
必须 |
描述 |
showapi_appid |
String |
100 |
是 |
易源应用id |
showapi_sign |
String |
698d51a19d8a121ce581499d7b701668 |
是 |
为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。
可选,在url后带上appid和secret即可
|
showapi_timestamp |
String |
20141114142239 |
否 |
客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。
|
showapi_res_gzip |
String |
1或0 |
否 |
返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩。 |
... |
2、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表):
参数名称 |
类型 |
默认值 |
示例值 |
必须 |
描述 |
trainNum |
String |
|
|
是 |
|
date |
String |
|
|
是 |
|
请求示例:String res=new ShowApiRequest("http://route.showapi.com/1651-4","my_appId","my_appSecret")
.addTextPara("trainNum","G101")
.addTextPara("date","20180801")
.post();
System.out.println(res);
三、返回参数/
Return parameter
以JSON格式返回结果。
1、系统级参数(所有接入点都会返回的参数):
展开收起
名称 |
类型 |
示例值 |
描述 |
showapi_res_body |
String |
{"city":"昆明","prov":"云南"} |
消息体的JSON封装,所有应用级的返回参数将嵌入此对象 。 |
showapi_res_code |
int |
0 |
易源返回标志,0为成功,其他为失败。
0成功
-1,系统调用错误
-2,可调用次数或金额为0
-3,读取超时
-4,服务端返回数据解析错误
-5,后端服务器DNS解析错误
-6,服务不存在或未上线
-7, API创建者的网关资源不足
-1000,系统维护
-1002,showapi_appid字段必传
-1003,showapi_sign字段必传
-1004,签名sign验证有误
-1005,showapi_timestamp无效
-1006,app无权限调用接口
-1007,没有订购套餐
-1008,服务商关闭对您的调用权限
-1009,调用频率受限
-1010,找不到您的应用
-1011,子授权app_child_id无效
-1012,子授权已过期或失效
-1013,子授权ip受限
-1014,token权限无效
|
showapi_res_error |
String |
用户输入有误! |
错误信息的展示 |
showapi_res_id |
String |
ce135f6739294c63be0c021b76b6fbff |
本次请求id |
... |
2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构):
展开收起
名称 |
类型 |
示例值 |
描述 |
ret_code
|
String |
|
|
remark
|
String |
|
|
trainNum
|
String |
|
|
stations
|
Object[] |
|
|
-
stayTime
|
String |
|
|
-
arrivalTime
|
String |
|
|
-
departTime
|
String |
|
|
-
station
|
String |
|
|
-
serialNum
|
String |
|
|
... |
返回示例:{
"showapi_res_code": 0,
"showapi_res_error": "",
"showapi_res_body": {
"ret_code": "0",
"remark": "查询成功!",
"trainNum": "G101",
"stations": [
{
"serialNum": "1",
"station": "北京南",
"departTime": "06:43",
"arrivalTime": "06:43",
"stayTime": "----",
"miles": "0"
},
{
"serialNum": "2",
"station": "沧州西",
"departTime": "07:38",
"arrivalTime": "07:35",
"stayTime": "3",
"miles": "0"
},
........
{
"serialNum": "10",
"station": "苏州北",
"departTime": "12:15",
"arrivalTime": "12:13",
"stayTime": "2",
"miles": "0"
},
{
"serialNum": "11",
"station": "上海虹桥",
"departTime": "12:40",
"arrivalTime": "12:40",
"stayTime": "----",
"miles": "0"
}
]
}
}
余票查询
接口地址:http://route.showapi.com/1651-5 (注意:接口支持https,更安全,但稍慢一些,你懂的。请根据自己的情况进行选择。)
支持格式:json
请求方法:HTTP协议,支持GET/POST方法。
二、请求参数/
Request parameter
非文件上传的POST时,enctype=application/x-www-form-urlencoded。
文件上传的POST时,enctype=multipart/form-data。
1、系统级参数(所有接入点都需要的参数):
参数名称 |
类型 |
示例值 |
必须 |
描述 |
showapi_appid |
String |
100 |
是 |
易源应用id |
showapi_sign |
String |
698d51a19d8a121ce581499d7b701668 |
是 |
为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。
可选,在url后带上appid和secret即可
|
showapi_timestamp |
String |
20141114142239 |
否 |
客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。
|
showapi_res_gzip |
String |
1或0 |
否 |
返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩。 |
... |
2、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表):
展开收起
参数名称 |
类型 |
默认值 |
示例值 |
必须 |
描述 |
trainNum |
String |
|
|
是 |
|
seatType |
String |
|
|
是 |
|
departStation |
String |
|
|
是 |
|
arrivalStation |
String |
|
|
是 |
|
date |
String |
|
|
是 |
|
uniqueKey |
String |
|
d1be6fb91ecfc8878bd07604bab9bf61
|
否 |
唯一标识(需最新的,否则获取余票数量会不准或失败)
|
... |
请求示例:String res=new ShowApiRequest("http://route.showapi.com/1651-5","my_appId","my_appSecret")
.addTextPara("trainNum","G101")
.addTextPara("seatType","1")
.addTextPara("departStation","beijingnan")
.addTextPara("arrivalStation","shanghaihongqiao")
.addTextPara("date","20180801")
.addTextPara("uniqueKey","d1be6fb91ecfc8878bd07604bab9bf61")
.post();
System.out.println(res);
三、返回参数/
Return parameter
以JSON格式返回结果。
1、系统级参数(所有接入点都会返回的参数):
展开收起
名称 |
类型 |
示例值 |
描述 |
showapi_res_body |
String |
{"city":"昆明","prov":"云南"} |
消息体的JSON封装,所有应用级的返回参数将嵌入此对象 。 |
showapi_res_code |
int |
0 |
易源返回标志,0为成功,其他为失败。
0成功
-1,系统调用错误
-2,可调用次数或金额为0
-3,读取超时
-4,服务端返回数据解析错误
-5,后端服务器DNS解析错误
-6,服务不存在或未上线
-7, API创建者的网关资源不足
-1000,系统维护
-1002,showapi_appid字段必传
-1003,showapi_sign字段必传
-1004,签名sign验证有误
-1005,showapi_timestamp无效
-1006,app无权限调用接口
-1007,没有订购套餐
-1008,服务商关闭对您的调用权限
-1009,调用频率受限
-1010,找不到您的应用
-1011,子授权app_child_id无效
-1012,子授权已过期或失效
-1013,子授权ip受限
-1014,token权限无效
|
showapi_res_error |
String |
用户输入有误! |
错误信息的展示 |
showapi_res_id |
String |
ce135f6739294c63be0c021b76b6fbff |
本次请求id |
... |
2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构):
展开收起
名称 |
类型 |
示例值 |
描述 |
ret_code
|
String |
|
|
remark
|
String |
|
|
standbyTickets
|
String |
|
|
... |
返回示例:{
"showapi_res_code": 0,
"showapi_res_error": "",
"showapi_res_body": {
"ret_code": "0",
"remark": "查询成功!",
"standbyTickets": "21"
}
}
车站列表查询
接口地址:http://route.showapi.com/1651-6 (注意:接口支持https,更安全,但稍慢一些,你懂的。请根据自己的情况进行选择。)
支持格式:json
请求方法:HTTP协议,支持GET/POST方法。
二、请求参数/
Request parameter
非文件上传的POST时,enctype=application/x-www-form-urlencoded。
文件上传的POST时,enctype=multipart/form-data。
1、系统级参数(所有接入点都需要的参数):
参数名称 |
类型 |
示例值 |
必须 |
描述 |
showapi_appid |
String |
100 |
是 |
易源应用id |
showapi_sign |
String |
698d51a19d8a121ce581499d7b701668 |
是 |
为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。
可选,在url后带上appid和secret即可
|
showapi_timestamp |
String |
20141114142239 |
否 |
客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。
|
showapi_res_gzip |
String |
1或0 |
否 |
返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩。 |
... |
2、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表):
参数名称 |
类型 |
默认值 |
示例值 |
必须 |
描述 |
page |
String |
|
|
否 |
|
maxResult |
String |
|
|
否 |
每页显示的条数,必需为整数(默认20,不能超过100) 100
|
请求示例:String res=new ShowApiRequest("http://route.showapi.com/1651-6","my_appId","my_appSecret")
.addTextPara("page","1")
.addTextPara("maxResult","20")
.post();
System.out.println(res);
三、返回参数/
Return parameter
以JSON格式返回结果。
1、系统级参数(所有接入点都会返回的参数):
展开收起
名称 |
类型 |
示例值 |
描述 |
showapi_res_body |
String |
{"city":"昆明","prov":"云南"} |
消息体的JSON封装,所有应用级的返回参数将嵌入此对象 。 |
showapi_res_code |
int |
0 |
易源返回标志,0为成功,其他为失败。
0成功
-1,系统调用错误
-2,可调用次数或金额为0
-3,读取超时
-4,服务端返回数据解析错误
-5,后端服务器DNS解析错误
-6,服务不存在或未上线
-7, API创建者的网关资源不足
-1000,系统维护
-1002,showapi_appid字段必传
-1003,showapi_sign字段必传
-1004,签名sign验证有误
-1005,showapi_timestamp无效
-1006,app无权限调用接口
-1007,没有订购套餐
-1008,服务商关闭对您的调用权限
-1009,调用频率受限
-1010,找不到您的应用
-1011,子授权app_child_id无效
-1012,子授权已过期或失效
-1013,子授权ip受限
-1014,token权限无效
|
showapi_res_error |
String |
用户输入有误! |
错误信息的展示 |
showapi_res_id |
String |
ce135f6739294c63be0c021b76b6fbff |
本次请求id |
... |
2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构):
展开收起
名称 |
类型 |
示例值 |
描述 |
ret_code
|
String |
|
|
remark
|
String |
|
|
page
|
String |
|
|
maxResult
|
String |
|
|
totalCount
|
String |
|
|
stationInfos
|
Object[] |
|
|
-
hot
|
String |
|
|
-
priority
|
String |
|
|
-
stationEn
|
String |
|
|
-
cityName
|
String |
|
|
-
match
|
String |
|
|
... |
返回示例:{
"showapi_res_code": 0,
"showapi_res_error": "",
"showapi_res_body": {
"ret_code": "0",
"remark": "查询成功!",
"page": 1,
"maxResult": 20,
"totalCount": 2750,
"stations": [
{
"station": "阿图什",
"hot": 98793,
"priority": 1,
"stationEn": "atushi",
"cityName": "克孜勒苏柯尔克孜自治州",
"match": "ats|atushi"
},
{
"station": "阿尔山",
"hot": 119832,
"priority": 10,
"stationEn": "aershan",
"cityName": "兴安盟",
"match": "aes|aershan"
},
{
"station": "阿勒泰",
"hot": 163554,
"priority": 1,
"stationEn": "aletai",
"cityName": "伊犁哈萨克自治州",
"match": "aletai|alt"
},
{
"station": "阿龙山",
"hot": 6544,
"priority": 1,
"stationEn": "alongshan",
"cityName": "呼伦贝尔",
"match": "als|alongshan"
},
{
"station": "阿克陶",
"hot": 38044,
"priority": 1,
"stationEn": "aketao",
"cityName": "克孜勒苏柯尔克孜自治州",
"match": "akt|aketao"
},
{
"station": "艾河",
"hot": 4093,
"priority": 1,
"stationEn": "aihe",
"cityName": "保定",
"match": "ahe|aihe"
},
{
"station": "阿南庄",
"hot": 2478,
"priority": 1,
"stationEn": "ananzhuang",
"cityName": "楚雄彝族自治州",
"match": "anz|ananzhuang"
},
{
"station": "阿里河",
"hot": 34943,
"priority": 1,
"stationEn": "alihe",
"cityName": "呼伦贝尔",
"match": "alh|alihe"
},
{
"station": "安德",
"hot": 20327,
"priority": 0,
"stationEn": "ande",
"cityName": "成都",
"match": "ad|ande"
},
{
"station": "阿拉山口",
"hot": 25034,
"priority": 1,
"stationEn": "alashankou",
"cityName": "博乐",
"match": "alsk|alashankou"
},
{
"station": "阿城",
"hot": 313625,
"priority": 1,
"stationEn": "acheng",
"cityName": "哈尔滨",
"match": "ach|acheng"
},
{
"station": "阿克苏",
"hot": 1780647,
"priority": 10,
"stationEn": "akesu",
"cityName": "阿克苏",
"match": "aks|akesu"
},
{
"station": "艾家村",
"hot": 2718,
"priority": 1,
"stationEn": "aijiacun",
"cityName": "吴忠",
"match": "ajc|aijiacun"
},
{
"station": "阿木尔",
"hot": 16485,
"priority": 1,
"stationEn": "amuer",
"cityName": "大兴安岭",
"match": "ame|amuer"
},
{
"station": "阿巴嘎旗",
"hot": 6122,
"priority": 0,
"stationEn": "abagaqi",
"cityName": "锡林郭勒盟",
"match": "abgq|abagaqi"
},
{
"station": "安达",
"hot": 875039,
"priority": 1,
"stationEn": "anda",
"cityName": "绥化",
"match": "ad|anda"
},
{
"station": "阿房宫",
"hot": 178660,
"priority": 0,
"stationEn": "epanggong",
"cityName": "西安",
"match": "epg|epanggong"
},
{
"station": "阿尔山北",
"hot": 10283,
"priority": 0,
"stationEn": "aershanbei",
"cityName": "兴安盟",
"match": "aesb|aershanbei"
},
{
"station": "安定",
"hot": 559,
"priority": 1,
"stationEn": "anding",
"cityName": "定西",
"match": "adi|anding"
},
{
"station": "阿金",
"hot": 46876,
"priority": 1,
"stationEn": "ajin",
"cityName": "阜新",
"match": "aj|ajin"
}
]
}
}
学校查询
接口地址:http://route.showapi.com/1651-7 (注意:接口支持https,更安全,但稍慢一些,你懂的。请根据自己的情况进行选择。)
支持格式:json
请求方法:HTTP协议,支持GET/POST方法。
二、请求参数/
Request parameter
非文件上传的POST时,enctype=application/x-www-form-urlencoded。
文件上传的POST时,enctype=multipart/form-data。
1、系统级参数(所有接入点都需要的参数):
参数名称 |
类型 |
示例值 |
必须 |
描述 |
showapi_appid |
String |
100 |
是 |
易源应用id |
showapi_sign |
String |
698d51a19d8a121ce581499d7b701668 |
是 |
为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。
可选,在url后带上appid和secret即可
|
showapi_timestamp |
String |
20141114142239 |
否 |
客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。
|
showapi_res_gzip |
String |
1或0 |
否 |
返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩。 |
... |
2、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表):
请求示例:String res=new ShowApiRequest("http://route.showapi.com/1651-7","my_appId","my_appSecret")
.post();
System.out.println(res);
三、返回参数/
Return parameter
以JSON格式返回结果。
1、系统级参数(所有接入点都会返回的参数):
展开收起
名称 |
类型 |
示例值 |
描述 |
showapi_res_body |
String |
{"city":"昆明","prov":"云南"} |
消息体的JSON封装,所有应用级的返回参数将嵌入此对象 。 |
showapi_res_code |
int |
0 |
易源返回标志,0为成功,其他为失败。
0成功
-1,系统调用错误
-2,可调用次数或金额为0
-3,读取超时
-4,服务端返回数据解析错误
-5,后端服务器DNS解析错误
-6,服务不存在或未上线
-7, API创建者的网关资源不足
-1000,系统维护
-1002,showapi_appid字段必传
-1003,showapi_sign字段必传
-1004,签名sign验证有误
-1005,showapi_timestamp无效
-1006,app无权限调用接口
-1007,没有订购套餐
-1008,服务商关闭对您的调用权限
-1009,调用频率受限
-1010,找不到您的应用
-1011,子授权app_child_id无效
-1012,子授权已过期或失效
-1013,子授权ip受限
-1014,token权限无效
|
showapi_res_error |
String |
用户输入有误! |
错误信息的展示 |
showapi_res_id |
String |
ce135f6739294c63be0c021b76b6fbff |
本次请求id |
... |
2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构):
展开收起
名称 |
类型 |
示例值 |
描述 |
schoolName
|
String |
|
|
schoolCode
|
String |
|
|
ret_code
|
String |
|
|
remark
|
String |
|
|
... |
返回示例:{
"showapi_res_code": 0,
"showapi_res_error": "",
"showapi_res_body": {
"ret_code": "0",
"schools": [
{
"schoolCode": "10001",
"schoolName": "北京大学"
},
{
"schoolCode": "10002",
"schoolName": "中国人民大学"
},
{
"schoolCode": "10003",
"schoolName": "清华大学"
}......
]
}
}
优惠区间城市查询
接口地址:http://route.showapi.com/1651-8 (注意:接口支持https,更安全,但稍慢一些,你懂的。请根据自己的情况进行选择。)
支持格式:json
请求方法:HTTP协议,支持GET/POST方法。
二、请求参数/
Request parameter
非文件上传的POST时,enctype=application/x-www-form-urlencoded。
文件上传的POST时,enctype=multipart/form-data。
1、系统级参数(所有接入点都需要的参数):
参数名称 |
类型 |
示例值 |
必须 |
描述 |
showapi_appid |
String |
100 |
是 |
易源应用id |
showapi_sign |
String |
698d51a19d8a121ce581499d7b701668 |
是 |
为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。
可选,在url后带上appid和secret即可
|
showapi_timestamp |
String |
20141114142239 |
否 |
客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。
|
showapi_res_gzip |
String |
1或0 |
否 |
返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩。 |
... |
2、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表):
请求示例:String res=new ShowApiRequest("http://route.showapi.com/1651-8","my_appId","my_appSecret")
.post();
System.out.println(res);
三、返回参数/
Return parameter
以JSON格式返回结果。
1、系统级参数(所有接入点都会返回的参数):
展开收起
名称 |
类型 |
示例值 |
描述 |
showapi_res_body |
String |
{"city":"昆明","prov":"云南"} |
消息体的JSON封装,所有应用级的返回参数将嵌入此对象 。 |
showapi_res_code |
int |
0 |
易源返回标志,0为成功,其他为失败。
0成功
-1,系统调用错误
-2,可调用次数或金额为0
-3,读取超时
-4,服务端返回数据解析错误
-5,后端服务器DNS解析错误
-6,服务不存在或未上线
-7, API创建者的网关资源不足
-1000,系统维护
-1002,showapi_appid字段必传
-1003,showapi_sign字段必传
-1004,签名sign验证有误
-1005,showapi_timestamp无效
-1006,app无权限调用接口
-1007,没有订购套餐
-1008,服务商关闭对您的调用权限
-1009,调用频率受限
-1010,找不到您的应用
-1011,子授权app_child_id无效
-1012,子授权已过期或失效
-1013,子授权ip受限
-1014,token权限无效
|
showapi_res_error |
String |
用户输入有误! |
错误信息的展示 |
showapi_res_id |
String |
ce135f6739294c63be0c021b76b6fbff |
本次请求id |
... |
2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构):
展开收起
名称 |
类型 |
示例值 |
描述 |
cityCode
|
String |
|
|
cityName
|
String |
|
|
ret_code
|
String |
|
|
remark
|
String |
|
|
... |
返回示例:{
"showapi_res_code": 0,
"showapi_res_error": "",
"showapi_res_body": {
"ret_code": "0",
"remark": "查询成功!",
"citys": [
{
"cityCode": "34",
"cityName": "哈尔滨"
},
{
"cityCode": "110",
"cityName": "长春"
},
{
"cityCode": "205",
"cityName": "沈阳"
},
{
"cityCode": "357",
"cityName": "北京"
}
......
]
}
}
火车票预售期查询
接口地址:http://route.showapi.com/1651-10 (注意:接口支持https,更安全,但稍慢一些,你懂的。请根据自己的情况进行选择。)
支持格式:json
请求方法:HTTP协议,支持GET/POST方法。
二、请求参数/
Request parameter
非文件上传的POST时,enctype=application/x-www-form-urlencoded。
文件上传的POST时,enctype=multipart/form-data。
1、系统级参数(所有接入点都需要的参数):
参数名称 |
类型 |
示例值 |
必须 |
描述 |
showapi_appid |
String |
100 |
是 |
易源应用id |
showapi_sign |
String |
698d51a19d8a121ce581499d7b701668 |
是 |
为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。
可选,在url后带上appid和secret即可
|
showapi_timestamp |
String |
20141114142239 |
否 |
客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。
|
showapi_res_gzip |
String |
1或0 |
否 |
返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩。 |
... |
2、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表):
请求示例:String res=new ShowApiRequest("http://route.showapi.com/1651-10","my_appId","my_appSecret")
.post();
System.out.println(res);
三、返回参数/
Return parameter
以JSON格式返回结果。
1、系统级参数(所有接入点都会返回的参数):
展开收起
名称 |
类型 |
示例值 |
描述 |
showapi_res_body |
String |
{"city":"昆明","prov":"云南"} |
消息体的JSON封装,所有应用级的返回参数将嵌入此对象 。 |
showapi_res_code |
int |
0 |
易源返回标志,0为成功,其他为失败。
0成功
-1,系统调用错误
-2,可调用次数或金额为0
-3,读取超时
-4,服务端返回数据解析错误
-5,后端服务器DNS解析错误
-6,服务不存在或未上线
-7, API创建者的网关资源不足
-1000,系统维护
-1002,showapi_appid字段必传
-1003,showapi_sign字段必传
-1004,签名sign验证有误
-1005,showapi_timestamp无效
-1006,app无权限调用接口
-1007,没有订购套餐
-1008,服务商关闭对您的调用权限
-1009,调用频率受限
-1010,找不到您的应用
-1011,子授权app_child_id无效
-1012,子授权已过期或失效
-1013,子授权ip受限
-1014,token权限无效
|
showapi_res_error |
String |
用户输入有误! |
错误信息的展示 |
showapi_res_id |
String |
ce135f6739294c63be0c021b76b6fbff |
本次请求id |
... |
2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构):
展开收起
名称 |
类型 |
示例值 |
描述 |
ret_code
|
String |
|
|
remark
|
String |
|
|
saleDays
|
String |
|
|
... |
返回示例:{
"showapi_res_code": 0,
"showapi_res_error": "",
"showapi_res_body": {
"ret_code": "0",
"remark": "查询成功!",
"saleDays": "30"
}
}
区间票查询
接口地址:http://route.showapi.com/1651-13 (注意:接口支持https,更安全,但稍慢一些,你懂的。请根据自己的情况进行选择。)
支持格式:json
请求方法:HTTP协议,支持GET/POST方法。
二、请求参数/
Request parameter
非文件上传的POST时,enctype=application/x-www-form-urlencoded。
文件上传的POST时,enctype=multipart/form-data。
1、系统级参数(所有接入点都需要的参数):
参数名称 |
类型 |
示例值 |
必须 |
描述 |
showapi_appid |
String |
100 |
是 |
易源应用id |
showapi_sign |
String |
698d51a19d8a121ce581499d7b701668 |
是 |
为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。
可选,在url后带上appid和secret即可
|
showapi_timestamp |
String |
20141114142239 |
否 |
客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。
|
showapi_res_gzip |
String |
1或0 |
否 |
返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩。 |
... |
2、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表):
展开收起
参数名称 |
类型 |
默认值 |
示例值 |
必须 |
描述 |
trainNum |
String |
|
|
是 |
|
departStation |
String |
|
|
是 |
|
arrivalStation |
String |
|
|
是 |
|
date |
String |
|
|
是 |
|
... |
请求示例:String res=new ShowApiRequest("http://route.showapi.com/1651-13","my_appId","my_appSecret")
.addTextPara("trainNum","G101")
.addTextPara("departStation","北京南")
.addTextPara("arrivalStation","上海虹桥")
.addTextPara("date","")
.post();
System.out.println(res);
三、返回参数/
Return parameter
以JSON格式返回结果。
1、系统级参数(所有接入点都会返回的参数):
展开收起
名称 |
类型 |
示例值 |
描述 |
showapi_res_body |
String |
{"city":"昆明","prov":"云南"} |
消息体的JSON封装,所有应用级的返回参数将嵌入此对象 。 |
showapi_res_code |
int |
0 |
易源返回标志,0为成功,其他为失败。
0成功
-1,系统调用错误
-2,可调用次数或金额为0
-3,读取超时
-4,服务端返回数据解析错误
-5,后端服务器DNS解析错误
-6,服务不存在或未上线
-7, API创建者的网关资源不足
-1000,系统维护
-1002,showapi_appid字段必传
-1003,showapi_sign字段必传
-1004,签名sign验证有误
-1005,showapi_timestamp无效
-1006,app无权限调用接口
-1007,没有订购套餐
-1008,服务商关闭对您的调用权限
-1009,调用频率受限
-1010,找不到您的应用
-1011,子授权app_child_id无效
-1012,子授权已过期或失效
-1013,子授权ip受限
-1014,token权限无效
|
showapi_res_error |
String |
用户输入有误! |
错误信息的展示 |
showapi_res_id |
String |
ce135f6739294c63be0c021b76b6fbff |
本次请求id |
... |
2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构):
展开收起
名称 |
类型 |
示例值 |
描述 |
ret_code
|
String |
|
|
remark
|
String |
|
|
ticketStatus
|
String |
|
|
msg
|
String |
|
|
departStation
|
String |
|
|
arrivalStation
|
String |
|
|
departStationEn
|
String |
|
|
arrivalStationEn
|
String |
|
|
date
|
String |
|
|
trains
|
Object[] |
|
|
-
trainNum
|
String |
|
|
-
departTime
|
String |
|
|
-
arrivalTime
|
String |
|
|
-
beginPlace
|
String |
|
|
-
endPlace
|
String |
|
|
-
departPlace
|
String |
|
|
-
departPlaceEn
|
String |
|
|
-
arrivalPlace
|
String |
|
|
-
arrivalPlaceEn
|
String |
|
|
-
runTime
|
String |
|
|
-
ticketStates
|
Object[] |
|
|
-
seatType
|
String |
|
|
-
seatName
|
String |
|
|
-
seatPrice
|
String |
|
|
-
seatState
|
String |
|
|
-
seats
|
String |
|
|
-
cannotOrder
|
String |
|
是否可以预定 0:票量少,不支持预定 1:可以预定 2:不在预定时间内 3:学生票不可预定
|
-
upperPrice
|
String |
|
|
-
middlePrice
|
String |
|
|
-
lowerPrice
|
String |
|
|
departs
|
String |
|
|
arrivals
|
String |
|
|
... |
返回示例:{
"showapi_res_code": 0,
"showapi_res_error": "",
"showapi_res_body": {
"ret_code": "0",
"remark": "查询成功!",
"ticketStatus": true,
"msg": "success",
"departPlace": "北京南",
"arrivalPlace": "上海虹桥",
"departPlaceEn": "beijingnan",
"arrivalPlaceEn": "shanghaihongqiao",
"date": "20180801",
"trains": [
{
"trainNum": "G101",
"departTime": "06:43",
"arrivalTime": "12:40",
"beginPlace": "北京南",
"endPlace": "上海虹桥",
"departPlace": "北京南",
"departPlaceEn": "beijingnan",
"arrivalPlace": "上海虹桥",
"arrivalPlaceEn": "shanghaihongqiao",
"runTime": "5小时57分钟",
"ticketStates": [
{
"seatType": "11",
"seatName": "商务座",
"seatPrice": 1748.0,
"seatState": 1,
"seats": "21",
"cannotOrder": "1",
"upperPrice": 0.0,
"middlePrice": 0.0,
"lowerPrice": 0.0
},
{
"seatType": "4",
"seatName": "二等座",
"seatPrice": 553.0,
"seatState": 1,
"seats": "21",
"cannotOrder": "1",
"upperPrice": 0.0,
"middlePrice": 0.0,
"lowerPrice": 0.0
},
{
"seatType": "3",
"seatName": "一等座",
"seatPrice": 933.0,
"seatState": 1,
"seats": "21",
"cannotOrder": "1",
"upperPrice": 0.0,
"middlePrice": 0.0,
"lowerPrice": 0.0
}
]
}
],
"departs": ["北京南"],
"arrivals": ["上海虹桥"]
}
}
获取复兴号标识
接口地址:http://route.showapi.com/1651-55 (注意:接口支持https,更安全,但稍慢一些,你懂的。请根据自己的情况进行选择。)
支持格式:json
请求方法:HTTP协议,支持GET/POST方法。
二、请求参数/
Request parameter
非文件上传的POST时,enctype=application/x-www-form-urlencoded。
文件上传的POST时,enctype=multipart/form-data。
1、系统级参数(所有接入点都需要的参数):
参数名称 |
类型 |
示例值 |
必须 |
描述 |
showapi_appid |
String |
100 |
是 |
易源应用id |
showapi_sign |
String |
698d51a19d8a121ce581499d7b701668 |
是 |
为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。
可选,在url后带上appid和secret即可
|
showapi_timestamp |
String |
20141114142239 |
否 |
客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。
|
showapi_res_gzip |
String |
1或0 |
否 |
返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩。 |
... |
2、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表):
展开收起
参数名称 |
类型 |
默认值 |
示例值 |
必须 |
描述 |
departStation |
String |
|
|
是 |
|
arrivalStation |
String |
|
|
是 |
|
date |
String |
|
|
是 |
|
trainNum |
String |
|
|
是 |
|
... |
请求示例:String res=new ShowApiRequest("http://route.showapi.com/1651-55","my_appId","my_appSecret")
.addTextPara("departStation","上海")
.addTextPara("arrivalStation","北京")
.addTextPara("date","20191018")
.addTextPara("trainNum","G102")
.post();
System.out.println(res);
三、返回参数/
Return parameter
以JSON格式返回结果。
1、系统级参数(所有接入点都会返回的参数):
展开收起
名称 |
类型 |
示例值 |
描述 |
showapi_res_body |
String |
{"city":"昆明","prov":"云南"} |
消息体的JSON封装,所有应用级的返回参数将嵌入此对象 。 |
showapi_res_code |
int |
0 |
易源返回标志,0为成功,其他为失败。
0成功
-1,系统调用错误
-2,可调用次数或金额为0
-3,读取超时
-4,服务端返回数据解析错误
-5,后端服务器DNS解析错误
-6,服务不存在或未上线
-7, API创建者的网关资源不足
-1000,系统维护
-1002,showapi_appid字段必传
-1003,showapi_sign字段必传
-1004,签名sign验证有误
-1005,showapi_timestamp无效
-1006,app无权限调用接口
-1007,没有订购套餐
-1008,服务商关闭对您的调用权限
-1009,调用频率受限
-1010,找不到您的应用
-1011,子授权app_child_id无效
-1012,子授权已过期或失效
-1013,子授权ip受限
-1014,token权限无效
|
showapi_res_error |
String |
用户输入有误! |
错误信息的展示 |
showapi_res_id |
String |
ce135f6739294c63be0c021b76b6fbff |
本次请求id |
... |
2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构):
展开收起
名称 |
类型 |
示例值 |
描述 |
revivals
|
Object[] |
|
|
-
0
|
Object |
|
|
-
seatInfo
|
String |
|
|
-
capacity
|
Number |
|
|
-
carriageNo
|
String |
|
|
ret_code
|
String |
|
|
remark
|
String |
|
|
isWifi
|
String |
|
是否有wifi,0没有 1有。有wifi可以认为是复兴号
|
... |
返回示例:{
"showapi_res_error": "",
"showapi_res_id": "db01c46d0a8f4d38bfb4ac2652f235a2",
"showapi_res_code": 0,
"showapi_res_body": {
"revivals": [
{
"seatInfo": "商务座",
"capacity": 17,
"carriageNo": "1"
}
],
"ret_code": "0",
"remark": "查询成功!",
"isWifi": "1"
}
}
正晚点明细查询
接口地址:http://route.showapi.com/1651-56 (注意:接口支持https,更安全,但稍慢一些,你懂的。请根据自己的情况进行选择。)
支持格式:json
请求方法:HTTP协议,支持GET/POST方法。
二、请求参数/
Request parameter
非文件上传的POST时,enctype=application/x-www-form-urlencoded。
文件上传的POST时,enctype=multipart/form-data。
1、系统级参数(所有接入点都需要的参数):
参数名称 |
类型 |
示例值 |
必须 |
描述 |
showapi_appid |
String |
100 |
是 |
易源应用id |
showapi_sign |
String |
698d51a19d8a121ce581499d7b701668 |
是 |
为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。
可选,在url后带上appid和secret即可
|
showapi_timestamp |
String |
20141114142239 |
否 |
客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。
|
showapi_res_gzip |
String |
1或0 |
否 |
返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩。 |
... |
2、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表):
展开收起
参数名称 |
类型 |
默认值 |
示例值 |
必须 |
描述 |
stationName |
String |
|
|
是 |
|
trainNum |
String |
|
|
是 |
|
stationType |
String |
|
|
否 |
|
... |
请求示例:String res=new ShowApiRequest("http://route.showapi.com/1651-56","my_appId","my_appSecret")
.addTextPara("stationName","北京南")
.addTextPara("trainNum","G102")
.addTextPara("stationType","")
.post();
System.out.println(res);
三、返回参数/
Return parameter
以JSON格式返回结果。
1、系统级参数(所有接入点都会返回的参数):
展开收起
名称 |
类型 |
示例值 |
描述 |
showapi_res_body |
String |
{"city":"昆明","prov":"云南"} |
消息体的JSON封装,所有应用级的返回参数将嵌入此对象 。 |
showapi_res_code |
int |
0 |
易源返回标志,0为成功,其他为失败。
0成功
-1,系统调用错误
-2,可调用次数或金额为0
-3,读取超时
-4,服务端返回数据解析错误
-5,后端服务器DNS解析错误
-6,服务不存在或未上线
-7, API创建者的网关资源不足
-1000,系统维护
-1002,showapi_appid字段必传
-1003,showapi_sign字段必传
-1004,签名sign验证有误
-1005,showapi_timestamp无效
-1006,app无权限调用接口
-1007,没有订购套餐
-1008,服务商关闭对您的调用权限
-1009,调用频率受限
-1010,找不到您的应用
-1011,子授权app_child_id无效
-1012,子授权已过期或失效
-1013,子授权ip受限
-1014,token权限无效
|
showapi_res_error |
String |
用户输入有误! |
错误信息的展示 |
showapi_res_id |
String |
ce135f6739294c63be0c021b76b6fbff |
本次请求id |
... |
2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构):
展开收起
返回示例:
获取中转换乘方案
接口地址:http://route.showapi.com/1651-57 (注意:接口支持https,更安全,但稍慢一些,你懂的。请根据自己的情况进行选择。)
支持格式:json
请求方法:HTTP协议,支持GET/POST方法。
二、请求参数/
Request parameter
非文件上传的POST时,enctype=application/x-www-form-urlencoded。
文件上传的POST时,enctype=multipart/form-data。
1、系统级参数(所有接入点都需要的参数):
参数名称 |
类型 |
示例值 |
必须 |
描述 |
showapi_appid |
String |
100 |
是 |
易源应用id |
showapi_sign |
String |
698d51a19d8a121ce581499d7b701668 |
是 |
为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。
可选,在url后带上appid和secret即可
|
showapi_timestamp |
String |
20141114142239 |
否 |
客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。
|
showapi_res_gzip |
String |
1或0 |
否 |
返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩。 |
... |
2、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表):
展开收起
参数名称 |
类型 |
默认值 |
示例值 |
必须 |
描述 |
departStation |
String |
|
|
是 |
|
arrivalStation |
String |
|
|
是 |
|
date |
String |
|
|
是 |
|
count |
String |
|
|
否 |
查询个数,目前最多为50个。(不传默认为最大值。最大值随时可能调整)
|
... |
请求示例:String res=new ShowApiRequest("http://route.showapi.com/1651-57","my_appId","my_appSecret")
.addTextPara("departStation","北京")
.addTextPara("arrivalStation","成都")
.addTextPara("date","20191015")
.addTextPara("count","")
.post();
System.out.println(res);
三、返回参数/
Return parameter
以JSON格式返回结果。
1、系统级参数(所有接入点都会返回的参数):
展开收起
名称 |
类型 |
示例值 |
描述 |
showapi_res_body |
String |
{"city":"昆明","prov":"云南"} |
消息体的JSON封装,所有应用级的返回参数将嵌入此对象 。 |
showapi_res_code |
int |
0 |
易源返回标志,0为成功,其他为失败。
0成功
-1,系统调用错误
-2,可调用次数或金额为0
-3,读取超时
-4,服务端返回数据解析错误
-5,后端服务器DNS解析错误
-6,服务不存在或未上线
-7, API创建者的网关资源不足
-1000,系统维护
-1002,showapi_appid字段必传
-1003,showapi_sign字段必传
-1004,签名sign验证有误
-1005,showapi_timestamp无效
-1006,app无权限调用接口
-1007,没有订购套餐
-1008,服务商关闭对您的调用权限
-1009,调用频率受限
-1010,找不到您的应用
-1011,子授权app_child_id无效
-1012,子授权已过期或失效
-1013,子授权ip受限
-1014,token权限无效
|
showapi_res_error |
String |
用户输入有误! |
错误信息的展示 |
showapi_res_id |
String |
ce135f6739294c63be0c021b76b6fbff |
本次请求id |
... |
2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构):
展开收起
名称 |
类型 |
示例值 |
描述 |
datas
|
Object[] |
|
|
-
0
|
Object |
|
|
-
arrivalStation
|
String |
|
|
-
departStation
|
String |
|
|
-
waitTime
|
Number |
|
|
-
arrivalPlace
|
String |
|
|
-
departPlace
|
String |
|
|
-
departTime
|
String |
|
|
-
transferPlace
|
String |
|
|
-
transferInfos
|
Object[] |
|
|
-
0
|
Object |
|
|
-
arrivalStation
|
String |
|
|
-
departStation
|
String |
|
|
-
trainNum
|
String |
|
|
-
arrivalTime
|
String |
|
|
-
trainState
|
String |
|
|
-
departTime
|
String |
|
|
-
runTime
|
String |
|
|
-
trainType
|
String |
|
|
-
date
|
String |
|
|
-
tickets
|
Object |
|
车票信息(包含的对象里key之为座位类型英文,可在帮助文档对应)
|
-
businessseat
|
Object |
|
|
-
price
|
String |
|
|
-
seatState
|
String |
|
|
-
seats
|
Number |
|
|
-
seatName
|
String |
|
|
-
totalTime
|
Number |
|
|
-
totalPrice
|
Number |
|
|
ret_code
|
String |
|
|
remark
|
String |
|
|
... |
返回示例:{
"showapi_res_error": "",
"showapi_res_id": "ac0fce33a1ff401dab378dfa6c9546db",
"showapi_res_code": 0,
"showapi_res_body": {
"datas": [
{
"arrivalStation": "成都东",
"departStation": "北京西",
"waitTime": 32,
"arrivalPlace": "成都市",
"departPlace": "北京市",
"departTime": "06:27",
"transferPlace": "西安市",
"transferInfos": [
{
"arrivalStation": "西安北",
"departStation": "北京西",
"trainNum": "G437",
"arrivalTime": "11:03",
"trainState": "1",
"departTime": "06:27",
"runTime": "276",
"trainType": "GD",
"date": "20191015",
"tickets": {
"businessseat": {
"price": "1627.5",
"seatState": "1",
"seats": 2,
"seatName": "商务座"
},
"secondseat": {
"price": "515.5",
"seatState": "1",
"seats": 21,
"seatName": "二等座"
},
"firstseat": {
"price": "824.5",
"seatState": "0",
"seats": 0,
"seatName": "一等座"
}
}
}
],
"totalTime": 664,
"totalPrice": 811
}
],
"ret_code": "0",
"remark": "查询成功!"
}
}
创建火车票订单
接口地址:http://route.showapi.com/1651-28 (注意:接口支持https,更安全,但稍慢一些,你懂的。请根据自己的情况进行选择。)
支持格式:json
请求方法:HTTP协议,支持GET/POST方法。
二、请求参数/
Request parameter
非文件上传的POST时,enctype=application/x-www-form-urlencoded。
文件上传的POST时,enctype=multipart/form-data。
1、系统级参数(所有接入点都需要的参数):
参数名称 |
类型 |
示例值 |
必须 |
描述 |
showapi_appid |
String |
100 |
是 |
易源应用id |
showapi_sign |
String |
698d51a19d8a121ce581499d7b701668 |
是 |
为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。
可选,在url后带上appid和secret即可
|
showapi_timestamp |
String |
20141114142239 |
否 |
客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。
|
showapi_res_gzip |
String |
1或0 |
否 |
返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩。 |
... |
2、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表):
展开收起
参数名称 |
类型 |
默认值 |
示例值 |
必须 |
描述 |
uniqueKey |
String |
|
|
是 |
|
trainNum |
String |
|
|
是 |
|
departStation |
String |
|
|
是 |
|
arrivalStation |
String |
|
|
是 |
|
mobile |
String |
|
|
是 |
|
name |
String |
|
|
是 |
|
email |
String |
|
|
否 |
|
ticketType |
String |
|
|
否 |
购票模式 0:代购模式 1:自购模式 (暂不支持自购)
|
noSeat |
String |
|
|
是 |
|
adultName |
String |
|
|
是 |
|
adultIdType |
String |
|
|
是 |
证件类型(成人)1:身份证,2:护照,3:台胞证,4:港澳通行证(必填)
|
adultIdCard |
String |
|
|
是 |
|
adultBirthday |
String |
|
|
是 |
|
adultGender |
String |
|
|
是 |
|
adultSeatType |
String |
|
|
是 |
|
adultTicketPrice |
String |
|
|
是 |
|
childBirthday |
String |
|
|
否 |
|
childGender |
String |
|
|
否 |
|
childSeatType |
String |
|
|
否 |
|
childTicketPrice |
String |
|
|
否 |
|
provinceCode |
String |
|
|
否 |
|
schoolCode |
String |
|
|
否 |
|
studentNum |
String |
|
|
否 |
|
eductionalSystem |
String |
|
|
否 |
|
enrollmentYear |
String |
|
|
否 |
|
preferentialDepartStationCode |
String |
|
|
否 |
|
preferentialArrivalStationCode |
String |
|
|
否 |
|
chooseSeats |
String |
|
|
否 |
|
... |
请求示例:String res=new ShowApiRequest("http://route.showapi.com/1651-28","my_appId","my_appSecret")
.addTextPara("uniqueKey","")
.addTextPara("trainNum","")
.addTextPara("departStation","")
.addTextPara("arrivalStation","")
.addTextPara("mobile","")
.addTextPara("name","")
.addTextPara("email","")
.addTextPara("ticketType","")
.addTextPara("noSeat","")
.addTextPara("adultName","")
.addTextPara("adultIdType","1")
.addTextPara("adultIdCard","")
.addTextPara("adultBirthday","")
.addTextPara("adultGender","")
.addTextPara("adultSeatType","")
.addTextPara("adultTicketPrice","")
.addTextPara("childBirthday","")
.addTextPara("childGender","")
.addTextPara("childSeatType","")
.addTextPara("childTicketPrice","")
.addTextPara("provinceCode","")
.addTextPara("schoolCode","")
.addTextPara("studentNum","")
.addTextPara("eductionalSystem","")
.addTextPara("enrollmentYear","")
.addTextPara("preferentialDepartStationCode","")
.addTextPara("preferentialArrivalStationCode","")
.addTextPara("chooseSeats","")
.post();
System.out.println(res);
三、返回参数/
Return parameter
以JSON格式返回结果。
1、系统级参数(所有接入点都会返回的参数):
展开收起
名称 |
类型 |
示例值 |
描述 |
showapi_res_body |
String |
{"city":"昆明","prov":"云南"} |
消息体的JSON封装,所有应用级的返回参数将嵌入此对象 。 |
showapi_res_code |
int |
0 |
易源返回标志,0为成功,其他为失败。
0成功
-1,系统调用错误
-2,可调用次数或金额为0
-3,读取超时
-4,服务端返回数据解析错误
-5,后端服务器DNS解析错误
-6,服务不存在或未上线
-7, API创建者的网关资源不足
-1000,系统维护
-1002,showapi_appid字段必传
-1003,showapi_sign字段必传
-1004,签名sign验证有误
-1005,showapi_timestamp无效
-1006,app无权限调用接口
-1007,没有订购套餐
-1008,服务商关闭对您的调用权限
-1009,调用频率受限
-1010,找不到您的应用
-1011,子授权app_child_id无效
-1012,子授权已过期或失效
-1013,子授权ip受限
-1014,token权限无效
|
showapi_res_error |
String |
用户输入有误! |
错误信息的展示 |
showapi_res_id |
String |
ce135f6739294c63be0c021b76b6fbff |
本次请求id |
... |
2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构):
展开收起
名称 |
类型 |
示例值 |
描述 |
ret_code
|
String |
|
|
remark
|
String |
|
|
orderNum
|
String |
|
|
backupOrderNum
|
String |
|
|
failPassengersNames
|
String |
|
|
... |
返回示例:{
"showapi_res_code": 0,
"showapi_res_error": "",
"showapi_res_body": {
"ret_code": "0",
"remark": "创建订单成功!",
"orderNum": "",
"backupOrderNum": ""
}
}
创建火车票抢票单
接口地址:http://route.showapi.com/1651-29 (注意:接口支持https,更安全,但稍慢一些,你懂的。请根据自己的情况进行选择。)
支持格式:json
请求方法:HTTP协议,支持GET/POST方法。
二、请求参数/
Request parameter
非文件上传的POST时,enctype=application/x-www-form-urlencoded。
文件上传的POST时,enctype=multipart/form-data。
1、系统级参数(所有接入点都需要的参数):
参数名称 |
类型 |
示例值 |
必须 |
描述 |
showapi_appid |
String |
100 |
是 |
易源应用id |
showapi_sign |
String |
698d51a19d8a121ce581499d7b701668 |
是 |
为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。
可选,在url后带上appid和secret即可
|
showapi_timestamp |
String |
20141114142239 |
否 |
客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。
|
showapi_res_gzip |
String |
1或0 |
否 |
返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩。 |
... |
2、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表):
展开收起
参数名称 |
类型 |
默认值 |
示例值 |
必须 |
描述 |
uniqueKey |
String |
|
|
是 |
|
trainNum |
String |
|
|
是 |
|
seatType |
String |
|
|
是 |
|
primaryTrainNum |
String |
|
|
否 |
|
primarySeatClass |
String |
|
|
否 |
|
departStation |
String |
|
|
是 |
|
arrivalStation |
String |
|
|
是 |
|
departDate |
String |
|
|
是 |
发车日期(yyyy-MM-dd HH:mm 其中‘HH:mm’为车次查询返回值获取departureTime) 多车次时,必须取最早发车车次的出发时间
|
acceptNoSeat |
String |
|
|
是 |
|
robGrade |
String |
|
|
否 |
|
backUpTicketTime |
String |
|
|
否 |
|
mobile |
String |
|
|
是 |
|
name |
String |
|
|
是 |
|
email |
String |
|
|
否 |
|
passengerName |
String |
|
|
是 |
|
idCardType |
String |
|
|
是 |
证件类型 0:身份证 1:护照 2:台胞证 3:港澳通行证
|
idCard |
String |
|
|
是 |
|
birthday |
String |
|
|
是 |
|
ticketPrice |
String |
|
|
是 |
|
... |
请求示例:String res=new ShowApiRequest("http://route.showapi.com/1651-29","my_appId","my_appSecret")
.addTextPara("uniqueKey","")
.addTextPara("trainNum","")
.addTextPara("seatType","")
.addTextPara("primaryTrainNum","")
.addTextPara("primarySeatClass","")
.addTextPara("departStation","")
.addTextPara("arrivalStation","")
.addTextPara("departDate","")
.addTextPara("acceptNoSeat","")
.addTextPara("robGrade","")
.addTextPara("backUpTicketTime","")
.addTextPara("mobile","")
.addTextPara("name","")
.addTextPara("email","")
.addTextPara("passengerName","")
.addTextPara("idCardType","0")
.addTextPara("idCard","")
.addTextPara("birthday","")
.addTextPara("ticketPrice","")
.post();
System.out.println(res);
三、返回参数/
Return parameter
以JSON格式返回结果。
1、系统级参数(所有接入点都会返回的参数):
展开收起
名称 |
类型 |
示例值 |
描述 |
showapi_res_body |
String |
{"city":"昆明","prov":"云南"} |
消息体的JSON封装,所有应用级的返回参数将嵌入此对象 。 |
showapi_res_code |
int |
0 |
易源返回标志,0为成功,其他为失败。
0成功
-1,系统调用错误
-2,可调用次数或金额为0
-3,读取超时
-4,服务端返回数据解析错误
-5,后端服务器DNS解析错误
-6,服务不存在或未上线
-7, API创建者的网关资源不足
-1000,系统维护
-1002,showapi_appid字段必传
-1003,showapi_sign字段必传
-1004,签名sign验证有误
-1005,showapi_timestamp无效
-1006,app无权限调用接口
-1007,没有订购套餐
-1008,服务商关闭对您的调用权限
-1009,调用频率受限
-1010,找不到您的应用
-1011,子授权app_child_id无效
-1012,子授权已过期或失效
-1013,子授权ip受限
-1014,token权限无效
|
showapi_res_error |
String |
用户输入有误! |
错误信息的展示 |
showapi_res_id |
String |
ce135f6739294c63be0c021b76b6fbff |
本次请求id |
... |
2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构):
展开收起
名称 |
类型 |
示例值 |
描述 |
ret_code
|
String |
|
|
remark
|
String |
|
|
orderNum
|
String |
|
|
backupOrderNum
|
String |
|
|
... |
返回示例:{
"showapi_res_code": 0,
"showapi_res_error": "",
"showapi_res_body": {
"ret_code": "0",
"remark": "创建抢票订单成功!",
"orderNum": "",
"backupOrderNum": ""
}
}
申请出票
接口地址:http://route.showapi.com/1651-32 (注意:接口支持https,更安全,但稍慢一些,你懂的。请根据自己的情况进行选择。)
支持格式:json
请求方法:HTTP协议,支持GET/POST方法。
二、请求参数/
Request parameter
非文件上传的POST时,enctype=application/x-www-form-urlencoded。
文件上传的POST时,enctype=multipart/form-data。
1、系统级参数(所有接入点都需要的参数):
参数名称 |
类型 |
示例值 |
必须 |
描述 |
showapi_appid |
String |
100 |
是 |
易源应用id |
showapi_sign |
String |
698d51a19d8a121ce581499d7b701668 |
是 |
为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。
可选,在url后带上appid和secret即可
|
showapi_timestamp |
String |
20141114142239 |
否 |
客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。
|
showapi_res_gzip |
String |
1或0 |
否 |
返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩。 |
... |
2、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表):
参数名称 |
类型 |
默认值 |
示例值 |
必须 |
描述 |
orderNum |
String |
|
|
是 |
|
请求示例:String res=new ShowApiRequest("http://route.showapi.com/1651-32","my_appId","my_appSecret")
.addTextPara("orderNum","")
.post();
System.out.println(res);
三、返回参数/
Return parameter
以JSON格式返回结果。
1、系统级参数(所有接入点都会返回的参数):
展开收起
名称 |
类型 |
示例值 |
描述 |
showapi_res_body |
String |
{"city":"昆明","prov":"云南"} |
消息体的JSON封装,所有应用级的返回参数将嵌入此对象 。 |
showapi_res_code |
int |
0 |
易源返回标志,0为成功,其他为失败。
0成功
-1,系统调用错误
-2,可调用次数或金额为0
-3,读取超时
-4,服务端返回数据解析错误
-5,后端服务器DNS解析错误
-6,服务不存在或未上线
-7, API创建者的网关资源不足
-1000,系统维护
-1002,showapi_appid字段必传
-1003,showapi_sign字段必传
-1004,签名sign验证有误
-1005,showapi_timestamp无效
-1006,app无权限调用接口
-1007,没有订购套餐
-1008,服务商关闭对您的调用权限
-1009,调用频率受限
-1010,找不到您的应用
-1011,子授权app_child_id无效
-1012,子授权已过期或失效
-1013,子授权ip受限
-1014,token权限无效
|
showapi_res_error |
String |
用户输入有误! |
错误信息的展示 |
showapi_res_id |
String |
ce135f6739294c63be0c021b76b6fbff |
本次请求id |
... |
2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构):
展开收起
名称 |
类型 |
示例值 |
描述 |
ret_code
|
String |
|
|
remark
|
String |
|
|
orderNum
|
String |
|
|
... |
返回示例:{
"showapi_res_code": 0,
"showapi_res_error": "",
"showapi_res_body": {
"ret_code": "0",
"remark": "申请出票成功!",
"orderNum": ""
}
}
申请退票
接口地址:http://route.showapi.com/1651-33 (注意:接口支持https,更安全,但稍慢一些,你懂的。请根据自己的情况进行选择。)
支持格式:json
请求方法:HTTP协议,支持GET/POST方法。
二、请求参数/
Request parameter
非文件上传的POST时,enctype=application/x-www-form-urlencoded。
文件上传的POST时,enctype=multipart/form-data。
1、系统级参数(所有接入点都需要的参数):
参数名称 |
类型 |
示例值 |
必须 |
描述 |
showapi_appid |
String |
100 |
是 |
易源应用id |
showapi_sign |
String |
698d51a19d8a121ce581499d7b701668 |
是 |
为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。
可选,在url后带上appid和secret即可
|
showapi_timestamp |
String |
20141114142239 |
否 |
客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。
|
showapi_res_gzip |
String |
1或0 |
否 |
返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩。 |
... |
2、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表):
参数名称 |
类型 |
默认值 |
示例值 |
必须 |
描述 |
orderNum |
String |
|
|
是 |
|
passengerId |
String |
|
|
是 |
|
请求示例:String res=new ShowApiRequest("http://route.showapi.com/1651-33","my_appId","my_appSecret")
.addTextPara("orderNum","")
.addTextPara("passengerId","")
.post();
System.out.println(res);
三、返回参数/
Return parameter
以JSON格式返回结果。
1、系统级参数(所有接入点都会返回的参数):
展开收起
名称 |
类型 |
示例值 |
描述 |
showapi_res_body |
String |
{"city":"昆明","prov":"云南"} |
消息体的JSON封装,所有应用级的返回参数将嵌入此对象 。 |
showapi_res_code |
int |
0 |
易源返回标志,0为成功,其他为失败。
0成功
-1,系统调用错误
-2,可调用次数或金额为0
-3,读取超时
-4,服务端返回数据解析错误
-5,后端服务器DNS解析错误
-6,服务不存在或未上线
-7, API创建者的网关资源不足
-1000,系统维护
-1002,showapi_appid字段必传
-1003,showapi_sign字段必传
-1004,签名sign验证有误
-1005,showapi_timestamp无效
-1006,app无权限调用接口
-1007,没有订购套餐
-1008,服务商关闭对您的调用权限
-1009,调用频率受限
-1010,找不到您的应用
-1011,子授权app_child_id无效
-1012,子授权已过期或失效
-1013,子授权ip受限
-1014,token权限无效
|
showapi_res_error |
String |
用户输入有误! |
错误信息的展示 |
showapi_res_id |
String |
ce135f6739294c63be0c021b76b6fbff |
本次请求id |
... |
2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构):
展开收起
名称 |
类型 |
示例值 |
描述 |
ret_code
|
String |
|
|
remark
|
String |
|
|
orderNum
|
String |
|
|
passengerId
|
String |
|
|
... |
返回示例:{
"showapi_res_code": 0,
"showapi_res_error": "",
"showapi_res_body": {
"ret_code": "0",
"remark": "申请退票成功!",
"orderNum": "",
"passengerId": ""
}
}
取消订单
接口地址:http://route.showapi.com/1651-34 (注意:接口支持https,更安全,但稍慢一些,你懂的。请根据自己的情况进行选择。)
支持格式:json
请求方法:HTTP协议,支持GET/POST方法。
二、请求参数/
Request parameter
非文件上传的POST时,enctype=application/x-www-form-urlencoded。
文件上传的POST时,enctype=multipart/form-data。
1、系统级参数(所有接入点都需要的参数):
参数名称 |
类型 |
示例值 |
必须 |
描述 |
showapi_appid |
String |
100 |
是 |
易源应用id |
showapi_sign |
String |
698d51a19d8a121ce581499d7b701668 |
是 |
为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。
可选,在url后带上appid和secret即可
|
showapi_timestamp |
String |
20141114142239 |
否 |
客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。
|
showapi_res_gzip |
String |
1或0 |
否 |
返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩。 |
... |
2、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表):
参数名称 |
类型 |
默认值 |
示例值 |
必须 |
描述 |
orderNum |
String |
|
|
是 |
|
请求示例:String res=new ShowApiRequest("http://route.showapi.com/1651-34","my_appId","my_appSecret")
.addTextPara("orderNum","")
.post();
System.out.println(res);
三、返回参数/
Return parameter
以JSON格式返回结果。
1、系统级参数(所有接入点都会返回的参数):
展开收起
名称 |
类型 |
示例值 |
描述 |
showapi_res_body |
String |
{"city":"昆明","prov":"云南"} |
消息体的JSON封装,所有应用级的返回参数将嵌入此对象 。 |
showapi_res_code |
int |
0 |
易源返回标志,0为成功,其他为失败。
0成功
-1,系统调用错误
-2,可调用次数或金额为0
-3,读取超时
-4,服务端返回数据解析错误
-5,后端服务器DNS解析错误
-6,服务不存在或未上线
-7, API创建者的网关资源不足
-1000,系统维护
-1002,showapi_appid字段必传
-1003,showapi_sign字段必传
-1004,签名sign验证有误
-1005,showapi_timestamp无效
-1006,app无权限调用接口
-1007,没有订购套餐
-1008,服务商关闭对您的调用权限
-1009,调用频率受限
-1010,找不到您的应用
-1011,子授权app_child_id无效
-1012,子授权已过期或失效
-1013,子授权ip受限
-1014,token权限无效
|
showapi_res_error |
String |
用户输入有误! |
错误信息的展示 |
showapi_res_id |
String |
ce135f6739294c63be0c021b76b6fbff |
本次请求id |
... |
2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构):
展开收起
名称 |
类型 |
示例值 |
描述 |
ret_code
|
String |
|
|
remark
|
String |
|
|
orderNum
|
String |
|
|
... |
返回示例:{
"showapi_res_code": 0,
"showapi_res_error": "",
"showapi_res_body": {
"ret_code": "0",
"remark": "取消订单成功!",
"orderNum": ""
}
}
取消抢票单
接口地址:http://route.showapi.com/1651-35 (注意:接口支持https,更安全,但稍慢一些,你懂的。请根据自己的情况进行选择。)
支持格式:json
请求方法:HTTP协议,支持GET/POST方法。
二、请求参数/
Request parameter
非文件上传的POST时,enctype=application/x-www-form-urlencoded。
文件上传的POST时,enctype=multipart/form-data。
1、系统级参数(所有接入点都需要的参数):
参数名称 |
类型 |
示例值 |
必须 |
描述 |
showapi_appid |
String |
100 |
是 |
易源应用id |
showapi_sign |
String |
698d51a19d8a121ce581499d7b701668 |
是 |
为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。
可选,在url后带上appid和secret即可
|
showapi_timestamp |
String |
20141114142239 |
否 |
客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。
|
showapi_res_gzip |
String |
1或0 |
否 |
返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩。 |
... |
2、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表):
参数名称 |
类型 |
默认值 |
示例值 |
必须 |
描述 |
orderNum |
String |
|
|
是 |
|
请求示例:String res=new ShowApiRequest("http://route.showapi.com/1651-35","my_appId","my_appSecret")
.addTextPara("orderNum","")
.post();
System.out.println(res);
三、返回参数/
Return parameter
以JSON格式返回结果。
1、系统级参数(所有接入点都会返回的参数):
展开收起
名称 |
类型 |
示例值 |
描述 |
showapi_res_body |
String |
{"city":"昆明","prov":"云南"} |
消息体的JSON封装,所有应用级的返回参数将嵌入此对象 。 |
showapi_res_code |
int |
0 |
易源返回标志,0为成功,其他为失败。
0成功
-1,系统调用错误
-2,可调用次数或金额为0
-3,读取超时
-4,服务端返回数据解析错误
-5,后端服务器DNS解析错误
-6,服务不存在或未上线
-7, API创建者的网关资源不足
-1000,系统维护
-1002,showapi_appid字段必传
-1003,showapi_sign字段必传
-1004,签名sign验证有误
-1005,showapi_timestamp无效
-1006,app无权限调用接口
-1007,没有订购套餐
-1008,服务商关闭对您的调用权限
-1009,调用频率受限
-1010,找不到您的应用
-1011,子授权app_child_id无效
-1012,子授权已过期或失效
-1013,子授权ip受限
-1014,token权限无效
|
showapi_res_error |
String |
用户输入有误! |
错误信息的展示 |
showapi_res_id |
String |
ce135f6739294c63be0c021b76b6fbff |
本次请求id |
... |
2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构):
展开收起
名称 |
类型 |
示例值 |
描述 |
ret_code
|
String |
|
|
remark
|
String |
|
|
orderNum
|
String |
|
|
... |
返回示例:{
"showapi_res_code": 0,
"showapi_res_error": "",
"showapi_res_body": {
"ret_code": "0",
"remark": "取消抢票订单成功!",
"orderNum": ""
}
}
订单详情
接口地址:http://route.showapi.com/1651-36 (注意:接口支持https,更安全,但稍慢一些,你懂的。请根据自己的情况进行选择。)
支持格式:json
请求方法:HTTP协议,支持GET/POST方法。
二、请求参数/
Request parameter
非文件上传的POST时,enctype=application/x-www-form-urlencoded。
文件上传的POST时,enctype=multipart/form-data。
1、系统级参数(所有接入点都需要的参数):
参数名称 |
类型 |
示例值 |
必须 |
描述 |
showapi_appid |
String |
100 |
是 |
易源应用id |
showapi_sign |
String |
698d51a19d8a121ce581499d7b701668 |
是 |
为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。
可选,在url后带上appid和secret即可
|
showapi_timestamp |
String |
20141114142239 |
否 |
客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。
|
showapi_res_gzip |
String |
1或0 |
否 |
返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩。 |
... |
2、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表):
参数名称 |
类型 |
默认值 |
示例值 |
必须 |
描述 |
orderNum |
String |
|
|
否 |
|
backupOrderNum |
String |
|
|
否 |
|
请求示例:String res=new ShowApiRequest("http://route.showapi.com/1651-36","my_appId","my_appSecret")
.addTextPara("orderNum","")
.addTextPara("backupOrderNum","")
.post();
System.out.println(res);
三、返回参数/
Return parameter
以JSON格式返回结果。
1、系统级参数(所有接入点都会返回的参数):
展开收起
名称 |
类型 |
示例值 |
描述 |
showapi_res_body |
String |
{"city":"昆明","prov":"云南"} |
消息体的JSON封装,所有应用级的返回参数将嵌入此对象 。 |
showapi_res_code |
int |
0 |
易源返回标志,0为成功,其他为失败。
0成功
-1,系统调用错误
-2,可调用次数或金额为0
-3,读取超时
-4,服务端返回数据解析错误
-5,后端服务器DNS解析错误
-6,服务不存在或未上线
-7, API创建者的网关资源不足
-1000,系统维护
-1002,showapi_appid字段必传
-1003,showapi_sign字段必传
-1004,签名sign验证有误
-1005,showapi_timestamp无效
-1006,app无权限调用接口
-1007,没有订购套餐
-1008,服务商关闭对您的调用权限
-1009,调用频率受限
-1010,找不到您的应用
-1011,子授权app_child_id无效
-1012,子授权已过期或失效
-1013,子授权ip受限
-1014,token权限无效
|
showapi_res_error |
String |
用户输入有误! |
错误信息的展示 |
showapi_res_id |
String |
ce135f6739294c63be0c021b76b6fbff |
本次请求id |
... |
2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构):
展开收起
名称 |
类型 |
示例值 |
描述 |
ret_code
|
String |
|
|
remark
|
String |
|
|
orderNum
|
String |
|
|
backupOrderNum
|
String |
|
|
orderStatus
|
String |
|
|
orderStateCode
|
String |
|
|
failReason
|
String |
|
|
bookingTime
|
String |
|
|
payforTime
|
String |
|
支付时间,失败为1900-01-01 00:00:00
|
issureTime
|
String |
|
确认时间,失败为1900-01-01 00:00:00
|
payment
|
String |
|
|
payStatus
|
String |
|
付款状态,0:未付款,1:付款成功,-1:付款失败
|
payNote
|
String |
|
|
orderTotalPrice
|
String |
|
|
serviceTotalCost
|
String |
|
|
ticketNum
|
String |
|
|
changeOrderCost
|
String |
|
|
bookingInfo
|
Object[] |
|
|
-
trainNum
|
String |
|
|
-
trainDateTime
|
String |
|
|
-
departStation
|
String |
|
|
-
arrvialStation
|
String |
|
|
-
departTime
|
String |
|
|
-
arrvialTime
|
String |
|
|
passengers
|
Object[] |
|
|
-
passengerId
|
String |
|
|
-
passengerName
|
String |
|
|
-
passengerType
|
String |
|
|
-
idType
|
String |
|
|
-
idCard
|
String |
|
|
-
birthday
|
String |
|
|
-
seatClass
|
String |
|
|
-
seatClassName
|
String |
|
|
-
seatNo
|
String |
|
|
-
pTicketNo
|
String |
|
|
-
ticketStateCode
|
String |
|
|
-
ticketState
|
String |
|
|
-
ticketPrice
|
String |
|
|
-
insureUnitPrice
|
String |
|
|
-
insureState
|
String |
|
保险状态,F:已购保 ,参考接口相关说明中的状态枚举
|
-
insureBillNo
|
String |
|
|
-
refundFee
|
String |
|
|
-
refundTime
|
String |
|
|
-
ticketGate
|
String |
|
|
connectionInfo
|
Object[] |
|
|
-
name
|
String |
|
|
-
mobile
|
String |
|
|
-
email
|
String |
|
|
departStation
|
String |
|
|
arrivalStation
|
String |
|
|
trainNum
|
String |
|
|
... |
返回示例:{
"showapi_res_code": 0,
"showapi_res_error": "",
"showapi_res_body": {
"ret_code": "0",
"remark": "查询成功!",
"orderNum": "",
"backupOrderNum": "",
"orderStatus": "",
"orderStateCode": "",
"failReason": "",
"bookingTime": "",
"payforTime": "",
"issureTime": "",
"payment": "",
"payStatus": "",
"payNote": "",
"orderTotalPrice": "",
"serviceTotalCost": "",
"ticketNum": "",
"changeOrderCost": "",
"bookingInfo": "",
"passengers": "[]",
"connectionInfo": "",
"trainNum":"",
"departStation":"",
"arrivalStation":""
}
}
抢票单详情
接口地址:http://route.showapi.com/1651-37 (注意:接口支持https,更安全,但稍慢一些,你懂的。请根据自己的情况进行选择。)
支持格式:json
请求方法:HTTP协议,支持GET/POST方法。
二、请求参数/
Request parameter
非文件上传的POST时,enctype=application/x-www-form-urlencoded。
文件上传的POST时,enctype=multipart/form-data。
1、系统级参数(所有接入点都需要的参数):
参数名称 |
类型 |
示例值 |
必须 |
描述 |
showapi_appid |
String |
100 |
是 |
易源应用id |
showapi_sign |
String |
698d51a19d8a121ce581499d7b701668 |
是 |
为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。
可选,在url后带上appid和secret即可
|
showapi_timestamp |
String |
20141114142239 |
否 |
客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。
|
showapi_res_gzip |
String |
1或0 |
否 |
返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩。 |
... |
2、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表):
参数名称 |
类型 |
默认值 |
示例值 |
必须 |
描述 |
orderNum |
String |
|
|
否 |
|
backupOrderNum |
String |
|
|
否 |
|
请求示例:String res=new ShowApiRequest("http://route.showapi.com/1651-37","my_appId","my_appSecret")
.addTextPara("orderNum","")
.addTextPara("backupOrderNum","")
.post();
System.out.println(res);
三、返回参数/
Return parameter
以JSON格式返回结果。
1、系统级参数(所有接入点都会返回的参数):
展开收起
名称 |
类型 |
示例值 |
描述 |
showapi_res_body |
String |
{"city":"昆明","prov":"云南"} |
消息体的JSON封装,所有应用级的返回参数将嵌入此对象 。 |
showapi_res_code |
int |
0 |
易源返回标志,0为成功,其他为失败。
0成功
-1,系统调用错误
-2,可调用次数或金额为0
-3,读取超时
-4,服务端返回数据解析错误
-5,后端服务器DNS解析错误
-6,服务不存在或未上线
-7, API创建者的网关资源不足
-1000,系统维护
-1002,showapi_appid字段必传
-1003,showapi_sign字段必传
-1004,签名sign验证有误
-1005,showapi_timestamp无效
-1006,app无权限调用接口
-1007,没有订购套餐
-1008,服务商关闭对您的调用权限
-1009,调用频率受限
-1010,找不到您的应用
-1011,子授权app_child_id无效
-1012,子授权已过期或失效
-1013,子授权ip受限
-1014,token权限无效
|
showapi_res_error |
String |
用户输入有误! |
错误信息的展示 |
showapi_res_id |
String |
ce135f6739294c63be0c021b76b6fbff |
本次请求id |
... |
2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构):
展开收起
名称 |
类型 |
示例值 |
描述 |
ret_code
|
String |
|
|
remark
|
String |
|
|
orderNum
|
String |
|
|
backupOrderNum
|
String |
|
|
departStation
|
String |
|
|
arrvialStation
|
String |
|
|
departTime
|
String |
|
|
robStatus
|
String |
|
|
mobile
|
String |
|
|
failInfo
|
String |
|
|
robEndingTime
|
String |
|
|
trainNum
|
String |
|
|
seatType
|
String |
|
|
primaryTrainNum
|
String |
|
|
primarySeatClass
|
String |
|
|
passengers
|
Object[] |
|
|
-
passengerName
|
String |
|
|
-
passengerType
|
String |
|
|
-
certificateNo
|
String |
|
|
-
ticketPrice
|
String |
|
|
... |
返回示例:{
"showapi_res_code": 0,
"showapi_res_error": "",
"showapi_res_body": {
"ret_code": "0",
"remark": "查询成功!",
"orderNum": "",
"backupOrderNum": "",
"departStation": "",
"arrvialStation": "",
"departTime": "",
"robStatus": "",
"mobile": "",
"failInfo": "",
"robEndingTime": "",
"trainNum": "",
"seatType": "",
"primaryTrainNum": "",
"primarySeatClass": "",
"passengers": []
}
}
验证是否可改签
接口地址:http://route.showapi.com/1651-38 (注意:接口支持https,更安全,但稍慢一些,你懂的。请根据自己的情况进行选择。)
支持格式:json
请求方法:HTTP协议,支持GET/POST方法。
二、请求参数/
Request parameter
非文件上传的POST时,enctype=application/x-www-form-urlencoded。
文件上传的POST时,enctype=multipart/form-data。
1、系统级参数(所有接入点都需要的参数):
参数名称 |
类型 |
示例值 |
必须 |
描述 |
showapi_appid |
String |
100 |
是 |
易源应用id |
showapi_sign |
String |
698d51a19d8a121ce581499d7b701668 |
是 |
为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。
可选,在url后带上appid和secret即可
|
showapi_timestamp |
String |
20141114142239 |
否 |
客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。
|
showapi_res_gzip |
String |
1或0 |
否 |
返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩。 |
... |
2、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表):
展开收起
参数名称 |
类型 |
默认值 |
示例值 |
必须 |
描述 |
orderNum |
String |
|
|
是 |
|
passengerId |
String |
|
|
是 |
|
endorsing |
String |
|
|
否 |
核验类型 0:正常改签 1 变更到站 不填默认为0
|
passengerId2 |
String |
|
|
否 |
|
... |
请求示例:String res=new ShowApiRequest("http://route.showapi.com/1651-38","my_appId","my_appSecret")
.addTextPara("orderNum","")
.addTextPara("passengerId","")
.addTextPara("endorsing","")
.addTextPara("passengerId2","")
.post();
System.out.println(res);
三、返回参数/
Return parameter
以JSON格式返回结果。
1、系统级参数(所有接入点都会返回的参数):
展开收起
名称 |
类型 |
示例值 |
描述 |
showapi_res_body |
String |
{"city":"昆明","prov":"云南"} |
消息体的JSON封装,所有应用级的返回参数将嵌入此对象 。 |
showapi_res_code |
int |
0 |
易源返回标志,0为成功,其他为失败。
0成功
-1,系统调用错误
-2,可调用次数或金额为0
-3,读取超时
-4,服务端返回数据解析错误
-5,后端服务器DNS解析错误
-6,服务不存在或未上线
-7, API创建者的网关资源不足
-1000,系统维护
-1002,showapi_appid字段必传
-1003,showapi_sign字段必传
-1004,签名sign验证有误
-1005,showapi_timestamp无效
-1006,app无权限调用接口
-1007,没有订购套餐
-1008,服务商关闭对您的调用权限
-1009,调用频率受限
-1010,找不到您的应用
-1011,子授权app_child_id无效
-1012,子授权已过期或失效
-1013,子授权ip受限
-1014,token权限无效
|
showapi_res_error |
String |
用户输入有误! |
错误信息的展示 |
showapi_res_id |
String |
ce135f6739294c63be0c021b76b6fbff |
本次请求id |
... |
2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构):
展开收起
名称 |
类型 |
示例值 |
描述 |
ret_code
|
String |
|
|
remark
|
String |
|
|
originalOrderNum
|
String |
|
|
orderNum
|
String |
|
|
backupOrderNum
|
String |
|
|
passengerIds
|
String |
|
|
... |
返回示例:{
"showapi_res_code": 0,
"showapi_res_error": "",
"showapi_res_body": {
"ret_code": "0",
"remark": "核验通过",
"originalOrderNum": "",
"orderNum": "",
"backupOrderNum": "",
"passengerIds": ""
}
}
申请改签车票
接口地址:http://route.showapi.com/1651-39 (注意:接口支持https,更安全,但稍慢一些,你懂的。请根据自己的情况进行选择。)
支持格式:json
请求方法:HTTP协议,支持GET/POST方法。
二、请求参数/
Request parameter
非文件上传的POST时,enctype=application/x-www-form-urlencoded。
文件上传的POST时,enctype=multipart/form-data。
1、系统级参数(所有接入点都需要的参数):
参数名称 |
类型 |
示例值 |
必须 |
描述 |
showapi_appid |
String |
100 |
是 |
易源应用id |
showapi_sign |
String |
698d51a19d8a121ce581499d7b701668 |
是 |
为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。
可选,在url后带上appid和secret即可
|
showapi_timestamp |
String |
20141114142239 |
否 |
客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。
|
showapi_res_gzip |
String |
1或0 |
否 |
返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩。 |
... |
2、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表):
展开收起
参数名称 |
类型 |
默认值 |
示例值 |
必须 |
描述 |
orderNum |
String |
|
|
是 |
|
departStation |
String |
|
|
是 |
|
arrvialStation |
String |
|
|
是 |
|
trainNum |
String |
|
|
是 |
|
unqieKey |
String |
|
|
是 |
|
seatType |
String |
|
|
是 |
|
passengerId |
String |
|
|
是 |
|
isChangeArrvialStation |
String |
|
|
否 |
|
passengerId2 |
String |
|
|
否 |
|
chooseSeats |
String |
|
|
否 |
|
... |
请求示例:String res=new ShowApiRequest("http://route.showapi.com/1651-39","my_appId","my_appSecret")
.addTextPara("orderNum","")
.addTextPara("departStation","")
.addTextPara("arrvialStation","")
.addTextPara("trainNum","")
.addTextPara("unqieKey","")
.addTextPara("seatType","")
.addTextPara("passengerId","")
.addTextPara("isChangeArrvialStation","")
.addTextPara("passengerId2","")
.addTextPara("chooseSeats","")
.post();
System.out.println(res);
三、返回参数/
Return parameter
以JSON格式返回结果。
1、系统级参数(所有接入点都会返回的参数):
展开收起
名称 |
类型 |
示例值 |
描述 |
showapi_res_body |
String |
{"city":"昆明","prov":"云南"} |
消息体的JSON封装,所有应用级的返回参数将嵌入此对象 。 |
showapi_res_code |
int |
0 |
易源返回标志,0为成功,其他为失败。
0成功
-1,系统调用错误
-2,可调用次数或金额为0
-3,读取超时
-4,服务端返回数据解析错误
-5,后端服务器DNS解析错误
-6,服务不存在或未上线
-7, API创建者的网关资源不足
-1000,系统维护
-1002,showapi_appid字段必传
-1003,showapi_sign字段必传
-1004,签名sign验证有误
-1005,showapi_timestamp无效
-1006,app无权限调用接口
-1007,没有订购套餐
-1008,服务商关闭对您的调用权限
-1009,调用频率受限
-1010,找不到您的应用
-1011,子授权app_child_id无效
-1012,子授权已过期或失效
-1013,子授权ip受限
-1014,token权限无效
|
showapi_res_error |
String |
用户输入有误! |
错误信息的展示 |
showapi_res_id |
String |
ce135f6739294c63be0c021b76b6fbff |
本次请求id |
... |
2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构):
展开收起
名称 |
类型 |
示例值 |
描述 |
ret_code
|
String |
|
|
remark
|
String |
|
|
originalOrderNum
|
String |
|
|
orderNum
|
String |
|
|
backupOrderNum
|
String |
|
|
... |
返回示例:{
"showapi_res_code": 0,
"showapi_res_error": "",
"showapi_res_body": {
"ret_code": "0",
"remark": "申请改签成功!",
"originalOrderNum": "",
"orderNum": "",
"backupOrderNum": ""
}
}
改签判断
接口地址:http://route.showapi.com/1651-54 (注意:接口支持https,更安全,但稍慢一些,你懂的。请根据自己的情况进行选择。)
支持格式:json
请求方法:HTTP协议,支持GET/POST方法。
二、请求参数/
Request parameter
非文件上传的POST时,enctype=application/x-www-form-urlencoded。
文件上传的POST时,enctype=multipart/form-data。
1、系统级参数(所有接入点都需要的参数):
参数名称 |
类型 |
示例值 |
必须 |
描述 |
showapi_appid |
String |
100 |
是 |
易源应用id |
showapi_sign |
String |
698d51a19d8a121ce581499d7b701668 |
是 |
为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。
可选,在url后带上appid和secret即可
|
showapi_timestamp |
String |
20141114142239 |
否 |
客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。
|
showapi_res_gzip |
String |
1或0 |
否 |
返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩。 |
... |
2、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表):
展开收起
参数名称 |
类型 |
默认值 |
示例值 |
必须 |
描述 |
departStation |
String |
|
|
是 |
|
arrivalStation |
String |
|
|
是 |
|
date |
String |
|
|
是 |
|
changeDepartStation |
String |
|
|
是 |
|
changeArrivalStation |
String |
|
|
是 |
|
changeDate |
String |
|
|
是 |
|
isStudent |
String |
|
|
否 |
|
... |
请求示例:String res=new ShowApiRequest("http://route.showapi.com/1651-54","my_appId","my_appSecret")
.addTextPara("departStation","")
.addTextPara("arrivalStation","")
.addTextPara("date","")
.addTextPara("changeDepartStation","")
.addTextPara("changeArrivalStation","")
.addTextPara("changeDate","")
.addTextPara("isStudent","")
.post();
System.out.println(res);
三、返回参数/
Return parameter
以JSON格式返回结果。
1、系统级参数(所有接入点都会返回的参数):
展开收起
名称 |
类型 |
示例值 |
描述 |
showapi_res_body |
String |
{"city":"昆明","prov":"云南"} |
消息体的JSON封装,所有应用级的返回参数将嵌入此对象 。 |
showapi_res_code |
int |
0 |
易源返回标志,0为成功,其他为失败。
0成功
-1,系统调用错误
-2,可调用次数或金额为0
-3,读取超时
-4,服务端返回数据解析错误
-5,后端服务器DNS解析错误
-6,服务不存在或未上线
-7, API创建者的网关资源不足
-1000,系统维护
-1002,showapi_appid字段必传
-1003,showapi_sign字段必传
-1004,签名sign验证有误
-1005,showapi_timestamp无效
-1006,app无权限调用接口
-1007,没有订购套餐
-1008,服务商关闭对您的调用权限
-1009,调用频率受限
-1010,找不到您的应用
-1011,子授权app_child_id无效
-1012,子授权已过期或失效
-1013,子授权ip受限
-1014,token权限无效
|
showapi_res_error |
String |
用户输入有误! |
错误信息的展示 |
showapi_res_id |
String |
ce135f6739294c63be0c021b76b6fbff |
本次请求id |
... |
2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构):
展开收起
名称 |
类型 |
示例值 |
描述 |
ret_code
|
String |
|
|
remark
|
String |
|
|
isChangeArrvialStation
|
String |
|
|
... |
返回示例:{
"showapi_res_error": "",
"showapi_res_id": "630be5669b304c038bce024575648f13",
"showapi_res_code": 0,
"showapi_res_body": {
"ret_code": "0",
"remark": "判断成功!",
"isChangeArrvialStation": "0",
}
}
确认改签
接口地址:http://route.showapi.com/1651-40 (注意:接口支持https,更安全,但稍慢一些,你懂的。请根据自己的情况进行选择。)
支持格式:json
请求方法:HTTP协议,支持GET/POST方法。
二、请求参数/
Request parameter
非文件上传的POST时,enctype=application/x-www-form-urlencoded。
文件上传的POST时,enctype=multipart/form-data。
1、系统级参数(所有接入点都需要的参数):
参数名称 |
类型 |
示例值 |
必须 |
描述 |
showapi_appid |
String |
100 |
是 |
易源应用id |
showapi_sign |
String |
698d51a19d8a121ce581499d7b701668 |
是 |
为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。
可选,在url后带上appid和secret即可
|
showapi_timestamp |
String |
20141114142239 |
否 |
客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。
|
showapi_res_gzip |
String |
1或0 |
否 |
返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩。 |
... |
2、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表):
参数名称 |
类型 |
默认值 |
示例值 |
必须 |
描述 |
orderNum |
String |
|
|
是 |
|
请求示例:String res=new ShowApiRequest("http://route.showapi.com/1651-40","my_appId","my_appSecret")
.addTextPara("orderNum","")
.post();
System.out.println(res);
三、返回参数/
Return parameter
以JSON格式返回结果。
1、系统级参数(所有接入点都会返回的参数):
展开收起
名称 |
类型 |
示例值 |
描述 |
showapi_res_body |
String |
{"city":"昆明","prov":"云南"} |
消息体的JSON封装,所有应用级的返回参数将嵌入此对象 。 |
showapi_res_code |
int |
0 |
易源返回标志,0为成功,其他为失败。
0成功
-1,系统调用错误
-2,可调用次数或金额为0
-3,读取超时
-4,服务端返回数据解析错误
-5,后端服务器DNS解析错误
-6,服务不存在或未上线
-7, API创建者的网关资源不足
-1000,系统维护
-1002,showapi_appid字段必传
-1003,showapi_sign字段必传
-1004,签名sign验证有误
-1005,showapi_timestamp无效
-1006,app无权限调用接口
-1007,没有订购套餐
-1008,服务商关闭对您的调用权限
-1009,调用频率受限
-1010,找不到您的应用
-1011,子授权app_child_id无效
-1012,子授权已过期或失效
-1013,子授权ip受限
-1014,token权限无效
|
showapi_res_error |
String |
用户输入有误! |
错误信息的展示 |
showapi_res_id |
String |
ce135f6739294c63be0c021b76b6fbff |
本次请求id |
... |
2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构):
展开收起
名称 |
类型 |
示例值 |
描述 |
ret_code
|
String |
|
|
remark
|
String |
|
|
orderNum
|
String |
|
|
backupOrderNum
|
String |
|
|
... |
返回示例:{
"showapi_res_code": 0,
"showapi_res_error": "",
"showapi_res_body": {
"ret_code": "0",
"remark": "确认改签成功!",
"orderNum": "",
"backupOrderNum": ""
}
}
取消改签
接口地址:http://route.showapi.com/1651-41 (注意:接口支持https,更安全,但稍慢一些,你懂的。请根据自己的情况进行选择。)
支持格式:json
请求方法:HTTP协议,支持GET/POST方法。
二、请求参数/
Request parameter
非文件上传的POST时,enctype=application/x-www-form-urlencoded。
文件上传的POST时,enctype=multipart/form-data。
1、系统级参数(所有接入点都需要的参数):
参数名称 |
类型 |
示例值 |
必须 |
描述 |
showapi_appid |
String |
100 |
是 |
易源应用id |
showapi_sign |
String |
698d51a19d8a121ce581499d7b701668 |
是 |
为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。
可选,在url后带上appid和secret即可
|
showapi_timestamp |
String |
20141114142239 |
否 |
客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。
|
showapi_res_gzip |
String |
1或0 |
否 |
返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩。 |
... |
2、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表):
参数名称 |
类型 |
默认值 |
示例值 |
必须 |
描述 |
orderNum |
String |
|
|
是 |
|
请求示例:String res=new ShowApiRequest("http://route.showapi.com/1651-41","my_appId","my_appSecret")
.addTextPara("orderNum","")
.post();
System.out.println(res);
三、返回参数/
Return parameter
以JSON格式返回结果。
1、系统级参数(所有接入点都会返回的参数):
展开收起
名称 |
类型 |
示例值 |
描述 |
showapi_res_body |
String |
{"city":"昆明","prov":"云南"} |
消息体的JSON封装,所有应用级的返回参数将嵌入此对象 。 |
showapi_res_code |
int |
0 |
易源返回标志,0为成功,其他为失败。
0成功
-1,系统调用错误
-2,可调用次数或金额为0
-3,读取超时
-4,服务端返回数据解析错误
-5,后端服务器DNS解析错误
-6,服务不存在或未上线
-7, API创建者的网关资源不足
-1000,系统维护
-1002,showapi_appid字段必传
-1003,showapi_sign字段必传
-1004,签名sign验证有误
-1005,showapi_timestamp无效
-1006,app无权限调用接口
-1007,没有订购套餐
-1008,服务商关闭对您的调用权限
-1009,调用频率受限
-1010,找不到您的应用
-1011,子授权app_child_id无效
-1012,子授权已过期或失效
-1013,子授权ip受限
-1014,token权限无效
|
showapi_res_error |
String |
用户输入有误! |
错误信息的展示 |
showapi_res_id |
String |
ce135f6739294c63be0c021b76b6fbff |
本次请求id |
... |
2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构):
展开收起
名称 |
类型 |
示例值 |
描述 |
ret_code
|
String |
|
|
remark
|
String |
|
|
orderNum
|
String |
|
|
backupOrderNum
|
String |
|
|
... |
返回示例:{
"showapi_res_code": 0,
"showapi_res_error": "",
"showapi_res_body": {
"ret_code": "0",
"remark": "请求成功!",
"orderNum": "",
"backupOrderNum": ""
}
}
乘客身份核验
接口地址:http://route.showapi.com/1651-44 (注意:接口支持https,更安全,但稍慢一些,你懂的。请根据自己的情况进行选择。)
支持格式:json
请求方法:HTTP协议,支持GET/POST方法。
二、请求参数/
Request parameter
非文件上传的POST时,enctype=application/x-www-form-urlencoded。
文件上传的POST时,enctype=multipart/form-data。
1、系统级参数(所有接入点都需要的参数):
参数名称 |
类型 |
示例值 |
必须 |
描述 |
showapi_appid |
String |
100 |
是 |
易源应用id |
showapi_sign |
String |
698d51a19d8a121ce581499d7b701668 |
是 |
为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。
可选,在url后带上appid和secret即可
|
showapi_timestamp |
String |
20141114142239 |
否 |
客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。
|
showapi_res_gzip |
String |
1或0 |
否 |
返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩。 |
... |
2、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表):
参数名称 |
类型 |
默认值 |
示例值 |
必须 |
描述 |
idCard |
String |
|
|
是 |
|
name |
String |
|
|
是 |
|
请求示例:String res=new ShowApiRequest("http://route.showapi.com/1651-44","my_appId","my_appSecret")
.addTextPara("idCard","")
.addTextPara("name","")
.post();
System.out.println(res);
三、返回参数/
Return parameter
以JSON格式返回结果。
1、系统级参数(所有接入点都会返回的参数):
展开收起
名称 |
类型 |
示例值 |
描述 |
showapi_res_body |
String |
{"city":"昆明","prov":"云南"} |
消息体的JSON封装,所有应用级的返回参数将嵌入此对象 。 |
showapi_res_code |
int |
0 |
易源返回标志,0为成功,其他为失败。
0成功
-1,系统调用错误
-2,可调用次数或金额为0
-3,读取超时
-4,服务端返回数据解析错误
-5,后端服务器DNS解析错误
-6,服务不存在或未上线
-7, API创建者的网关资源不足
-1000,系统维护
-1002,showapi_appid字段必传
-1003,showapi_sign字段必传
-1004,签名sign验证有误
-1005,showapi_timestamp无效
-1006,app无权限调用接口
-1007,没有订购套餐
-1008,服务商关闭对您的调用权限
-1009,调用频率受限
-1010,找不到您的应用
-1011,子授权app_child_id无效
-1012,子授权已过期或失效
-1013,子授权ip受限
-1014,token权限无效
|
showapi_res_error |
String |
用户输入有误! |
错误信息的展示 |
showapi_res_id |
String |
ce135f6739294c63be0c021b76b6fbff |
本次请求id |
... |
2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构):
展开收起
名称 |
类型 |
示例值 |
描述 |
ret_code
|
String |
|
|
remark
|
String |
|
|
name
|
String |
|
|
status
|
String |
|
核验结果 succeed:核验通过,failed:核验失败,unknown:未知(乘客核验结果为 unknown 时,建议改乘客重新核验或放行通过)
|
... |
返回示例:{
"showapi_res_code": 0,
"showapi_res_error": "",
"showapi_res_body": {
"ret_code": "0",
"remark": "请求成功!",
"name": "",
"status": ""
}
}
订单占座结果查询
接口地址:http://route.showapi.com/1651-45 (注意:接口支持https,更安全,但稍慢一些,你懂的。请根据自己的情况进行选择。)
支持格式:json
请求方法:HTTP协议,支持GET/POST方法。
二、请求参数/
Request parameter
非文件上传的POST时,enctype=application/x-www-form-urlencoded。
文件上传的POST时,enctype=multipart/form-data。
1、系统级参数(所有接入点都需要的参数):
参数名称 |
类型 |
示例值 |
必须 |
描述 |
showapi_appid |
String |
100 |
是 |
易源应用id |
showapi_sign |
String |
698d51a19d8a121ce581499d7b701668 |
是 |
为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。
可选,在url后带上appid和secret即可
|
showapi_timestamp |
String |
20141114142239 |
否 |
客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。
|
showapi_res_gzip |
String |
1或0 |
否 |
返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩。 |
... |
2、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表):
展开收起
参数名称 |
类型 |
默认值 |
示例值 |
必须 |
描述 |
orderNum |
String |
|
|
否 |
|
backupOrderNum |
String |
|
|
否 |
|
passengerId |
String |
|
|
是 |
|
... |
请求示例:String res=new ShowApiRequest("http://route.showapi.com/1651-45","my_appId","my_appSecret")
.addTextPara("orderNum","")
.addTextPara("backupOrderNum","")
.addTextPara("passengerId","")
.post();
System.out.println(res);
三、返回参数/
Return parameter
以JSON格式返回结果。
1、系统级参数(所有接入点都会返回的参数):
展开收起
名称 |
类型 |
示例值 |
描述 |
showapi_res_body |
String |
{"city":"昆明","prov":"云南"} |
消息体的JSON封装,所有应用级的返回参数将嵌入此对象 。 |
showapi_res_code |
int |
0 |
易源返回标志,0为成功,其他为失败。
0成功
-1,系统调用错误
-2,可调用次数或金额为0
-3,读取超时
-4,服务端返回数据解析错误
-5,后端服务器DNS解析错误
-6,服务不存在或未上线
-7, API创建者的网关资源不足
-1000,系统维护
-1002,showapi_appid字段必传
-1003,showapi_sign字段必传
-1004,签名sign验证有误
-1005,showapi_timestamp无效
-1006,app无权限调用接口
-1007,没有订购套餐
-1008,服务商关闭对您的调用权限
-1009,调用频率受限
-1010,找不到您的应用
-1011,子授权app_child_id无效
-1012,子授权已过期或失效
-1013,子授权ip受限
-1014,token权限无效
|
showapi_res_error |
String |
用户输入有误! |
错误信息的展示 |
showapi_res_id |
String |
ce135f6739294c63be0c021b76b6fbff |
本次请求id |
... |
2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构):
展开收起
名称 |
类型 |
示例值 |
描述 |
ret_code
|
String |
|
|
remark
|
String |
|
|
remarkDetail
|
String |
|
|
orderNum
|
String |
|
|
backupOrderNum
|
String |
|
|
departStationEn
|
String |
|
|
departStation
|
String |
|
|
arrvialStationEn
|
String |
|
|
arrvialStation
|
String |
|
|
departTime
|
String |
|
|
arrivalTime
|
String |
|
|
trainNum
|
String |
|
|
ticketNum
|
String |
|
|
orderTotalPrice
|
String |
|
|
isChangedOrder
|
String |
|
|
originalOrderNum
|
String |
|
|
changedType
|
String |
|
改签类型,0:未改签,1:无差价,2:高改低(原票价高于改签后票价),3:低改高(原票价低于改签后票价)
|
serviceTotalCost
|
String |
|
|
changePriceDiff
|
String |
|
改签差价(已扣除改签手续费),正数表示需补充的差价,负数表示需退还的差价
|
ticketGate
|
String |
|
检票口信息(出票成功后有值+非100%获取到检票口信息)
|
expireTime
|
String |
|
订单过期时间 yyyy-MM-dd HH:mm:ss
|
isSelfToPurchase
|
String |
|
|
passengers
|
Object[] |
|
|
-
passengerName
|
String |
|
|
-
passengerType
|
String |
|
|
-
idType
|
String |
|
|
-
idCard
|
String |
|
|
-
passengerId
|
String |
|
|
-
seatType
|
String |
|
|
-
seatNo
|
String |
|
|
-
ticketPrice
|
String |
|
|
-
pTicketNo
|
String |
|
|
-
insurePrice
|
String |
|
|
... |
返回示例:{
"showapi_res_code": 0,
"showapi_res_error": "",
"showapi_res_body": {
"ret_code": "0",
"remark": "",
"remarkDetail": "",
"orderNum": "",
"backupOrderNum": "",
"departStationEn": "",
"departStation": "",
"arrvialStationEn": "",
"arrvialStation": "",
"departTime": "",
"arrivalTime": "",
"trainNum": "",
"ticketNum": "",
"orderTotalPrice": "",
"isChangedOrder": "",
"originalOrderNum": "",
"changedType": "",
"serviceTotalCost": "",
"changePriceDiff": "",
"ticketGate": "",
"expireTime": "",
"isSelfToPurchase": "",
"passengers": ""
}
}
订单出票信息查询
接口地址:http://route.showapi.com/1651-46 (注意:接口支持https,更安全,但稍慢一些,你懂的。请根据自己的情况进行选择。)
支持格式:json
请求方法:HTTP协议,支持GET/POST方法。
二、请求参数/
Request parameter
非文件上传的POST时,enctype=application/x-www-form-urlencoded。
文件上传的POST时,enctype=multipart/form-data。
1、系统级参数(所有接入点都需要的参数):
参数名称 |
类型 |
示例值 |
必须 |
描述 |
showapi_appid |
String |
100 |
是 |
易源应用id |
showapi_sign |
String |
698d51a19d8a121ce581499d7b701668 |
是 |
为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。
可选,在url后带上appid和secret即可
|
showapi_timestamp |
String |
20141114142239 |
否 |
客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。
|
showapi_res_gzip |
String |
1或0 |
否 |
返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩。 |
... |
2、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表):
参数名称 |
类型 |
默认值 |
示例值 |
必须 |
描述 |
orderNum |
String |
|
|
否 |
|
backupOrderNum |
String |
|
|
否 |
|
请求示例:String res=new ShowApiRequest("http://route.showapi.com/1651-46","my_appId","my_appSecret")
.addTextPara("orderNum","")
.addTextPara("backupOrderNum","")
.post();
System.out.println(res);
三、返回参数/
Return parameter
以JSON格式返回结果。
1、系统级参数(所有接入点都会返回的参数):
展开收起
名称 |
类型 |
示例值 |
描述 |
showapi_res_body |
String |
{"city":"昆明","prov":"云南"} |
消息体的JSON封装,所有应用级的返回参数将嵌入此对象 。 |
showapi_res_code |
int |
0 |
易源返回标志,0为成功,其他为失败。
0成功
-1,系统调用错误
-2,可调用次数或金额为0
-3,读取超时
-4,服务端返回数据解析错误
-5,后端服务器DNS解析错误
-6,服务不存在或未上线
-7, API创建者的网关资源不足
-1000,系统维护
-1002,showapi_appid字段必传
-1003,showapi_sign字段必传
-1004,签名sign验证有误
-1005,showapi_timestamp无效
-1006,app无权限调用接口
-1007,没有订购套餐
-1008,服务商关闭对您的调用权限
-1009,调用频率受限
-1010,找不到您的应用
-1011,子授权app_child_id无效
-1012,子授权已过期或失效
-1013,子授权ip受限
-1014,token权限无效
|
showapi_res_error |
String |
用户输入有误! |
错误信息的展示 |
showapi_res_id |
String |
ce135f6739294c63be0c021b76b6fbff |
本次请求id |
... |
2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构):
展开收起
名称 |
类型 |
示例值 |
描述 |
ret_code
|
String |
|
|
remark
|
String |
|
|
orderNum
|
String |
|
|
backupOrderNum
|
String |
|
|
issueTime
|
String |
|
|
ticketGate
|
String |
|
|
... |
返回示例:{
"showapi_res_code": 0,
"showapi_res_error": "",
"showapi_res_body": {
"ret_code": "0",
"remark": "查询成功!",
"orderNum": "",
"backupOrderNum": "",
"issueTime": "",
"ticketGate": ""
}
}
订单过期查询
接口地址:http://route.showapi.com/1651-49 (注意:接口支持https,更安全,但稍慢一些,你懂的。请根据自己的情况进行选择。)
支持格式:json
请求方法:HTTP协议,支持GET/POST方法。
二、请求参数/
Request parameter
非文件上传的POST时,enctype=application/x-www-form-urlencoded。
文件上传的POST时,enctype=multipart/form-data。
1、系统级参数(所有接入点都需要的参数):
参数名称 |
类型 |
示例值 |
必须 |
描述 |
showapi_appid |
String |
100 |
是 |
易源应用id |
showapi_sign |
String |
698d51a19d8a121ce581499d7b701668 |
是 |
为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。
可选,在url后带上appid和secret即可
|
showapi_timestamp |
String |
20141114142239 |
否 |
客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。
|
showapi_res_gzip |
String |
1或0 |
否 |
返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩。 |
... |
2、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表):
参数名称 |
类型 |
默认值 |
示例值 |
必须 |
描述 |
orderNum |
String |
|
|
否 |
|
backupOrderNum |
String |
|
|
否 |
|
请求示例:String res=new ShowApiRequest("http://route.showapi.com/1651-49","my_appId","my_appSecret")
.addTextPara("orderNum","")
.addTextPara("backupOrderNum","")
.post();
System.out.println(res);
三、返回参数/
Return parameter
以JSON格式返回结果。
1、系统级参数(所有接入点都会返回的参数):
展开收起
名称 |
类型 |
示例值 |
描述 |
showapi_res_body |
String |
{"city":"昆明","prov":"云南"} |
消息体的JSON封装,所有应用级的返回参数将嵌入此对象 。 |
showapi_res_code |
int |
0 |
易源返回标志,0为成功,其他为失败。
0成功
-1,系统调用错误
-2,可调用次数或金额为0
-3,读取超时
-4,服务端返回数据解析错误
-5,后端服务器DNS解析错误
-6,服务不存在或未上线
-7, API创建者的网关资源不足
-1000,系统维护
-1002,showapi_appid字段必传
-1003,showapi_sign字段必传
-1004,签名sign验证有误
-1005,showapi_timestamp无效
-1006,app无权限调用接口
-1007,没有订购套餐
-1008,服务商关闭对您的调用权限
-1009,调用频率受限
-1010,找不到您的应用
-1011,子授权app_child_id无效
-1012,子授权已过期或失效
-1013,子授权ip受限
-1014,token权限无效
|
showapi_res_error |
String |
用户输入有误! |
错误信息的展示 |
showapi_res_id |
String |
ce135f6739294c63be0c021b76b6fbff |
本次请求id |
... |
2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构):
展开收起
名称 |
类型 |
示例值 |
描述 |
ret_code
|
String |
|
|
remark
|
String |
|
|
orderNum
|
String |
|
|
backupOrderNum
|
String |
|
|
... |
返回示例:{
"showapi_res_code": 0,
"showapi_res_error": "",
"showapi_res_body": {
"ret_code": "0",
"remark": "查询成功!",
"orderNum": "",
"backupOrderNum": ""
}
}
抢票单占座结果查询
接口地址:http://route.showapi.com/1651-47 (注意:接口支持https,更安全,但稍慢一些,你懂的。请根据自己的情况进行选择。)
支持格式:json
请求方法:HTTP协议,支持GET/POST方法。
二、请求参数/
Request parameter
非文件上传的POST时,enctype=application/x-www-form-urlencoded。
文件上传的POST时,enctype=multipart/form-data。
1、系统级参数(所有接入点都需要的参数):
参数名称 |
类型 |
示例值 |
必须 |
描述 |
showapi_appid |
String |
100 |
是 |
易源应用id |
showapi_sign |
String |
698d51a19d8a121ce581499d7b701668 |
是 |
为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。
可选,在url后带上appid和secret即可
|
showapi_timestamp |
String |
20141114142239 |
否 |
客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。
|
showapi_res_gzip |
String |
1或0 |
否 |
返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩。 |
... |
2、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表):
展开收起
参数名称 |
类型 |
默认值 |
示例值 |
必须 |
描述 |
orderNum |
String |
|
|
否 |
|
backupOrderNum |
String |
|
|
否 |
|
passengerId |
String |
|
|
是 |
|
... |
请求示例:String res=new ShowApiRequest("http://route.showapi.com/1651-47","my_appId","my_appSecret")
.addTextPara("orderNum","")
.addTextPara("backupOrderNum","")
.addTextPara("passengerId","")
.post();
System.out.println(res);
三、返回参数/
Return parameter
以JSON格式返回结果。
1、系统级参数(所有接入点都会返回的参数):
展开收起
名称 |
类型 |
示例值 |
描述 |
showapi_res_body |
String |
{"city":"昆明","prov":"云南"} |
消息体的JSON封装,所有应用级的返回参数将嵌入此对象 。 |
showapi_res_code |
int |
0 |
易源返回标志,0为成功,其他为失败。
0成功
-1,系统调用错误
-2,可调用次数或金额为0
-3,读取超时
-4,服务端返回数据解析错误
-5,后端服务器DNS解析错误
-6,服务不存在或未上线
-7, API创建者的网关资源不足
-1000,系统维护
-1002,showapi_appid字段必传
-1003,showapi_sign字段必传
-1004,签名sign验证有误
-1005,showapi_timestamp无效
-1006,app无权限调用接口
-1007,没有订购套餐
-1008,服务商关闭对您的调用权限
-1009,调用频率受限
-1010,找不到您的应用
-1011,子授权app_child_id无效
-1012,子授权已过期或失效
-1013,子授权ip受限
-1014,token权限无效
|
showapi_res_error |
String |
用户输入有误! |
错误信息的展示 |
showapi_res_id |
String |
ce135f6739294c63be0c021b76b6fbff |
本次请求id |
... |
2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构):
展开收起
名称 |
类型 |
示例值 |
描述 |
ret_code
|
String |
|
|
remark
|
String |
|
|
remarkDetail
|
String |
|
|
orderNum
|
String |
|
|
backupOrderNum
|
String |
|
|
departStationEn
|
String |
|
|
departStation
|
String |
|
|
arrvialStationEn
|
String |
|
|
arrvialStation
|
String |
|
|
departTime
|
String |
|
|
arrivalTime
|
String |
|
|
trainNum
|
String |
|
|
ticketNum
|
String |
|
|
orderTotalPrice
|
String |
|
|
isChangedOrder
|
String |
|
|
originalOrderNum
|
String |
|
|
changedType
|
String |
|
改签类型,0:未改签,1:无差价,2:高改低(原票价高于改签后票价),3:低改高(原票价低于改签后票价)
|
serviceTotalCost
|
String |
|
|
changePriceDiff
|
String |
|
改签差价(已扣除改签手续费),正数表示需补充的差价,负数表示需退还的差价
|
ticketGate
|
String |
|
检票口信息(出票成功后有值+非100%获取到检票口信息)
|
expireTime
|
String |
|
订单过期时间 yyyy-MM-dd HH:mm:ss
|
isSelfToPurchase
|
String |
|
|
passengers
|
Object[] |
|
|
-
passengerName
|
String |
|
|
-
passengerType
|
String |
|
|
-
idType
|
String |
|
|
-
idCard
|
String |
|
|
-
passengerId
|
String |
|
|
-
seatType
|
String |
|
|
-
seatNo
|
String |
|
|
-
ticketPrice
|
String |
|
|
-
pTicketNo
|
String |
|
|
-
insurePrice
|
String |
|
|
... |
返回示例:{
"showapi_res_code": 0,
"showapi_res_error": "",
"showapi_res_body": {
"ret_code": "0",
"remark": "查询成功!",
"remarkDetail": "",
"orderNum": "",
"backupOrderNum": "",
"departStationEn": "",
"departStation": "",
"arrvialStationEn": "",
"arrvialStation": "",
"departTime": "",
"arrivalTime": "",
"trainNum": "",
"ticketNum": "",
"orderTotalPrice": "",
"isChangedOrder": "",
"originalOrderNum": "",
"changedType": "",
"serviceTotalCost": "",
"changePriceDiff": "",
"ticketGate": "",
"expireTime": "",
"isSelfToPurchase": "",
"passengers": ""
}
}
抢票单出票信息查询
接口地址:http://route.showapi.com/1651-48 (注意:接口支持https,更安全,但稍慢一些,你懂的。请根据自己的情况进行选择。)
支持格式:json
请求方法:HTTP协议,支持GET/POST方法。
二、请求参数/
Request parameter
非文件上传的POST时,enctype=application/x-www-form-urlencoded。
文件上传的POST时,enctype=multipart/form-data。
1、系统级参数(所有接入点都需要的参数):
参数名称 |
类型 |
示例值 |
必须 |
描述 |
showapi_appid |
String |
100 |
是 |
易源应用id |
showapi_sign |
String |
698d51a19d8a121ce581499d7b701668 |
是 |
为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。
可选,在url后带上appid和secret即可
|
showapi_timestamp |
String |
20141114142239 |
否 |
客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。
|
showapi_res_gzip |
String |
1或0 |
否 |
返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩。 |
... |
2、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表):
参数名称 |
类型 |
默认值 |
示例值 |
必须 |
描述 |
orderNum |
String |
|
|
否 |
|
backupOrderNum |
String |
|
|
否 |
|
请求示例:String res=new ShowApiRequest("http://route.showapi.com/1651-48","my_appId","my_appSecret")
.addTextPara("orderNum","")
.addTextPara("backupOrderNum","")
.post();
System.out.println(res);
三、返回参数/
Return parameter
以JSON格式返回结果。
1、系统级参数(所有接入点都会返回的参数):
展开收起
名称 |
类型 |
示例值 |
描述 |
showapi_res_body |
String |
{"city":"昆明","prov":"云南"} |
消息体的JSON封装,所有应用级的返回参数将嵌入此对象 。 |
showapi_res_code |
int |
0 |
易源返回标志,0为成功,其他为失败。
0成功
-1,系统调用错误
-2,可调用次数或金额为0
-3,读取超时
-4,服务端返回数据解析错误
-5,后端服务器DNS解析错误
-6,服务不存在或未上线
-7, API创建者的网关资源不足
-1000,系统维护
-1002,showapi_appid字段必传
-1003,showapi_sign字段必传
-1004,签名sign验证有误
-1005,showapi_timestamp无效
-1006,app无权限调用接口
-1007,没有订购套餐
-1008,服务商关闭对您的调用权限
-1009,调用频率受限
-1010,找不到您的应用
-1011,子授权app_child_id无效
-1012,子授权已过期或失效
-1013,子授权ip受限
-1014,token权限无效
|
showapi_res_error |
String |
用户输入有误! |
错误信息的展示 |
showapi_res_id |
String |
ce135f6739294c63be0c021b76b6fbff |
本次请求id |
... |
2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构):
展开收起
名称 |
类型 |
示例值 |
描述 |
ret_code
|
String |
|
|
remark
|
String |
|
|
orderNum
|
String |
|
|
backupOrderNum
|
String |
|
|
issueTime
|
String |
|
|
ticketGate
|
String |
|
|
... |
返回示例:{
"showapi_res_code": 0,
"showapi_res_error": "",
"showapi_res_body": {
"ret_code": "0",
"remark": "查询成功!",
"orderNum": "",
"backupOrderNum": "",
"issueTime": "",
"ticketGate": ""
}
}
退款结果查询
接口地址:http://route.showapi.com/1651-50 (注意:接口支持https,更安全,但稍慢一些,你懂的。请根据自己的情况进行选择。)
支持格式:json
请求方法:HTTP协议,支持GET/POST方法。
二、请求参数/
Request parameter
非文件上传的POST时,enctype=application/x-www-form-urlencoded。
文件上传的POST时,enctype=multipart/form-data。
1、系统级参数(所有接入点都需要的参数):
参数名称 |
类型 |
示例值 |
必须 |
描述 |
showapi_appid |
String |
100 |
是 |
易源应用id |
showapi_sign |
String |
698d51a19d8a121ce581499d7b701668 |
是 |
为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。
可选,在url后带上appid和secret即可
|
showapi_timestamp |
String |
20141114142239 |
否 |
客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。
|
showapi_res_gzip |
String |
1或0 |
否 |
返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩。 |
... |
2、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表):
展开收起
参数名称 |
类型 |
默认值 |
示例值 |
必须 |
描述 |
orderNum |
String |
|
|
否 |
|
backupOrderNum |
String |
|
|
否 |
|
passengerId |
String |
|
|
是 |
|
... |
请求示例:String res=new ShowApiRequest("http://route.showapi.com/1651-50","my_appId","my_appSecret")
.addTextPara("orderNum","")
.addTextPara("backupOrderNum","")
.addTextPara("passengerId","")
.post();
System.out.println(res);
三、返回参数/
Return parameter
以JSON格式返回结果。
1、系统级参数(所有接入点都会返回的参数):
展开收起
名称 |
类型 |
示例值 |
描述 |
showapi_res_body |
String |
{"city":"昆明","prov":"云南"} |
消息体的JSON封装,所有应用级的返回参数将嵌入此对象 。 |
showapi_res_code |
int |
0 |
易源返回标志,0为成功,其他为失败。
0成功
-1,系统调用错误
-2,可调用次数或金额为0
-3,读取超时
-4,服务端返回数据解析错误
-5,后端服务器DNS解析错误
-6,服务不存在或未上线
-7, API创建者的网关资源不足
-1000,系统维护
-1002,showapi_appid字段必传
-1003,showapi_sign字段必传
-1004,签名sign验证有误
-1005,showapi_timestamp无效
-1006,app无权限调用接口
-1007,没有订购套餐
-1008,服务商关闭对您的调用权限
-1009,调用频率受限
-1010,找不到您的应用
-1011,子授权app_child_id无效
-1012,子授权已过期或失效
-1013,子授权ip受限
-1014,token权限无效
|
showapi_res_error |
String |
用户输入有误! |
错误信息的展示 |
showapi_res_id |
String |
ce135f6739294c63be0c021b76b6fbff |
本次请求id |
... |
2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构):
展开收起
名称 |
类型 |
示例值 |
描述 |
ret_code
|
String |
|
|
remark
|
String |
|
|
orderNum
|
String |
|
|
backupOrderNum
|
String |
|
|
refundTime
|
String |
|
|
refundType
|
String |
|
|
passengers
|
Object[] |
|
|
-
passengerId
|
String |
|
|
-
passengerName
|
String |
|
|
-
passengerType
|
String |
|
|
-
idType
|
String |
|
|
-
idCard
|
String |
|
|
-
refundPrice
|
String |
|
|
-
pTicketNo
|
String |
|
|
refundPrice
|
String |
|
|
... |
返回示例:{
"showapi_res_code": 0,
"showapi_res_error": "",
"showapi_res_body": {
"ret_code": "0",
"remark": "查询成功!",
"orderNum": "",
"backupOrderNum": "",
"refundTime": "",
"refundType": "",
"passengers": "",
"refundPrice": ""
}
}
取消订单结果查询
接口地址:http://route.showapi.com/1651-53 (注意:接口支持https,更安全,但稍慢一些,你懂的。请根据自己的情况进行选择。)
支持格式:json
请求方法:HTTP协议,支持GET/POST方法。
二、请求参数/
Request parameter
非文件上传的POST时,enctype=application/x-www-form-urlencoded。
文件上传的POST时,enctype=multipart/form-data。
1、系统级参数(所有接入点都需要的参数):
参数名称 |
类型 |
示例值 |
必须 |
描述 |
showapi_appid |
String |
100 |
是 |
易源应用id |
showapi_sign |
String |
698d51a19d8a121ce581499d7b701668 |
是 |
为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。
可选,在url后带上appid和secret即可
|
showapi_timestamp |
String |
20141114142239 |
否 |
客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。
|
showapi_res_gzip |
String |
1或0 |
否 |
返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩。 |
... |
2、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表):
参数名称 |
类型 |
默认值 |
示例值 |
必须 |
描述 |
orderNum |
String |
|
|
否 |
|
backupOrderNum |
String |
|
|
否 |
|
请求示例:String res=new ShowApiRequest("http://route.showapi.com/1651-53","my_appId","my_appSecret")
.addTextPara("orderNum","")
.addTextPara("backupOrderNum","")
.post();
System.out.println(res);
三、返回参数/
Return parameter
以JSON格式返回结果。
1、系统级参数(所有接入点都会返回的参数):
展开收起
名称 |
类型 |
示例值 |
描述 |
showapi_res_body |
String |
{"city":"昆明","prov":"云南"} |
消息体的JSON封装,所有应用级的返回参数将嵌入此对象 。 |
showapi_res_code |
int |
0 |
易源返回标志,0为成功,其他为失败。
0成功
-1,系统调用错误
-2,可调用次数或金额为0
-3,读取超时
-4,服务端返回数据解析错误
-5,后端服务器DNS解析错误
-6,服务不存在或未上线
-7, API创建者的网关资源不足
-1000,系统维护
-1002,showapi_appid字段必传
-1003,showapi_sign字段必传
-1004,签名sign验证有误
-1005,showapi_timestamp无效
-1006,app无权限调用接口
-1007,没有订购套餐
-1008,服务商关闭对您的调用权限
-1009,调用频率受限
-1010,找不到您的应用
-1011,子授权app_child_id无效
-1012,子授权已过期或失效
-1013,子授权ip受限
-1014,token权限无效
|
showapi_res_error |
String |
用户输入有误! |
错误信息的展示 |
showapi_res_id |
String |
ce135f6739294c63be0c021b76b6fbff |
本次请求id |
... |
2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构):
展开收起
名称 |
类型 |
示例值 |
描述 |
ret_code
|
String |
|
|
remark
|
String |
|
|
orderNum
|
String |
|
|
backupOrderNum
|
String |
|
|
cancelTime
|
String |
|
|
... |
返回示例:{
"showapi_res_code": 0,
"showapi_res_error": "",
"showapi_res_body": {
"ret_code": "0",
"remark": "查询成功!",
"orderNum": "",
"backupOrderNum": "",
"cancelTime": ""
}
}
服务商介绍:易源数据是昆明秀派科技有限公司旗下的大数据生产、交易、流通平台。
易源数据通过打破资源壁垒,搭建起数据资源的基础设施,将接口纳入统一的接口池,把多个异构数据源合并到同一根管线上,以统一的访问和控制方式,对外提供统一格式的数据。
让开发者可以像搭积木一样通过各种API操纵资源。
截至2017年12月,平台已经拥有API接口230个,日调用量2000万,覆盖全网10万+真实消费者,为超过3000+的企业用户提供全域数据服务。
联系方式:
电话: 4009988033
微博: http://www.weibo.com/showapi
邮箱: services@showapi.com
QQ: 3007663665
微信: show_api
进制数据介绍:
企业和程序员可以通过进制数据封装的API或SDK极速接入其他数据资源,同时进制数据提供数据交易等服务。通过进制数据,不仅开发成本极大降低,而且可以获得其他丰富的数据服务:数据交易,数据分析,区块链Token管理等服务。
联系我们:
电话:173-6457-5198
QQ① 群:792473404
客服 QQ:1643296538
微信客服:binstds
扫描二维码添加客服微信
工作时间:
周一至周五 9:00 - 21:00(其中周三为 9:00 - 18:00)
周六 9:00 - 12:00(节假日除外)
进制数据团队
2020.01.01