修改目的地和途经点
接口说明
- 修改目的地+途经点最多修改5次.
- 行程中更改目的地接口,没被删除的途经点都传.
- 允许修改的订单状态为15(司机接单accepted)<=status<=30(行程中in_progress)
接口地址
https:// <Partner_DOMAIN>/<CallBackURL>
请求方式
POST
请求参数
名称 |
类型 |
是否必输 |
说明 |
sign |
String |
yes |
请求签名,根据签名生成规则计算 |
channel |
String |
yes |
渠道名称(由首汽约车给定) |
orderNo |
String |
yes |
首汽订单号 |
partnerOrderNo |
String |
yes |
合作方订单号 |
bookingEndAddr |
String |
yes |
到达地址 |
bookingEndShortAddr |
String |
yes |
到达短地址 |
bookingEndPointLo |
String |
yes |
下车地点经度坐标 |
bookingEndPointLa |
String |
yes |
下车地点纬度坐标 |
changeType |
Integer |
yes |
修改类型,1-修改途经点;2-修改目的地;3-同时修改, 为空则算作按照修改目的地 |
passingPoints |
String |
no |
途经点列表JSON字符串, change_type为1或3时有效, 目前只支持两个途经点,已经通过的不能修改或者删除
|
passingPoints请求参数
名称 |
类型 |
是否必选 |
说明 |
index |
int |
yes |
第几个途径点。1或2 |
status |
int |
yes |
0未前往,2.司机点击到达途径点 |
bookingPassingLng |
String |
yes |
途经点经度如:"118.59252" |
bookingPassingLat |
String |
yes |
途经点纬度如:"24.800137" |
bookingPassingPointAddr |
String |
yes |
途经点地址如:"晋江机场航站楼" |
bookingPassingPointShortAddr |
String |
no |
途经点短地址:"航站楼" |
返回参数
名称 |
类型 |
说明 |
result |
Integer |
0:成功;非0:失败原因编号 |
errmsg |
String |
失败原因描述,若成功则值为空,失败原因:见result与errmsg枚举 |
data |
Object |
返回数据, {"amount":"289.10","distance":"35.88","duration":"24"} |
data字段说明
名称 |
类型 |
说明 |
amount |
String |
修改后金额,单位元 |
distance |
String |
修改后距离 单位公里 |
duration |
String |
修改后时长 单位分钟 |
result与errmsg枚举:
result |
errmsg |
104 |
司机回家模式,暂不支持修改终点 |
105 |
司机暂不支持修改功能 |
106 |
途径点最多支持两个 |
107 |
该订单状态不支持修改途径点/终点 |
108 |
途径点已到达,不支持变更操作 |
109 |
修改失败 |
110 |
一口价订单不支持该项功能 |
111 |
途径点一已经到达,不支持变更操作 |
112 |
途径点二已经到达,不支持变更操作 |
113 |
途径点均已到达,不支持变更操作 |