注册 登录

侧边栏

文档首页

常见问题

SDK下载

返回码

短信API

使用指南

审核规范

用户工具

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

这是本文档旧的修订版！

目录

呼叫建立通知接口

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

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

1.1 平台请求

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

属性 类型 约束 说明
event String 必选 值为：callestablish
callid string 必选 呼叫的唯一标识（沿用原来机制，由sdk组件生成）
accountid string 必选 发者账号id
appid string 必选 应用id
calltype int 必选 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>

页面工具