请求方式:POST
请求地址: https://voice.heclouds.com:8002/v1/onenet/dial/notify
参数名称 | 是否必填 | 参数值 |
---|---|---|
Authorization | 是 | 详见鉴权认证 |
Content-Type | 是 | application/json;charset=utf-8 |
参数名称 | 类型 | 长度 | 是否必填 | 说明 |
---|---|---|---|---|
appid | String | 32 | 是 | 应用标识 由OneNET平台生成 |
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) 如无此字段,则根据OneNET平台配置为准 |
POST /v1/ OneNET/dial/notify HTTP/1.1
Content-Type: application/json;charset=utf-8
Accept: application/json
Authorization:version=v1&res=onenet_voice%2F3143eba93adb4f35bde98aa31e4e5bbd&et=1568267186&method=sha1&sign=VeSeq%2B6zZKllEvCv2pa1Vdx0DUk%3D
{
"appid":"3143eba93adb4f35bde98aa31e4e5bbd",
"callee":"8613696486500",
"caller":"8618223159111",
"display":"02066240222",
"sponsor":"02066240222",
"notify_url":"http:183.230.40.149:80/callback/statusback"
}
参数名称 | 类型 | 长度 | 是否必填 | 说明 |
---|---|---|---|---|
request_id | String | 32 | 是 | 请求Id http请求唯一识别码 |
code_no | String | 6 | 是 | 返回编码 |
code | String | 512 | 是 | 返回码 |
message | String | 512 | 是 | 返回描述信息 |
data | Data | - | 是 | 呼叫结果信息 Data详细参数说明如下所示 |
参数名称 | 类型 | 长度 | 是否必填 | 说明 |
---|---|---|---|---|
call_id | String | 64 | 是 | 呼叫标识 |
HTTP/1.1 200 OK
Content-Type: application/json; charset=UTF-8
Connection: close
{
"request_id": "85fcaba7045247c88b87380149ea0941",
"code_no": "000000",
"code": "OneNET_common_success",
"message": "调用成功",
"data": {
"call_id": "150104227912386807"
}
}
目前的响应码汇总如下,根据实际情况可能有所调整。
code_no | code | message |
---|---|---|
000000 | onenet_common_success | 成功 |
000111 | onenet_common_systemException | 系统异常,请稍后重试 |
000001 | onenet_common_systemBusy | 系统繁忙,请稍后重试 |
000002 | onenet_common_authException | 系统认证失败 |
000004 | onenet_common_invalidParams | 非法的参数 |
000005 | onenet_common_invalidReqParams | 非法的请求参数 |
000006 | onenet_common_paramNullException | 必输参数不能为空 |
000012 | onenet_common_JsonException | 非法JSON的数据 |
000014 | onenet_common_authorizationIsNull | 鉴权参数为空 |
000015 | onenet_common_authorizationFailed | 鉴权失败 |
001001 | onenet_iaepVoice_callIdNotExist | 呼叫标识不存在 |
001005 | onenet_iaepVoice_NumberFormatRrror | 号码格式错误 |
001008 | onenet_iaepVoice_BusinessNumberMismatch | 业务号码不匹配 |
001009 | onenet_iaepVoice_NotOpenTheBusiness | 用户没有开通该业务 |
001010 | onenet_iaepVoice_TheBusinessIsClosed | 用户该项业务已关闭 |