错误处理
按 HTTP 状态、错误标识和任务结果定位失败。
常见错误响应包含错误码、说明和请求标识:
{
"error": {"code": "<错误标识>", "message": "<可读说明>"},
"request_id": "<请求标识>"
}| HTTP | 含义 |
|---|---|
| 400 | 参数或请求校验失败 |
| 401 | 未登录、会话失效或认证方式不支持 |
| 403 | 无权操作,或写请求的 CSRF/Origin 不满足 |
| 404 | 目标不存在或在当前授权范围不可见 |
| 409 | 资源状态、依赖关系或幂等冲突 |
| 429 | 请求过于频繁 |
| 500 / 503 | 内部失败或依赖服务不可用 |
各接口可能只声明其中部分状态。以该操作的参考页和实际响应为准,不仅根据中文说明编写错误分支。
已受理任务之后失败不一定改变原 HTTP 状态,需要查询任务及关联资源。超时不一定未执行,使用原幂等键并查询已有结果,避免重复创建。
向平台支持提供时间、接口、请求标识及任务/资源身份;移除 Cookie、密码、密钥和临时控制台 URL。
