智萃工作流回调（接口文档）

面向 AI 平台的回调接口

接口

POST /api/webhook/ai/workflow/subtitles-to-essence-content

Query 参数

参数	类型	必填	说明
token	string	是	与文档索引回调相同算法的 JWT（云存储 access/secret 签名）
essenceFileId	number	是	essence_file.id，与启动工作流时 callback URL 一致

请求体

字段	类型	必填	说明
ok	boolean	是	是否成功
outputs	object	条件	ok=true 时的结构化输出
error	object	条件	ok=false 时的错误信息

outputs 的结构当前未在 LMS 侧做强约束，按 AI 工作流实际回调原样透传并由服务端解析。

error 结构：

字段	类型	必填	说明
code	string	否	工作流错误码
message	string	否	工作流错误信息

请求体结构示例：

{
  "ok": true,
  "outputs": {
    "segments": []
  }
}

响应

字段	类型	说明
success	boolean	固定为 true

错误与 HTTP 状态

场景	HTTP	说明
Query 缺参（如 token / essenceFileId）、请求体缺 ok 等	400	框架绑定失败或业务校验 AppException
token 无效或过期	401	JWT 校验失败（JWTVerificationException）

补充说明：

• 回调体启用了 ignoreUnknown=true，额外字段不会导致请求失败
• 成功响应固定为 { "success": true }