这里会显示出您选择的修订版和当前版本之间的差别。
billlist_api [2016/11/08 02:23] liuxia |
billlist_api [2017/08/23 08:44] |
||
---|---|---|---|
行 1: | 行 1: | ||
- | ====== 应用详单下载 API ====== | ||
- | 通过HTTPS POST方式提交请求,云之讯融合通讯开放平台收到请求后,返回应用详单下载地址及文件下载检验码。 | ||
- | |||
- | ==== 1.1 请求 ==== | ||
- | |||
- | **请求地址** | ||
- | |||
- | <code java> | ||
- | /{SoftVersion}/Accounts/{accountSid}/billList | ||
- | </code> | ||
- | |||
- | **请求包头** | ||
- | |||
- | 详情请查阅统一请求包头,并使用开发者账号进行验证。 | ||
- | |||
- | **请求包体** | ||
- | |||
- | ^属性 ^类型 ^约束 ^说明 | | ||
- | |appId |String |必选 |应用Id| | ||
- | |date |String |必选 |day 代表前一天的数据,也可以传具体的年月日(yyyyMMdd),获取所传日期的话单| | ||
- | |||
- | **XML请求示例** | ||
- | <code xml> | ||
- | POST/2014-06-30/Accounts/77df6f3a6d0c7b8e6b2946f48d2f72b0/billList.xml?sig=C17F25D970F28FEF32F689B842799644 | ||
- | Accept:application/xml | ||
- | Content-Type:application/xml;charset=utf-8 | ||
- | Authorization:NzdkZjZmM2E2ZDBjN2I4ZTZiMjk0NmY0OGQyZjcyYjA6MjAxNDA2MjgxMTMzNTI= | ||
- | |||
- | <?xml version='1.0' encoding='utf-8'?> | ||
- | <appBill> | ||
- | <date>day</date> | ||
- | <appId>0e0ad5c8ba5c4225b9eff2f4c0259196</appId> | ||
- | </appBill> | ||
- | </code> | ||
- | **JSON请求示例** | ||
- | |||
- | <code java> | ||
- | POST/2014-06-30/Accounts/77df6f3a6d0c7b8e6b2946f48d2f72b0/billList?sig=B669C48E06219144F639E620AA087C9C | ||
- | Accept:application/json | ||
- | Content-Type:application/json;charset=utf-8 | ||
- | Authorization:NzdkZjZmM2E2ZDBjN2I4ZTZiMjk0NmY0OGQyZjcyYjA6MjAxNDA2MjgxMTQ0NTY= | ||
- | |||
- | { | ||
- | "appBill" : { | ||
- | "appId" : "0e0ad5c8ba5c4225b9eff2f4c0259196", | ||
- | "date" : "day" | ||
- | } | ||
- | } | ||
- | </code> | ||
- | |||
- | ==== 1.2 响应 ==== | ||
- | |||
- | **响应包体** | ||
- | |||
- | ^属性 ^类型 ^约束 ^说明 | | ||
- | |respCode |String |必选 |请求状态码,取值000000(成功)| | ||
- | |downUrl |String |必选 |开发者账号详单下载地址| | ||
- | |token |String |必选 |文件下载检验码| | ||
- | **XML响应示例** | ||
- | <code xml> | ||
- | <?xml version="1.0" encoding="UTF-8"?> | ||
- | <resp> | ||
- | <respCode>000000</respCode> | ||
- | <accountBill> | ||
- | <downUrl>http://www.ucpaas.com/fileserver/file?fileName=4aRWho% | ||
- | 2Bm8i0jCcNF0UCh5liqkdDUYwbFCZYolrIYX7RG%2FEWSZDWx1CW258AVvdBR%2 | ||
- | FPTj3p5Nv3y5%0AE8%2Bsmff8j0ltqFhrNgxlImRzJMk%2FlqLpFREnbxsDNg%3 | ||
- | D%3D</downUrl> | ||
- | <token>4302d5deb51110ebe7e8522f5c59412c</token> | ||
- | </accountBill> | ||
- | </resp> | ||
- | </code> | ||
- | |||
- | **JSON响应示例** | ||
- | <code java> | ||
- | { | ||
- | "resp" : { | ||
- | "respCode" : "000000", | ||
- | "accountBill":{ | ||
- | "downUrl" :"http://www.ucpaas.com/fileserver/file?fileName=4aRWho%2Bm8i0jCcNF0UCh5liqkdDUYwbFCZYolrIYX7RG%2FEWSZDWx1CW258AVvdBR%2FPTj3p5Nv3y5%0AE8%2Bsmff8j0ltqFhrNgxlImRzJMk%2FlqLpFREnbxsDNg%3D%3D", | ||
- | "token" : "4302d5deb51110ebe7e8522f5c59412c" | ||
- | } | ||
- | } | ||
- | } | ||
- | </code> | ||
- | |||
- | **通用详单下载URL** | ||
- | |||
- | 开发者使用响应回包中的开发者账号详单下载地址和文件下载检验码发起下载请求。 | ||
- | |||
- | <code java> | ||
- | GET {downUrl}&token={token} | ||
- | </code> | ||
- | |||
- | **详单格式** | ||
- | |||
- | ^属性 ^类型 ^约束 ^说明 | | ||
- | |fromClient |String |必选 |主叫Client| | ||
- | |to |String |必选 |被叫号码,包括电话号码和Client号码。| | ||
- | |startTime |String |必选 |开始时间,时间格式为:2014-4-18 13:50:38| | ||
- | |duration |String |必选 |通话时长,精确到秒。| | ||
- | |bill |String |必选 |话费| |