用户工具

呼叫建立通知接口

呼叫建立通知接口

呼叫建立通知接口,会在用户拨通(以建立通话为准,而非响铃)以后,主动推送拨通消息到开发者服务器,使开发者服务器得知该通话已经拨通。

  • 如果开发者需要及时知道通话开始的时间,或者响应通话开始的事件,则需要开通该接口。
  • 如果开发者不需要知道通话开始的任何信息,则不需要开通此接口

1.1 平台请求


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

属性 类型 约束 说明
event String 必选 值为:callestablish
callid string 必选 呼叫的唯一标识(沿用原来机制,由sdk组件生成)
accountid string 必选 发者账号id
appid string 必选 应用id
calltype int 必选 1:免费
subcalltype int 可选 1:音频、2:视频(此字段当calltype=1时生效 )
callertype int 必选 主叫号码类型,0:Client账号,1:普通电话,2:userid
callernumString必选 用户绑定的号码
caller string 必选 主叫号码
普通电话:18612345678
Client号码:60000000000017
calledtype int 必选 被叫号码类型,0:Client账号,1:普通电话,2:userid
called string 必选 被叫号码
普通电话:18612345678
Client号码:60000000000017

• XML请求示例

POST /coolweb/callest HTTP/1.1
Host: 172.16.10.32:8080
Content-Type:text/xml;charset=utf-8
Accept:application/xml
Content-Length: 384
 
<?xml version="1.0"?>
<request>
    <event>callestablish</event>
    <callid>60000000000008mRrDm254582</callid>
    <accountid>aae25ec101fc12087516bc6564d0aa73</accountid>
    <appid>0e0ad5c8ba5c4225b9eff2f4c0259196</appid>
    <calltype>0</calltype>
    <callertype>0</callertype>
    <caller>60000000000008</caller>
    <calledtype>1</calledtype>
    <called>18612345678</called>
</request>

1.2 第三方AS响应


• 响应包体

属性 类型 约束 说明
retcode int 必选 返回错误码,0:成功,非0:失败
reason String 可选 原因描述

• XML响应示例

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

页面工具