注册 登录

侧边栏

文档首页

常见问题

SDK下载

返回码

短信API

用户工具

您在这里: 接入建议 » 呼叫建立通知接口
呼叫建立通知接口

目录

呼叫建立通知接口

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

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

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>

页面工具