这里会显示出您选择的修订版和当前版本之间的差别。
呼叫建立通知接口 [2016/06/07 09:50] liuxia |
呼叫建立通知接口 [2017/08/23 08:44] |
||
---|---|---|---|
行 1: | 行 1: | ||
- | ======呼叫建立通知接口====== | ||
- | |||
- | 呼叫建立通知接口,会在用户拨通(以建立通话为准,而非响铃)以后,主动推送拨通消息到开发者服务器,使开发者服务器得知该通话已经拨通。 | ||
- | *如果开发者需要及时知道通话开始的时间,或者响应通话开始的事件,则需要开通该接口。 | ||
- | *如果开发者不需要知道通话开始的任何信息,则不需要开通此接口 | ||
- | ==== 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 | | ||
- | |callernum|String|必选 |用户绑定的号码| | ||
- | |caller |string |必选 |主叫号码\\ 普通电话:18612345678 \\ Client号码:60000000000017 | | ||
- | |calledtype |int |必选 |被叫号码类型,0:Client账号,1:普通电话,2:userid | | ||
- | |called |string |必选 |被叫号码\\ 普通电话:18612345678 \\ Client号码:60000000000017 | | ||
- | |||
- | **• XML请求示例 ** | ||
- | <code java> | ||
- | 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> | ||
- | </code> | ||
- | |||
- | ==== 1.2 第三方AS响应 ==== | ||
- | |||
- | ---- | ||
- | **• 响应包体** | ||
- | |||
- | ^属性 ^类型 ^约束 ^说明| | ||
- | |retcode |int |必选 |返回错误码,0:成功,非0:失败 | | ||
- | |reason |String |可选 |原因描述 | | ||
- | |||
- | **• XML响应示例** | ||
- | <code java> | ||
- | <?xml version="1.0" encoding="UTF-8"?> | ||
- | <response> | ||
- | <retcode>0</retcode> | ||
- | <reason>100013</reason> | ||
- | </response> | ||
- | </code> | ||