第三方应用服务器接收语音验证码状态通知(可选)

呼叫结束之后,云通讯平台将向语音验证码请求中配置的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外呼失败。客户服务端可以根据自己的逻辑进行重发或者其他处理。