======呼叫挂机计费接口====== 用户在挂断电话之后,主动推送挂断信息到开发者服务器上,使开发者服务器得知该电话已经挂断,此接口会推送通话时长和开始及结束时间点,便于开发者服务器对客户进行费用结算工作。 ==== 1.1 平台请求 ==== ---- **• 请求地址** \\ 需要第三方自行配置URL地址。 \\ **• 请求包体** ^属性 ^类型 ^约束 ^说明| |event |string |必选 |值为:callhangup | |callid |string |必选 |呼叫的唯一标识(沿用原来机制,由sdk组件生成) | |accountid |string |必选 |开发者账号id | |appid |string |必选 |应用id | |confid |string |必选 |群聊id (仅语音群聊场景)| |calltype |int |必选 |1:免费| |subcalltype |int |可选 |1:音频、2:视频(此字段当calltype=1时生效 )| |callertype |int |必选 |主叫号码类型,0:Client账号,1:普通电话,2:userid | |callernum|String|必选 |用户绑定的号码| |displaynum|String|必选 |用户显号号码| |caller |String |必选 |主叫号码 \\ 普通电话:18612345678 \\ Client号码:60000000000017 | |calledtype |int |必选 |被叫号码类型,0:Client账号,1:普通电话,2:userid | |called |string |必选 |被叫号码 \\ 普通电话:18612345678 \\ Client号码:60000000000017 | |starttime |string |必选 |开始通话时间。时间格式如:2014-06-16 16:47:28 | |stoptime |string |必选 |结束通话时间。时间格式如:2014-06-16 17:31:14 | |length |int |必选 |通话时长(s) | |recordurl |String |可选 |通话录音完整下载地址,默认为空。 | |userData|string |可选 |用户自定义数据字符串,最大长度128字节 | |reason |int |必选 |挂机原因描述,0:正常挂断;1:余额不足;2:媒体超时;3:无法接通;4:拒接; \\ 5:超时未接;6:拒接或超时未接;7:平台服务器网络错误;8:用户请求取消通话;\\ 9:第三方鉴权错误;255:其他原因。 | |subreason |int |可选 |挂机原因补充描述,1:主叫挂断;2:被叫挂断;目前当reason=0时有效。 | **• XML请求示例 ** POST /coolweb/callhangup HTTP/1.1 Host: 172.16.10.32:8080 Content-Type:text/xml;charset=utf-8 Accept:application/xml Content-Length: 515 callhangup 60000000000008mRrDm254582 aae25ec101fc12087516bc6564d0aa73 0e0ad5c8ba5c4225b9eff2f4c0259196 0 0 60000000000008 1 18612345678 8 2014-07-11 10:29:27 2014-07-11 10:29:35 18612345678 0 ==== 1.2 第三方AS响应 ==== ---- **• 响应包体** ^属性 ^类型 ^约束 ^说明| |retcode |int |必选 |返回错误码,0:成功,非0:失败 | |reason |String |可选 |原因描述 | **• XML响应示例 ** 0 100013