录音文件

项	说明
方向	你 → 平台
方法	`GET`
路径	`/openapi/v1/devices/{deviceSn}/files`
Header	`Authorization: Bearer <accessToken>`

近 48 小时、处理已完成，最多 50 条。downloadUrl 为 HTTPS 签名地址，过期后重新查询。本接口只返回处理后的音频文件。

不含转写文本；转写见出站推送与查询录音。

响应

json

{
  "deviceSn": "<设备SN>",
  "files": [
    {
      "audioId": "audio-001",
      "fileName": "recording.mp3",
      "downloadUrl": "https://<host>/<object>",
      "audioSizeBytes": 13096914,
      "audioMd5": "85d507b5572038e0a134382d031c68e0",
      "recordedAt": "2026-09-22T09:59:25+08:00",
      "recordDuration": 35,
      "recordDurationUnit": "SECONDS"
    }
  ]
}

参数名	类型	必传	描述
deviceSn	string	是	设备 SN
files	array	是	文件列表
files[].audioId	string	是	录音 ID
files[].fileName	string	否	文件名
files[].downloadUrl	string	是	签名下载地址
files[].audioSizeBytes	long	否	文件大小，字节
files[].audioMd5	string	否	MD5
files[].recordedAt	string	否	录音时间
files[].recordDuration	int	否	时长
files[].recordDurationUnit	string	否	如 `SECONDS`

录音文件 ​

响应 ​

录音文件

响应