规范说明
错误规范
常见 HTTP 错误与其触发条件。
- 错误类型
- 5
- 重试建议
- 按任务场景判断
401 未授权
未授权
调用方没有按接口要求提供正确认证信息。
HTTP 状态码
401
示例触发条件或可能原因
缺少 x-review-agent-token。 review_admin_session Cookie 缺失或无效。
含义说明
调用方没有按接口要求提供正确认证信息。
重试安全性与处理建议
确认该接口要求的认证方式是否正确，并检查令牌或 Cookie 配置。
常见接口
/api/review/tasks, /api/review/tasks/:taskId, /api/review/tasks/:taskId/decision
错误码
unauthorized
400 校验错误
校验错误
请求体或查询参数未通过校验。
HTTP 状态码
400
示例触发条件或可能原因
缺少必填字段。 status 或 action 取值非法。 补丁负载为空。
含义说明
请求体或查询参数未通过校验。
重试安全性与处理建议
对照接口结构检查请求体，并补全所有必填字段后重新发送。
常见接口
/api/review/tasks, /api/review/tasks/:taskId/decision, /api/review/tasks/:taskId/elements
错误码
validation_error
404 未找到
未找到
未能定位到目标任务或发布任务。
HTTP 状态码
404
示例触发条件或可能原因
taskId 错误。 jobId 错误。 被引用记录已被移除。
含义说明
未能定位到目标任务或发布任务。
重试安全性与处理建议
先核对标识，再刷新列表或详情页后重试。
常见接口
/api/review/tasks/:taskId, /api/review/tasks/:taskId/publish-jobs/:jobId/retry
错误码
not_found
409 冲突
冲突
当前工作流状态不允许执行该动作。
HTTP 状态码
409
示例触发条件或可能原因
审核通过前尝试发布。 对非 failed 的任务发起重试。 对已发布任务再次提交审核决策。
含义说明
当前工作流状态不允许执行该动作。
重试安全性与处理建议
先检查任务当前状态，再按状态规范里的流程执行。
常见接口
/api/review/tasks/:taskId/decision, /api/review/tasks/:taskId/publish-jobs, /api/review/tasks/:taskId/publish-jobs/:jobId/retry
错误码
conflict
500 内部错误
内部错误
仓储层或发布流程发生非预期失败。
HTTP 状态码
500
示例触发条件或可能原因
存储读写失败。 生成快照时发生异常。 发布后端执行失败。
含义说明
仓储层或发布流程发生非预期失败。
重试安全性与处理建议
先检查服务日志，确认根因被修复后再重试。
常见接口
/api/review/tasks, /api/review/tasks/:taskId/decision, /api/review/tasks/:taskId/publish-jobs
错误码
internal_error