话单下载
话单下载是云通讯平台为开发者提供的话单获取通道，通过此接口开发者可以获取前一天的话单数据。
REST API: 话单下载
通过HTTPS POST方式提交请求，云通讯平台收到请求后，返回子下载地址及文件下载检验码。
接口Demo示例可在REST Server Demo中找到，开发者可根据使用的语言下载对应的Demo
1、请求
1.1 请求地址
/{SoftVersion}/Accounts/{accountSid}/BillRecords
1.2 请求包头
请参阅：Rest 介绍》统一请求包头，使用主账户进行验证
1.3 请求包体
| 属性 | 类型 | 约束 | 说明 |
|---|---|---|---|
| appId | String | 必选 | 应用Id |
| date | String | 必选 | day：前一天的数据（从00:00 – 23:59）
|
| keywords | String | 可选 | 客户的查询条件，由客户自行定义并提供给云通讯平台。默认不填忽略此参数 |
注意：话单下载接口需要云平台开放相关权限，如需开通请联系云通讯商务人员或拨打400-610-1019
1.4 XML请求示例
POST /2013-12-26/Accounts/abcdefghijklmnopqrstuvwxyz012345/BillRecords?sig=155EAA68C5DFB6B762A42D88F406ABCD HTTP/1.1 Accept:application/xml; Host:192.168.0.1:8883 content-length: 139 Content-Type:application/xml;charset=utf-8; Authorization:ZmY4MDgwODEzYzM3ZGE1MzAxM2M4MDRmODA3MjAwN2M6MjAxMzAyMDExNTABCDE= <?xml version='1.0' encoding='utf-8'?> <BillRecords> <appId>ff8080813c37da53013c8054f567007e</appId> <date>day</date> <keywords>800023</keywords> </BillRecords>
1.5 JSON请求示例
POST /2013-12-26/Accounts/abcdefghijklmnopqrstuvwxyz012345/BillRecords?sig=155EAA68C5DFB6B762A42D88F406ABCD HTTP/1.1
Accept:application/json;
Host:192.168.0.1:8883
content-length: 139
Content-Type:application/json;charset=utf-8;
Authorization:ZmY4MDgwODEzYzM3ZGE1MzAxM2M4MDRmODA3MjAwN2M6MjAxMzAyMDExNTABCDE=
{"appId":"ff8080813fc70a7b013fc7212321412","date":"day"}
2、响应
2.1 响应包体
| 属性 | 类型 | 约束 | 说明 |
|---|---|---|---|
| statusCode | String | 必选 | 请求状态码，取值000000（成功），可参考Rest 错误代码。 |
| downUrl | String | 必选 | 话单下载地址 |
| token | String | 必选 | 文件下载检验码 |
2.2 XML请求示例
HTTP/1.1 200 OK Content-Length:586 <?xml version="1.0" encoding="UTF-8" standalone="yes"?> <Response> <statusCode>000000</statusCode> <downUrl>http://www.cloopen.com/</downUrl> <token>8sf92029ejfih83729202kj33j3h2u72jej32k</token> </Response>
2.3 JSON请求示例
HTTP/1.1 200 OK
Content-Length:586
{"statusCode":"000000","downurl":"http://www.cloopen.com/","token":"8sf92029ejfih83729202kj33j3h2u72jej32k"}
3、调用话单下载URL
开发者使用响应回包中的话单下载地址和文件下载检验码发起下载请求
GET {downUrl}?token={token}
附录：呼叫类型说明
呼叫类型 |
类型描述 |
|---|---|
type=2 |
模板短信 |
type=3 |
ivr呼入（通过绑定接入号呼入云平台） |
type=4 |
录音（用于呼叫类） |
type=5 |
ivr外呼 |
type=6 |
ivr外呼转接到网络端 |
type=7 |
点对点音频 |
type=8 |
ivr视频呼入 |
type=9 |
会议 |
type=10 |
子账户授权 |
type=11 |
点对点视频 |
type=12 |
im即时消息 |
type=13 |
语音验证码 |
type=14 |
外呼通知 |
type=15 |
视频会议 |
type=16 |
转接坐席，坐席端为运营商 |
type=17 |
转接坐席，坐席端为网络端 |
当呼叫类型为2，则主叫为短信模板id。
当呼叫类型为4，则主叫为应用固定的服务器id，无callid参数。
当呼叫类型为9，如果是呼入的方式加入会议则主叫为通讯账号或自定义账号，被叫为voipconfid；如果是邀请加入会议，则主叫为会议号，被叫为邀请的号码。
文档更新时间：2016年11月4日