Appearance
回调
接收并处理推送后,由你方主动通知平台该录音已接收完成。
| 项 | 说明 |
|---|---|
| 方向 | 你 → 平台 |
| 方法 | POST |
| 路径 | /openapi/v1/callback |
| Header | Authorization: Bearer <accessToken>、Content-Type: application/json |
推荐流程
- 接收推送 → 解密 → 校验
eventId幂等 → 落库。 - 对推送请求返回
{"code":2000}。 - (异步)获取
accessToken(本地仍有效可复用)。 - 用
secret加密明文{"audioId":"<推送中的 audioId>"}。 POST /openapi/v1/callback。- 收到
{"code":2000}即表示平台已确认。
勿在推送 ACK 路径上同步调回调;先回 2000 再异步发起。
请求
http
POST /openapi/v1/callback
Authorization: Bearer <accessToken>
Content-Type: application/json请求体为密文外壳。解密后明文:
json
{
"audioId": "audio-xxx"
}| 参数名 | 类型 | 必传 | 描述 |
|---|---|---|---|
| audioId | string | 是 | 已接收完成的录音 ID,须与推送中的 audioId 一致 |
同一 audioId 重复回调仍返回成功(幂等)。
响应
json
{ "code": 2000, "msg": "success" }| 参数名 | 类型 | 必传 | 描述 |
|---|---|---|---|
| code | int | 是 | 2000 成功 |
| msg | string | 否 | 提示信息 |