请求方式:POST
请求地址: 语音通知API中指定的notify_url。若如无此字段,则以OneNET平台配置为准。
| 参数名称 | 是否必填 | 参数值 |
|---|---|---|
| Authorization | 是 | 查看鉴权参数计算方法 |
| Content-Type | 是 | application/json;charset=utf-8 |
| 参数名称 | 类型 | 长度 | 是否必填 | 说明 |
|---|---|---|---|---|
| user_id | Long | 32 | 是 | OneNET用户Id |
| call_id | String | 64 | 是 | 呼叫标识 |
| caller | String | 64 | 是 | 主叫号码(MSISDN) 举例8618625150488 |
| callee | String | 64 | 是 | 被叫号码(MSISDN) 举例8618625150488 |
| status | String | 16 | 是 | 呼叫状态 CallingCallee:正在呼叫被叫 Connected:通话中 Disconnected:已经结束 CollectResult:放音收号结果事件 |
| reason | String | 16 | 否 | status为Disconnected时必填 当status为Disconnected时,表示断开原因 HangUp:正常挂机,包括通话后被删除 CalleeBusy:被叫忙 CalleeNoAnswer:被叫无应答 CalleeFailure:被叫其它原因失败 Other:其它原因失败 CalleeEmpty:被叫空号 CalleeUnregistere:被叫关机 CalleeReject:被叫拒接 CalleenotReach:被叫不可及 |
| operation_result | String | 64 | 否 | 当status= CollectResult时,该参数用于表示在放音收号场景中,向开发者提供收号结果 |
| call_duration | String | - | 否 | 本次通话时长,单位秒 status为Disconnected时必填 |
POST /callback/statusback
Content-Type: application/json;charset=utf-8
Accept: application/json
Authorization:version=2020-05-29&res=userid%2F37739&et=1605860214&method=md5&sign=TqjQo8%2FlSMuM6jN5uLYvPw%3D%3D
{
"user_id":1234,
"call_id": "CS123",
"caller":"8613912345672",
"callee":"8613912345673",
"status":"Disconnected",
"reason":"HangUp"
}
| 参数名称 | 类型 | 长度 | 是否必填 | 说明 |
|---|---|---|---|---|
| request_id | String | 32 | 是 | 请求Id http请求唯一识别码 |
| code_no | String | 6 | 是 | 返回编码 |
| code | String | 512 | 是 | 返回码 |
| message | String | 512 | 是 | 返回描述信息 |
HTTP/1.1 200 OK
Content-Type: application/json; charset=UTF-8
Connection: close
Content-Length: 0
{
"request_id": "85fcaba7045247c88b87380149ea0941",
"code_no": "000000",
"code": "OneNET_common_success",
"message": "调用成功"
}
目前的响应码汇总如下,根据实际情况可能有所调整。
| 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 | 用户该项业务已关闭 |