开放接口

Token、查询、回调均为 POST，请求体均为与推送相同的 AES-256-GCM 包装（见 安全规范）。设备与模板见 设备与模板。

约定	说明
取 Token	额外带明文 enterpriseId；用 secret 加密鉴权
查询 / 回调	请求头 Authorization: Bearer <accessToken>
成功业务码	code = 2000

本目录

页面	路径
获取 Token	POST /openapi/v1/token
查询录音	POST /openapi/v1/audios
回调	POST /openapi/v1/callback

错误码

开放接口失败时 HTTP 多为 200，以 JSON 的 code 为准。

code	含义	典型场景
2000	成功	Token / 查询 / 回调成功；你方推送 ACK 也应返回此码
401	未授权	缺少 Authorization；accessToken 无效、过期或密钥已轮换
403	无权限	查询条件中的 deviceUid 不属于该企业
4000	参数错误	缺 enterpriseId；密文包装字段不完整；回调明文缺 audioId
4001	解密失败	secret 错误或密文损坏
5000	业务 / 系统错误	企业未开通或未启用出站对接

设备 / 模板专用错误码见 设备与模板。