司乘重联
功能: 行程结束后24小时内,请求司乘号码保护联系通道重建
支持运力: private-car,express-car,taxi
资源URL
POST: v1/orders/{didi_oid}/reconnect
请求参数:
参数名 | 类型 | 说明 |
---|---|---|
didi_oid | string | 行程ID |
请求示例:
curl -X POST
-H "Content-Type: application/json"
-H "Authorization: Bearer domain|{access_token}"
"https://api.xiaojukeji.com/v1/orders/{didi_oid}/reconnect"
返回参数说明:
参数名 | 类型 | 说明 |
---|---|---|
phone_encrypt | string | 加密后的虚拟订单号 |
connection_type | int | 1: 延长的常规号码保护 2:司乘重联的号码保护 |
expire_time | int | 本次司乘重联过期时间戳(connection_type=1时无) |
left_times | int | 司乘重联剩余重试次数(connection_type=1时无) |
返回示例:
成功:http status 200
延长的常规号码保护
{
"phone_encrypt": "3Q2BRP34D4901A7517B901C49EA1|1",
"connection_type": 1
}
司乘重联的号码保护
{
"phone_encrypt": "3Q2BRP34D4901A7517B901C49EA1|1",
"connection_type": 2,
"expire_time": 15402639790,
"left_times": 3
}
失败:http status 非200
接入方没有开通权限
{
"errno": "67001",
"errmsg": "司乘重联失败,未完成行程"
}
未完成行程
{
"errno": "67002",
"errmsg": "司乘重联失败,结束行程超过24小时过期"
}
结束行程超过24小时过期
{
"errno": "67003",
"errmsg": "司乘重联失败,单笔订单超过最大重联次数"
}
单笔订单超过最大重联次数
{
"error": "code(40314)",
"error_detail": "auth check failed, method not allowed"
}