火车票查询、订购

第三方服务商
价格:会员免费  
服务商: 万维易源
  • 产品介绍
  • 接口文档
  • 服务商
  • 官方客服

查询火车票查询(站站、余票等)、订购(预定、抢购等)、需要提前预充值金额,订购抢购时实时扣除费用 订购过程: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_appidString100易源应用id
showapi_signString698d51a19d8a121ce581499d7b701668为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。 可选,在url后带上appid和secret即可 
showapi_timestampString20141114142239客户端时间。 
格式yyyyMMddHHmmss,如20141114142239 
为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。 
showapi_res_gzipString1或0返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩。
...

2、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表): 展开收起 

参数名称类型默认值示例值必须描述
departStationString 上海出发地
arrivalStationString 北京目的地
dateString  出发日期(格式yyyyMMdd)
typeString 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_bodyString{"city":"昆明","prov":"云南"}消息体的JSON封装,所有应用级的返回参数将嵌入此对象 。
showapi_res_codeint0易源返回标志,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_errorString用户输入有误!错误信息的展示
showapi_res_idStringce135f6739294c63be0c021b76b6fbff本次请求id
...

2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构): 展开收起 

名称类型示例值描述
ret_code String0接口调用是否成功,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
G101
车次号
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
0
接口调用是否成功,0为成功,其他为失败
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
价格 返回0则表示该车次没有对应的座位席别
standbyTickets String
余票数量
bookingState String
是否可预订 1:不可预订 2:可预订
...
返回示例:{ "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
GD,D
车型(多个车型用英文逗号分隔)
sort String
排序顺序1:正序2:倒序
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
每页显示的条数,必需为整数(默认20,不能超过100)
page String
1
当前页数, 必需为整数,默认为1,不能超过总页数
...
请求示例: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
0
接口调用是否成功,0为成功,其他为失败
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
G101
车次
date String
20180801
查询日期
请求示例: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
0
接口调用是否成功,0为成功,其他为失败
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
G101
车次号
seatType String
1
座位类型(请于帮助文档对应)
departStation String
beijingnan
发车站
arrivalStation String
shanghaihongqiao
到达站
date String
20180801
发车日期
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
0
接口调用是否成功,0为成功,其他为失败
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
1
当前页码
maxResult String
20
每页显示的条数,必需为整数(默认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
0
接口调用是否成功,0为成功,其他为失败
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
10001
学校编号
ret_code String
0
接口调用是否成功,0为成功,其他为失败
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
34
城市编号
cityName String
哈尔滨
城市名称
ret_code String
0
接口调用是否成功,0为成功,其他为失败
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
0
接口调用是否成功,0为成功,其他为失败
remark String
查询成功!
提示信息
saleDays String
30
预售天数
...
返回示例:{ "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
G101
车次号
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
0
接口调用是否成功,0为成功,其他为失败
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
状态(1、有票,0、无票)
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
上海
出发站拼音code或中文
arrivalStation String
北京
到达站拼音code或中文
date String
20191018
出发时间,格式yyyyMMdd
trainNum String
G102
车次号
...
请求示例: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
17
可容纳人数
carriageNo String
1
车厢号
ret_code String
0
接口调用是否成功,0为成功,其他为失败
remark String
查询成功!
提示信息
isWifi String
1
是否有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
G102
车次号
stationType String
站点类型。0到达站 1出发站 默认0
...
请求示例: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
北京
出发站拼音code或中文
arrivalStation String
成都
到达站拼音code或中文
date String
20191015
出发时间,格式yyyyMMdd
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
32
中转等待时间(单位:分钟)
arrivalPlace String
成都市
到达城市
departPlace String
北京市
出发城市
departTime String
06:27
出发时间(hh:mm)
transferPlace String
西安市
中转城市
transferInfos Object[]
中转内容
0 Object
arrivalStation String
西安北
到达火车站
departStation String
北京西
出发火车站
trainNum String
G437
arrivalTime String
11:03
火车到达时间(hh:mm)
trainState String
1
是否有票(0:无票,1:有票)
departTime String
06:27
火车出发时间(hh:mm)
runTime String
276
运行时间(单位:分钟)
trainType String
GD
车次类型
date String
20191015
出发日期(yyyyMMdd)
tickets Object
车票信息(包含的对象里key之为座位类型英文,可在帮助文档对应)
businessseat Object
商务座
price String
1627.5
价格
seatState String
1
座位状态(0:无票,1:有票)
seats Number
2
座位数
seatName String
商务座
座位名称
totalTime Number
664
totalPrice Number
811
ret_code String
0
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
是否接受无座,0:不接受 1:接受
adultName String
乘客姓名(成人)
adultIdType String
1
证件类型(成人)1:身份证,2:护照,3:台胞证,4:港澳通行证(必填)
adultIdCard String
证件号(成人)
adultBirthday String
生日(成人)
adultGender String
性别 0女 1男(成人)
adultSeatType String
坐席类别(成人)
adultTicketPrice String
票面价(成人)
childBirthday String
生日(儿童)
childGender String
性别 0女 1男(儿童)
childSeatType String
坐席类别(儿童)
childTicketPrice String
票面价(儿童)
provinceCode String
学校所在省
schoolCode String
学校名称编号
studentNum String
学号
eductionalSystem String
学年(如4年制则填4)
enrollmentYear String
入学年份
preferentialDepartStationCode String
优惠区间(必须与学生证上的优惠区间一致)
preferentialArrivalStationCode String
优惠区间(必须与学生证上的优惠区间一致)
chooseSeats String
在线选座选择坐席,例:1A,两张1A1F
...
请求示例: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
0
接口调用是否成功,0为成功,其他为失败
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
请求key 查询站站查询接口可得到
trainNum String
车次号 ,如果有多车次请用“|”隔开
seatType String
座席代号,若有多坐席,请用“|”隔开
primaryTrainNum String
主车次,多车次或多坐席时必须指定
primarySeatClass String
主坐席,多车次或多坐席时必须指定
departStation String
出发车站中文
arrivalStation String
到达车站中文
departDate String
发车日期(yyyy-MM-dd HH:mm 其中‘HH:mm’为车次查询返回值获取departureTime) 多车次时,必须取最早发车车次的出发时间
acceptNoSeat String
是否接受无座,0:不接受 1:接受
robGrade String
抢票等级(1~5,1最低,5最高,不传默认最高)
backUpTicketTime String
备选日期(不包含主日期),最多5个
mobile String
联系人手机
name String
联系人姓名
email String
请填写参数描述
passengerName String
乘客姓名
idCardType String
0
证件类型 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
0
接口调用是否成功,0为成功,其他为失败
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
0
接口调用是否成功,0为成功,其他为失败
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
0
接口调用是否成功,0为成功,其他为失败
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
0
接口调用是否成功,0为成功,其他为失败
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
0
接口调用是否成功,0为成功,其他为失败
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
0
接口调用是否成功,0为成功,其他为失败
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
乘客Id
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
0
接口调用是否成功,0为成功,其他为失败
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
0
接口调用是否成功,0为成功,其他为失败
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
新调用站站查询得到的queryKey
seatType String
要改签的坐席类型
passengerId String
要改签的乘客Id
isChangeArrvialStation String
是否变更到达站 0:否;1:是 不填默认 0
passengerId2 String
要改签的乘客Id
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
0
接口调用是否成功,0为成功,其他为失败
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
发车时间(yyyy-MM-dd)
changeDepartStation String
改签后出发站(中文)
changeArrivalStation String
改签后到达站(中文)
changeDate String
改签后出发日期(yyyy-MM-dd)
isStudent String
是否学生票 1:是 0:不是
...
请求示例: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
0
remark String
判断成功!
isChangeArrvialStation String
0
改签类型 0:改签 1:变更到站
...
返回示例:{ "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
0
接口调用是否成功,0为成功,其他为失败
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
0
接口调用是否成功,0为成功,其他为失败
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
0
接口调用是否成功,0为成功,其他为失败
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
乘客Id
...
请求示例: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
0
接口调用是否成功,0为成功,其他为失败
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
是否改签单 0:正常订单,1:改签单
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
乘客Id
seatType String
坐席类别
seatNo String
座位号
ticketPrice String
车票单价
pTicketNo String
乘客票号
insurePrice String
保险费,默认0
...
返回示例:{ "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
0
接口调用是否成功,0为成功,其他为失败
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
0
接口调用是否成功,0为成功,其他为失败
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
乘客Id
...
请求示例: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
0
接口调用是否成功,0为成功,其他为失败
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
是否改签单 0:正常订单,1:改签单
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
乘客Id
seatType String
坐席类别
seatNo String
座位号
ticketPrice String
车票单价
pTicketNo String
乘客票号
insurePrice String
保险费,默认0
...
返回示例:{ "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
0
接口调用是否成功,0为成功,其他为失败
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
乘客Id
...
请求示例: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
0
接口调用是否成功,0为成功,其他为失败
remark String
查询成功!
提示信息
orderNum String
订单号
backupOrderNum String
备用订单号
refundTime String
退票时间
refundType String
退票类型 online:线上退票退款
passengers Object[]
乘客信息
passengerId String
乘客Id
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
0
接口调用是否成功,0为成功,其他为失败
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

 

 

 

 

 


其他服务商
热门API推荐
相关API推荐