状态通知
第三方应用服务器接收语音验证码状态通知(可选)
- 呼叫结束之后,云通讯平台将向语音验证码请求中配置的respUrl地址发送语音验证码状态通知。
1.1 语音验证码状态通知
- 语音验证码挂机后给应用侧的通知消息。
1.1.1 请求包头
属性 | 类型 | 约束 | 描述 | 举例 |
Method | String | 必选 | HTTP方法 | POST |
URL | String | 必选 | 地址URL | /{path} |
Host | String | 必选 | 服务器地址 | |
Content-Type | String | 必选 | 类型 | text/plain |
Content-Length | String | 必选 | 消息体的长度 |
1.1.2 请求包体
属性 | 类型 | 约束 | 描述 | 取值 |
action | String | 必选 | 表示语音验证码 | VoiceCode |
callSid | String | 必选 | 对应接口返回callSid参数,一路呼叫的唯一标示 | 32位字符串 |
number | string | 必选 | 外呼号码 | |
state | String | 必选 | 通话状态 | 0正常通话 1被叫通话未应答 2外呼失败 |
duration | String | 必选 | 通话时长 | 单位秒 |
userData | String | 可选 | 用户私有数据。语音验证码接口参数 |
1.1.3 请求示例
- POST /{path}
- HTTP/1.1
- Host: <ip>:<port>
- Content-Type: text/plain
- Content-Length: <Len>
- <?xml version="1.0" encoding="UTF-8"?>
- <Request>
- <action>VoiceCode</action>
- <number>13800000000</number>
- <callSid>1307241452320369000100030000002f</callSid>
- <state>0</state>
- <duration>30</duration>
- </Request>
1.2.1 响应示例
- HTTP/1.1 200 ok
- Date:Wed Nov 9 16:08:57 2011
- Content-Length: <len>
- <?xml version="1.0" encoding="UTF-8"?>
- <Response>
- <statuscode>000000</statuscode>
- </Response>
判断发送状态,重发
- 语音验证码请求的响应中statusCode为"000000"表示请求发送成功。statusCode不是"000000",表示请求发送失败;请求成功后在配置的respUrl接收返回的语音验证码状态通知,state为0正常通话 1被叫通话未应答 2外呼失败。客户服务端可以根据自己的逻辑进行重发或者其他处理。