用户工具

语音验证码状态通知接口

这是本文档旧的修订版!


语音验证码状态通知接口

1.1 平台请求


• 请求地址
需要第三方自行配置URL地址。
• 请求包体

属性 类型 约束 说明
event String 必选 值为:voiceCode
accountid String 必选 开发者账号id
appid String 必选 应用Id
callid String 必选 呼叫的唯一标识
called String 必选 被叫号码,可以是正常手机号码、固定号码,被叫为座机时需要添加区号,如:075512345678
state String 必选 通话状态,0:正常通话;1:被叫未接听;2:被叫拒接;3:外呼失败
duration String 必选 通话时长,单位为秒

• XML请求示例

POST /coolweb/voiceCode HTTP/1.1 
Host: 172.16.10.32:8080 
Content-Type:text/xml;charset=utf-8 
Accept:application/xml 
Content-Length: 461
 
<?xml version="1.0"?> 
<request>     
    <event>voiceCode</event>     
    <callid>60000000000008mRrDm254582</callid>     
    <accountid>aae25ec101fc12087516bc6564d0aa73</accountid>     
    <appid>0e0ad5c8ba5c4225b9eff2f4c0259196</appid>
    <called>18612345678</called>    
    <state>0</state>     
    <duration>38</duration> 
</request>

1.2 第三方AS响应


• 响应包体

属性 类型 约束 说明
retcode int 必选 返回错误码,0:成功,非0:失败

• XML响应示例

<?xml version="1.0" encoding="UTF-8"?>
<response>
    <retcode>0</retcode>
</response> 

页面工具