下载通话记录

下载指定分机或所有分机的通话记录。

下载步骤

  1. 获取通话记录文件的随机串。
  2. 使用随机串，组合成通话记录文件的下载链接。
    注： 随机串的有效时长为30秒，并且每个随机串使用一次。

请求地址

{base_url}/{api_path}/cdr/get_random?token={token}

请求参数

参数 是否必选 类型 描述
number 是 String 分机号码。表示要下载哪些分机的通话记录。

取值范围：

  • 单个分机号码：下载指定分机的通话记录。

    例如："number":"1000"

  • 多个分机号码：下载多个分机的通话记录。多个分机号码用半角逗号（,）隔开。

    例如："number":"1000,1001,1002"

  • all：下载所有分机的通话记录。

    例如："number":"all"
starttime 是 String 通话记录的起始时间。

时间格式：yyyy-mm-dd hh:mm:ss
endtime 是 String 通话记录的结束时间。

时间格式：yyyy-mm-dd hh:mm:ss
allowedip 否 String

设置允许下载通话记录的设备 IP 地址。默认不带此参数，表示只能通过应用服务器下载文件。

取值范围：

  • 空值：只能通过应用服务器下载文件。

    例如："allowedip":" "

  • IP 地址：只能通过该 IP 地址或应用服务器下载文件。

    例如："allowedip":"192.168.5.20"

响应参数

参数 类型 描述
status String 请求结果。
  • Success：成功。
  • Failed：失败。
number String 分机号码。
starttime String 通话记录的起始时间。
endtime String 通话记录的结束时间。
random String 通话记录文件的随机串。

使用这个随机串组合成该通话录音文件的下载链接。

示例

请求示例

获取分机4000通话记录文件的随机串。

POST /api/v2.0.0/cdr/get_random?token=1e3b3ebb6a974cb42ed31de5413df52d
Content-Type:application/json; charset=utf-8
Host: 192.168.5.150

{
	"number": "4000",
	"starttime": "2019-10-24 00:00:00",
	"endtime": "2019-10-24 15:59:59"
}
响应示例
HTTP/1.1 200 OK
Server: Boa/0.94.14rc21
Accept-Ranges: bytes
Connection: close
Content-Type: application/json
Access-control-allow-origin: *
Access-control-allow-methods: GET, POST, OPTIONS, PUT, DELETE

{
	"status": "Success",
	"number": "4000",
	"starttime": "2019-10-24 00:00:00",
	"endtime": "2019-10-24 15:59:59",
	"random": "7b5a748e176d1ed625793d3a231808dc"
}

通话记录下载链接

使用随机串（random）组合成通话记录的下载链接。

通话记录文件的格式为CSV。查看通话记录参数说明。

通话记录下载链接格式：

https://{pbx ip}:{https port}/api/v2.0.0/cdr/download?
number={number}&starttime={starttime}&endtime={endtime}&token={token}&
random={random}
通话记录下载链接示例：
https://192.168.5.150:8088/api/v2.0.0/cdr/download?
number=4000&starttime=2019-10-24%2000:00:00&endtime=2019-10-24%2015:59:59&
token=4555b319609ca31410f7b946671fcc69&random=7b0ad48124d720235b05d2435a48bc30