状态通知_开发文档

| 开发者中心

新用户指南 SDK文档 Rest API IVR API 云通讯首页

开发指南

准备工作

免费测试

错误代码

语音验证码

❀ 云通讯首页>>开发者中心>>Rest API>>语音验证码

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

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