中文帮助文档>Rest API

下载话单

通过HTTPS POST方式提交下载话单请求,轻码云平台收到请求后,返回该应用话单下载地址以及验证码,然后开发者使用验证码GET下载地址就可以获取到通话详单。该接口只可以获取前一天、前一周、前一个月的话单数据。

请求地址:
/{SoftVersion}/accounts/{accountSid}/billDownload
验证级别:
主账号验证级别,请求地址中的 {accountSid}代表主账号id(ACCOUNT SID)。
地址样例:
https://api.qingmayun.com/20141029/accounts/823deef8e529477185a52179325b4a62/billDownload?sig=84b81c1d13911dd6cd35e63b4db988e8&timestamp=20141116113918
支持格式:
JSON,XML
HTTPS请求方式:
POST

请求包体

属性 类型 约束 说明
appId String 必选 应用Id。
date String 必选 day 表示前一天数据;week 表示上一周的数据;month表示上个月的数据(暂只支持day)
day String 可选 yyyyMMdd 如 20141220

响应包体

属性 类型 约束 说明
respCode String 必选 请求状态码,取值00000(成功),具体可参考状态码
downUrl String 必选 话单下载地址。包含下载话单的名称。
token String 必选 验证话单下载链接的正确性。

XML请求实例

POST /20141029/accounts/823deef8e529477185a52179325b4a62/billDownload?sig=84b81c1d13911dd6cd35e63b4db988
&timestamp=20141116113918
Host:api.qingmayun.com
Accept:application/xml
Content-Type:application/xml;charset=utf-8

<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <billDownload> <appId>0871743c6df94cae9fe9222007a25348</appId> <date>day</date> <day>20141220</day> </billDownload>

JSON请求实例

POST /20141029/accounts/823deef8e529477185a52179325b4a62/billDownload?sig=84b81c1d13911dd6cd35e63b4db988
&timestamp=20141116113918
Host:api.qingmayun.com
Accept:application/json
Content-Type:application/json;charset=utf-8

{ "billDownload": { "appId": "0871743c6df94cae9fe9222007a25348", "date": "day", "day":"20141220" } }

XML响应实例

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<billDownloadUrl>    
    <respCode>00000</respCode>
	<downloadUrl>http%3A%2F%2Fwww.qingmayun.com%3A8080%2Fbilling%2F20141029%2FbillDetialListExport%3Ffilename
%3D20150304150851</downloadUrl>
    <token>14bb62e035db42d5bbc657f462e0f78c</token>
</billDownloadUrl>

JSON响应实例

{
    "result": {
        "respCode": "00000",
        "downloadUrl": "http%3A%2F%2Fwww.qingmayun.com%3A8080%2Fbilling%2F20141029%2FbillDetialListExport%3Ffilena
me%3D20150304150136",
        "token": "abf67f56d67b408ba089bd05de4710a4"
    }
}
调用话单下载URL:
开发者使用响应回包中的话单下载地址和文件下载检验码发起下载请求
GET {downUrl}&token={token}

详单格式

属性 类型 约束 说明
appName String 必选 应用名称。
type String 必选 电话拨打类型(回拨、直拨)。
caller String 必选 主叫号码。
called String 必选 被叫号码。
startTime String 必选 开始拨打时间。
callTime String 必选 拨打时长。
billPrice String 必选 拨打费用。