下载通话记录

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

下载步骤

  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