接入指南
错误处理
错误格式和重试建议。
错误使用统一格式:
{ "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、请求时间和接口地址。