司机状态推送接口
更新时间: 2022-10-17 必须接入 在线调试(沙箱环境)
接口概述
1、该接口用来在接单后推送司机状态信息,当供应商未收到携程的响应结果时应主动发起重试,最多重试三次,每次间隔5秒。
2、请供应商要求司机按顺序操作行程,携程会校验司机状态的推送顺序。
3、特别地,立即打车场景下,司机接单后系统即认为已出发接乘客,可以不推该状态,但预约打车是要推的。
请求地址
地址格式: {Domain}/{Channel}-{vendorId}/driver/inplace/2.0/{ctripPurchaseOrderID}/{timeStamp}/{sign}
请求内容
PushDriverStatusRequest
参数 | 类型 | 必传 | 描述 | 示例 | 备注 |
---|---|---|---|---|---|
ctripPurchaseOrderID | Long | 是 | 携程采购单号 | 881823967638342968 | 18位 |
vendorOrderID | String | 是 | 供应商订单id | ||
vehicleStatus | Integer | 是 | 司机状态 | 1 | 司机状态列表 |
返回内容
PushDriverStatusResponse
参数 | 类型 | 必传 | 描述 | 示例 | 备注 |
---|---|---|---|---|---|
msgCode | String | 是 | 响应码 | OK | 响应码 |
message | String | 否 | 响应详情 | 成功 | 响应码 |
请求示例
{
"ctripPurchaseOrderID": 881824212456774814,
"vendorOrderID": "1232423",
"vehicleStatus": 1
}
响应示例
{
"msgCode": "OK",
"message": "成功",
}
异常示例
{
"msgCode": "ERROR_NO_ORDERID",
"message": "找不到订单"
}