文档
测试

10.绑定虚拟号

websocket测试
POST
api_method:u-order-bindVirtualPhone

接口描述

提示用户是否当前号码=订单详情中绑定的虚拟号,如果不是则需要重新绑定

服务入口:

测试环境:https://openapi-stg.huolala.cn/v1 正式环境:https://openapi.huolala.cn/v1

调用注意事项

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
接口方法
必填
api_version
string
接口版本，固定值:1.0
必填
app_key
string
应用唯一app_key
必填
access_token
string
用户账户授权访问令牌
必填
nonce_str
string
随机数,用户自定义,60s内不可重复使用,用于确保请求不可重复
必填
timestamp
number
unix时间戳(单位:秒),时间戳应为60s内的值,超过60s则超时
必填
signature
string
签名值
必填

应用级请求参数

参数名
类型
描述
必填
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 { "app_key":"*******************", "nonce_str":"12348", "timestamp":1574822548, "access_token":"********************", "order_display_id":"324700601039", "user_phone_no":"15898998989" } ```

返回json示例:

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

返回状态码说明

|ret状态码|描述| |-|-| |0|成功| |30012|订单id错误| |31001|司机还未接单| |31002|绑定失败| |31003|订单已改变,绑定失败|
上一篇 9.查询订单详情
nextDoc 11.支付司机账单
本文档使用易文档编写, 更新时间: 2020-05-26 09:18