通话录音地址

获取某条洞察记录对应通话的录音播放地址，返回一个有效期 15 分钟的签名 URL，对应控制台洞察详情页的通话原声播放。

GEThttps://dashboard.avavox.com/open/api/v1/insight/records/{insightId}/audio

地址不可复用

签名 URL 有效期仅 15 分钟，且每次调用都会重新签名。请在用户点击播放的那一刻调用本接口，不要提前批量拉取并入库。

请求头

Authorization string 必填

填写格式：Authorization: Bearer <App Key>
<App Key> 为控制台「App Key 管理」页面生成的 Key。
获取方式详见：《App Key 创建与管理》。

路径参数

insightId string 必填

洞察记录 ID，由洞察列表查询接口的 list[].insightId 返回。

请求参数

无。

响应数据

code int

状态码，200 为成功，其他状态均为失败。

success boolean

是否成功，true 表示成功，false 表示失败。

message string

描述信息。

data object

点击展开字段说明

url string

带签名的临时播放地址，可直接用于 <audio> 播放或下载。

expireIn int

有效期（秒），固定 900。

expireAt string

过期时刻，yyyy-MM-dd HH:mm:ss。

format string

音频格式，如 mp3。

duration int

录音时长（秒）。通话记录未落时长时为 null。

fileSize long

文件大小（字节）。未记录时为 null，请勿假定该字段一定有值。

请求示例

shell

curl -X GET --location 'https://dashboard.avavox.com/open/api/v1/insight/records/ins_9f2c81b0/audio' \
--header 'Authorization: Bearer $Key'

响应示例

json

{
  "code": 200,
  "success": true,
  "message": "操作成功",
  "data": {
    "url": "https://cdn.example.com/rec/2026/04/28/b4f26ded.mp3?e=1777000900&sign=xxx",
    "expireIn": 900,
    "expireAt": "2026-04-28 12:00:00",
    "format": "mp3",
    "duration": 73,
    "fileSize": 587264
  }
}

录音不可用的情况

以下情况均取不到录音，请在客户端做好「录音不可用」的兜底展示：

洞察记录不存在
关联的通话记录不存在
录音已被存储策略清理
录音地址为空或格式异常
对象存储判定文件不可读

通话录音地址 ​

请求头 ​

路径参数 ​

请求参数 ​

响应数据 ​

请求示例 ​

响应示例 ​

录音不可用的情况 ​