文档
测试

10.绑定虚拟号

POST
api_method:u-order-bindVirtualPhone

调用注意事项

1.什么是虚拟号? 答:当用户下单时,用了保护用户隐私。我们将不对司机展示用户真实号码。并且不对用户展示司机真实号码。 - 用户号码生成一个虚拟号,司机号码也生成一个虚拟号 - 用户虚拟号与司机虚拟号之间一一映射 - 只有用户对应的号码,可拨通司机对应的虚拟号 2.什么情况下会生成虚拟号? 答:当用户下单后,我们默认已经生成并绑定了虚拟号 3.开发者如何判断用户哪个手机号可拨通司机的哪个虚拟号? 答: 答:开发者可在司机接单后,调订单详情接口。从接口中获取接单司机信息“driver_info". - 其中参数phone_no_type代表司机的号码是不是虚拟号。如果是虚拟号,则只有下单人侧指定的号码可拨通司机虚拟号 - 其中参数“phone_no”代表了司机号码 - 其中参数user_bind_phone_no代表下单人侧,只有这个号码才能拨通司机的虚拟号phone_no 4.这个接口绑定虚拟号啥意思?什么时候调? 答:当用户需要拨打司机虚拟号时,开发者应用应先判断司机号码phone_no_type是不是虚拟号? - 是,则弹出界面询问下单人,下单人号码是不是user_bind_phone_no。如果用户选择不是,则需要重新绑定用户的号码,绑定成功后,会根据用户新绑定的手机号,生成一个司机侧新的虚拟号。需取返回值中新的司机号码进行拨打 - 否,则不用弹出界面,直接拨打

编码

++数据编码:++ Accept:application/json Content-type: application/json ++字符编码:++ utf-8

前端UI界面展示示例:

![image.png](https://cos.easydoc.net/48578360/files/k944jery)

系统级请求参数

参数名
类型
描述
必填
api_method
string
接口方法名。请传“u-order-bindVirtualPhone”
必填
api_version
string
接口版本号。请传固定值“1.0”
必填
app_key
string
开发者应用唯一app_key
必填
access_token
string
用户账户授权访问令牌
必填
nonce_str
string
随机数,用户自定义,60s内不可重复使用,用于确保请求不可重复
必填
timestamp
number
unix时间戳(单位:秒),时间戳应为60s内的值,超过60s则超时
必填
signature
string
签名值
必填

应用级请求参数(api_data数据结构)

参数名
类型
描述
必填
order_display_id
string
货拉拉订单号
必填
user_phone_no
string
用户需更换绑定的手机号
必填

响应参数

参数名
类型
描述
必填
ret
number
返回结果码,示例:0
必填
msg
string
返回结果中文描述,示例:
必填
data
object
数据字典
必填
phone_no_type
number
号码类型: 1-真实号码, 2-虚拟号
必填
phone_no
string
电话号码,虚拟号或者司机真实号码
必填

请求json示例:

```json { "api_method":"u-order-bindVirtualPhone", "api_version":"1.0", "app_key":"*****************", "access_token":"**********************", "signature":"*******************", "nonce_str":"8sZD2c7raj", "timestamp":1564022849, "api_data":"{ \"order_display_id\":\"324700601039\", \"user_phone_no\":\"15898998989\" }" } ```

返回json示例:

```json { "ret":0, "msg":"", "data":{ "phone_no_type":1, "phone_no":"15898998989" } } ```

返回状态码说明

|ret状态码|描述| |-|-| |0|成功| |300012|订单id错误| |31001|司机还未接单| |31002|绑定失败| |31003|订单已改变,绑定失败|