GetChangeDateBusOrder取得直通车订单中可改期的信息
接口说明
HTTPS请求方式:POST
url:https://dllyfw.com/OpenApi/GetChangeDateBusOrder
使用调试工具调试该接口
因为一个直通车订单,可分为往返线路,线路中可能又包含中转班次,而订单又分全票、半票、特惠票三种。
因此,必须把这些信息都展示给用户,让用户来选择改期的线路、时间和班次。
对接方需要提供类似于下面的页面给用户进行操作选择:
参数说明
参数 |
类型 |
长度 |
可空 |
描述 |
apiKey |
string |
32 |
否 |
由官方平台提供的apiKey |
number |
string |
20 |
否 |
订单number |
sign |
string |
32 |
否 |
由apiSecret,与参数number生成的待签名字符串,通过MD5签名运算后的值。
签名规则
|
返回说明
Json格式的Result对象
{
"ErrorCode": 0,
"Success": true,
"Message": null,
"HasException": false,
"Value": [
{
"SectionId": 221786,
"OrderItemId": 420066,
"ProductId": 5,
"Tel": "13558842667",
"Title": "[全](武侯祠/锦里→熊猫繁育中心)直通车+讲解券+熊猫门票",
"Date": "2015-07-31",
"Schedule": "08:30",
"BusLineSectionList": [
{
"Id": 1,
"BusLineId": 1,
"DepartId": 1,
"ArriveId": 2,
"DepartName": "武侯祠/锦里",
"ArriveName": "熊猫繁育中心",
"Date": "2015-07-31",
"ElapsedTime": "45分钟",
"Distance": "25公里",
"Schedules": [
{
"Schedule": "08:30",
"Seats": 33,
"OccupiedSeats": 1
},
..
]
}
]
},
..
}
],
"Tag": null
}
返回值 |
描述 |
Success |
本次调用是否成功 |
ErrorCode |
错误代码 |
Message |
失败时为异常信息,成功时为null |
Value |
Json格式的BusLineSectionList对象列表:
Id:当前线路中线段的Id
BusLineId:线路Id
DepartId:始发站的站点Id
ArriveId:终点站的站点Id
DepartName:始发站的名称(展示用)
ArriveName:终点站的名称(展示用)
Date:原出行日期(加载到日期选择框)
Schedule:原所选班次(选中到班次下拉框)
|
Tag |
如无特别说明,在返回数据带分页的情况下,Tag一般指查询记录的总条数,其它情况为null |
GetChangeDateSchedulesSchedules取得改期订单的班次
接口说明
http请求方式:POST
url:http://dllyfw.com/OpenApi/GetChangeDateSchedulesSchedules
使用调试工具调试该接口
每一天的排班情况不同,因此会根据改期的不同日期来获取当天的可用班次。
对接方需要实现日期的change事件,同步回调此函数,来重新绑定班次下拉框,下图仅提供参考:
参数说明
参数 |
类型 |
长度 |
可空 |
描述 |
apiKey |
string |
32 |
否 |
由官方平台提供的apiKey |
buslineId |
int |
4 |
否 |
线路Id |
date |
datetime |
|
否 |
日期(yyyy-MM-dd) |
productId |
int |
4 |
否 |
产品Id |
departId |
int |
4 |
否 |
始发站的站点Id |
arriveId |
int |
4 |
否 |
终点站的站点Id |
sign |
string |
32 |
否 |
由apiSecret,与参数buslineId、date、productId、departId、arriveId生成的待签名字符串,通过MD5签名运算后的值。
签名规则
|
以上参数均可以从第一步中的返回值中获取 |
返回说明
Json格式的Result对象
{
"ErrorCode": 0,
"Success": true,
"Message": null,
"HasException": false,
"Value": [
{
"Schedule": "09:00",
"Seats": 20,
"OccupiedSeats": 5
},
{
"Schedule": "09:30",
"Seats": 20,
"OccupiedSeats": 0
},
{
"Schedule": "10:00",
"Seats": 26,
"OccupiedSeats": 0
},
{
......
}
],
"Tag": null
}
返回值 |
描述 |
Success |
本次调用是否成功 |
ErrorCode |
错误代码 |
Message |
失败时为异常信息,成功时为null |
Value |
Json格式的Schedule对象列表:
Schedule:班次
Seats:总座位数
OccupiedSeats:已占用座位数
|
Tag |
如无特别说明,在返回数据带分页的情况下,Tag一般指查询记录的总条数,其它情况为null |
BusOrderChangeDate提交改期
接口说明
http请求方式:POST
url:http://dllyfw.com/OpenApi/BusOrderChangeDate
使用调试工具调试该接口
最后一步,当改期的日期和班次都选择好之后,提交改期请求。
对接方可根据需要来确定是否使用[短信通知改期]的功能,电话号码如果没有填写,我们则从订单里读取:
参数说明
参数 |
类型 |
长度 |
可空 |
描述 |
apiKey |
string |
32 |
否 |
由官方平台提供的apiKey |
changedOrder |
|
|
|
Json格式的changedOrder对象,请参见Demo |
isSendSms |
int |
4 |
否 |
值为1或者0,1=true |
tel |
string |
30 |
否 |
客人电话 |
sign |
string |
32 |
否 |
由apiSecret,与参数buslineId、date、productId、departId、arriveId生成的待签名字符串,通过MD5签名运算后的值。
签名规则
|
以上参数均可以从第二步中的返回值中获取 |
返回说明
Json格式的Result对象
{
"ErrorCode": 0,
"Success": true,
"Message": null,
"HasException": false,
"Value": [
{
"Schedule": "09:00",
"Seats": 20,
"OccupiedSeats": 5
},
{
"Schedule": "09:30",
"Seats": 20,
"OccupiedSeats": 0
},
{
"Schedule": "10:00",
"Seats": 26,
"OccupiedSeats": 0
},
{
......
}
],
"Tag": null
}
返回值 |
描述 |
Success |
本次调用是否成功 |
ErrorCode |
错误代码 |
Message |
失败时为异常信息,成功时为null |
Value |
Json格式的Schedule对象列表:
Schedule:班次
Seats:总座位数
OccupiedSeats:已占用座位数
|
Tag |
如无特别说明,在返回数据带分页的情况下,Tag一般指查询记录的总条数,其它情况为null |