跳转到内容

接入指南

错误处理

错误格式和重试建议。

错误使用统一格式:

{
"type": "https://docs.aigcgeo.com/errors/conflict",
"title": "CONFLICT",
"status": 409,
"detail": "请求与当前状态冲突",
"requestId": "01J5EXAMPLE"
}

字段校验失败时还会返回 errors,列出字段和原因。

HTTP 含义 处理建议
401 访问凭证无效 检查 Token
402 积分不足 补充积分后再提交
404 记录不存在 检查编号和账户
409 当前状态不允许操作 根据 detail 修正请求
422 参数不正确 根据 errors 修正字段
429 请求过快 延迟后重试
504 请求超时 创建请求使用原幂等键重试

联系支持时请提供 X-Request-ID、请求时间和接口地址。