# 获取司机虚拟号
# 简介
本接口用于合作方获取司机虚拟号。成单至完单均可进行获取。
# 服务提供方
享道
# 接口URL
/openapi/driver/virtualphone/query
# 请求方式
POST
# 请求频次
单次
# 请求参数
参数名称 | 类型 | 必选 | 说明 |
---|---|---|---|
timestamp | long | 是 | 请求时间,Unix Timestamp单位毫秒 |
order_id | string | 是 | 享道订单ID |
oid | string | 是 | 合作方订单ID |
phone | string | 否 | 绑定手机号或固话 |
duration | int | 否 | 绑定时长,默认 20分钟 |
passengerType | int | 否 | 获取虚拟号乘客类型,1代叫人(下单人), 2实际乘车人,不传默认是下单人 |
# 响应参数
参数名称 | 类型 | 必有 | 说明 |
---|---|---|---|
errCode | int | 是 | 服务响应状态,参见附录5 |
errMsg | string | 是 | 服务响应状态说明,参见附录5 |
content | object | 是 | |
content.phone | string | 是 | 司机虚拟号 |
# 请求示例
请求
curl --request POST \
--url https://open-sit.saicmobility.com/merchant/v1/openapi/driver/virtualphone/query \
--header 'content-type: application/json' \
--header 'x-merchantid: open_merchant_YBRlTU4dqZ2j4n5Z' \
--header 'x-sign: 11f4845e302a561fb036955365ae560f9d78490d' \
--header 'x-signalgorithm: 1' \
--header 'x-timestamp: 1603348931717' \
--data '{"appId":"open_app_uOzMWv59sDGCUC5t","merchantId":"open_merchant_YBRlTU4dqZ2j4n5Z","oid":"202010220467965006849000","order_id":"U4b3y6n9w1f1084f9a39164533a2fadb2535a0c448","timestamp":1603348931717}'
响应
{
"errCode": 10000,
"errMsg": "successful",
"content": {
"phone": "11700000026"
}
}