站站查询

接口地址：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		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		备用改签订单号
...