查询录音

项	说明
方向	你 → 平台
方法	POST
路径	/openapi/v1/audios
Header	Authorization: Bearer <accessToken>、Content-Type: application/json

请求

POST /openapi/v1/audios
Authorization: Bearer <accessToken>
Content-Type: application/json

请求体为 密文外壳。解密后的过滤明文：

{
  "audioId": "audio-xxx",
  "deviceUid": "DEV001",
  "page": 1,
  "size": 20,
  "startTime": "2026-08-26T00:00:00+08:00",
  "endTime": "2026-08-26T23:59:59+08:00"
}

参数名	类型	必传	描述
audioId	string	否	按录音 ID 过滤
deviceUid	string	否	按设备 UID 过滤
page	int	否	页码，默认 1
size	int	否	每页条数，默认 20，最大 100
startTime	string	否	开始时间，ISO-8601
endTime	string	否	结束时间，ISO-8601

响应

HTTP 响应 data 为 AES-GCM 密文包装（字段同密文外壳），用 secret 解密后得到：

{
  "specVersion": "1",
  "page": 1,
  "size": 20,
  "total": 42,
  "items": [
    {
      "audioId": "audio-xxx",
      "data": {
        "deviceUid": "DEV001",
        "title": "客户拜访",
        "transcriptId": 90001,
        "transcriptText": "你好，今天过来看看。",
        "transcriptSentences": "[{\"text\":\"你好，今天过来看看。\",\"beginTime\":0,\"endTime\":1800}]",
        "durationMs": 1800,
        "wordsCount": 1
      }
    }
  ]
}

{
  "specVersion": "1",
  "page": 1,
  "size": 20,
  "total": 42,
  "items": [
    {
      "audioId": "audio-xxx",
      "data": {
        "deviceUid": "DEV001",
        "title": "客户拜访",
        "denoiseUrl": "https://oss.example/audio.wav",
        "recordDuration": 35
      }
    }
  ]
}

参数名	类型	必传	描述
specVersion	string	是	固定 "1"
page	int	是	当前页
size	int	是	每页条数
total	long	是	总条数
items	array	是	录音列表
items[].audioId	string	是	录音 ID
items[].data	object	是	字段含义同 出站推送 · data