Skip to content

回调 ​

接收并处理推送后,由你方主动通知平台该录音已接收完成。

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

推荐流程 ​

  1. 接收推送 → 解密 → 校验 eventId 幂等 → 落库。
  2. 对推送请求返回 {"code":2000}。
  3. (异步)获取 accessToken(本地仍有效可复用)。
  4. 用 secret 加密明文 {"audioId":"<推送中的 audioId>"}。
  5. POST /openapi/v1/callback。
  6. 收到 {"code":2000} 即表示平台已确认。

勿在推送 ACK 路径上同步调回调;先回 2000 再异步发起。

请求 ​

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

请求体为密文外壳。解密后明文:

json
{
  "audioId": "audio-xxx"
}
参数名类型必传描述
audioIdstring是已接收完成的录音 ID,须与推送中的 audioId 一致

同一 audioId 重复回调仍返回成功(幂等)。

响应 ​

json
{ "code": 2000, "msg": "success" }
参数名类型必传描述
codeint是2000 成功
msgstring否提示信息