注册 登录

侧边栏

文档首页

常见问题

SDK下载

返回码

短信API

用户工具

您在这里: 接入建议 » 语音验证码状态通知接口
语音验证码状态通知接口

这是本文档旧的修订版！

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>

页面工具