下载录音文件

通过本接口可获取 PBX 中的全局录音文件。

下载步骤

  1. 通过‘通话记录’报告中的recording 参数获取到全局录音文件的名称。
  2. 通过获取到的名称从 PBX 获取有关该文件的一个随机串。
  3. 通过该随机串组合成录音文件的下载链接。
注： 随机串的有效时长为30秒，并且每个随机串使用过一次则失效。

Endpoint

POST /api/v1.1.0/recording/get_random?token={token}

请求参数

名称 是否必需 类型 描述
recording 是 String 全局录音文件名称。
allowedip 否 String

设置允许下载录音文件的设备 IP 地址。

  • 不填写allowedip：只能通过第三方服务器可以下载文件。
  • allowedip 值为空：只能通过第三方服务器可以下载文件。
  • allowedip 填写 IP 地址：只能通过该 IP 地址或第三方服务器可以下载文件。
注：
  • allowedip 只能填写一个 IP 地址。

响应参数

名称 类型 描述
recording String 全局录音文件名称。
random String 有关全局录音文件的一个随机串。使用这个随机串组合成下载播放该录音文件请求。

实际示例

请求示例

请求录音文件的随机串。

POST /api/v1.1.0/recording/get_random?token=1e3b3ebb6a974cb42ed31de5413df52d HTTP/1.1
Content-Type:application/json; charset=utf-8
Host: api.yeastarcloud.com
{
    "recording": "20170901181806-1504261084.7-1001-1003-Internal.wav"
}
响应示例
HTTP/1.1 200 OK
Access-control-allow-origin: *
Access-control-allow-methods: GET, POST, OPTIONS, PUT, DELETE
{
    "status": "Success",
    "recording": "20170901181806-1504261084.7-1001-1003-Internal.wav",
    "random": "120732c546381fb020f17fba676b0ea0"
}

全局录音下载链接

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

录音下载链接格式：

https://{pbx domain}/api/v1.1.0/recording/download?recording={recording}&random={random}&token={token}

录音下载链接示例：

https://yeastarcloudpbx.com/api/v1.1.0/recording/download?recording=20170901181806-1504261084.7-1001-1003-Internal.wav&random=120732c546381fb020f17fba676b0ea0&token=75c5891b32203d0615f9e3753a7cb779