# 修改联系信息
# 简介
用于在订单接到乘客前,修改当前订单的叫车人或者乘车人信息。
- 若下单接口使用的为真实号,则真实号必传
- 若下单接口使用的为虚拟号,则虚拟号和带掩码的真实号必传
# 服务提供方
享道
# 接口URL
/openapi/contact/modify
# 请求方式
POST
# 请求频次
单次
# 请求参数
参数名称 | 类型 | 必选 | 说明 |
---|---|---|---|
timestamp | long | 是 | 请求时间,Unix Timestamp单位毫秒 |
oid | string | 是 | 合作方订单id |
order_id | string | 是 | 享道订单id |
actual_phone | string | 否 | 真实手机号,11位数字,不含特殊符号 |
virtual_phone | string | 否 | 虚拟号 |
mask_phone | string | 否 | 掩码手机号,11位字符,最后4位必须为数字,如:132****2222 |
target | int | 否 | 代叫单必传,更新目标 0-叫车人 1-乘车人 |
# 响应参数
参数名称 | 类型 | 必有 | 说明 |
---|---|---|---|
errCode | int | 是 | 服务响应状态,参见附录5 |
errMsg | string | 是 | 服务响应状态说明,参见附录5 |
content | object | 是 | |
content.driver_phone | string | 是 | 重新绑定的司机虚拟号 |
# 请求示例
请求
curl --location --request POST 'https://open-sit.saicmobility.com/merchant/v1/openapi/contact/modify' \
--header 'X-Sign: f79f59997530992a9849f8bf9b0018c0f9254a80' \
--header 'X-SignAlgorithm: 1' \
--header 'X-Timestamp: 20201020193600' \
--header 'X-MerchantId: xxx' \
--header 'Content-Type: application/json' \
--data-raw '{"timestamp":1603192859627,"order_id":"U4b3w6n9w11e646041c0114128add91397193c0e66","oid":"Tessm6g2nhb1l5qgu64upcbanfvhy32g5xt7","actual_phone":"xxx","mask_phone":"xxx"}'
响应
{
"errCode": 10000,
"errMsg": "successful",
"content": {
"driver_phone": "xxx"
}
}