请求方式:POST
接口地址:https(http)://openapi.heclouds.com/vcs?action=dialNotify&version=2
| 参数名称 | 是否必填 | 参数值 |
|---|---|---|
| Authorization | 是 | 查看鉴权参数计算方法 |
| Content-Type | 是 | application/json;charset=utf-8 |
| 参数名称 | 类型 | 长度 | 是否必填 | 说明 |
|---|---|---|---|---|
| sponsor | String | 64 | 是 | 发起呼叫的号码(业务号码) 主叫用户的来显号码,由OneNET平台提供 号码格式: 手机号码格式:MSISDN。示例:8613500000003 固话格式:区号+固话。区号0755,固话号码28000003,填写为075528000003 |
| caller | String | 64 | 是 | 主叫号码 号码格式使用MSISDN,举例8618625150488 |
| callee | String | 64 | 是 | 被叫号码 号码格式使用MSISDN,举例8618625150488 |
| display | String | 64 | 否 | 被叫用户的号显号码 如果未携带此参数,被叫用户的来显号码为sponsor 如果携带此参数,值只可以与caller(display与caller相同时,caller需要加白名单)或sponsor相同,如果携带为其他号码则无法呼叫,响应报错 号码格式: 手机号码格式:MSISDN。示例:8613500000003 固话格式:区号+固话。区号0755,固话号码28000003,填写为075528000003 |
| notify_url | String | 512 | 否 | 用户指定的通知地址(请求方式为POST) 如无此字段,不进行回调 |
| 参数名称 | 类型 | 描述 |
|---|---|---|
| code | String | 调用失败时,返回的错误码 |
| msg | String | 调用失败时,返回的错误信息 |
| requestId | String | 调用API时生成的请求标识 |
| success | boolean | 接口是否调用成功 |
| data | - | 调用成功时,返回的业务数据 |
| data.call_id | string | 呼叫标识 |
POST /vcs?action=dialNotify&version=2
Content-type: application/json
{
"callee":"8613696486500",
"caller":"8618223159111",
"display":"02066240222",
"sponsor":"02066240222",
"notify_url":"http:183.230.40.149:80/callback/statusback"
}
成功
{
"requestId": "a25087f46df04b69b29e90ef0acfd115",
"success": true,
"data": {
"call_id": "150104227912386807"
}
}
失败
{
"code": "iot.vcs.notApplyTestAccount",
"msg": "request ip not equals test account ip",
"requestId": "0d9a3bab49ee458984743d5ee59eafab",
"success": false
}