下载录音文件

获取 PBX 中的自动录音文件。

下载步骤

  1. 通过NewCdr（通话记录事件）中的 recording 参数获取到自动录音文件的名称。
  2. 获取自动录音文件的随机串。
  3. 使用随机串，组合成录音文件的下载链接。
    注： 随机串的有效时长为30秒，并且每个随机串只能使用一次。

请求地址

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

请求参数

参数 是否必选 类型 描述
recording 是 String 自动录音文件名称。
allowedip 否 String

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

取值范围：

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

    例如："allowedip":" "

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

    例如："allowedip":"192.168.5.20"

响应参数

参数 类型 描述
status String 请求结果。
  • Success：成功。
  • Failed：失败。
recording String 自动录音文件名称。
random String 自动录音文件的随机串。

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

示例

请求示例

获取录音文件的随机串。

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

{
	"recording": "20191024012719-1571909237.191-4000-4001-Internal.wav"
}
响应示例
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",
	"recording": "20191024012719-1571909237.191-4000-4001-Internal.wav",
	"random": "2d2f919b742cc62f5e03c77351350f7c"
}

自动录音下载链接

使用随机串（random）组合成录音文件的下载链接。

录音下载链接格式：

https://{pbx ip}:{https port}/api/v2.0.0/recording/download?
recording={recording}&random={random}&token={token}
录音下载链接示例：
https://192.168.5.150:8088/api/v2.0.0/recording/download?
recording=20170901181806-1504261084.7-1001-1003-Internal.wav&random=120732c546381fb020f17fba676b
0ea0&token=75c5891b32203d0615f9e3753a7cb779