跳转到主要内容
API 使用标准 HTTP 状态码来表示请求的成功或失败。

客户端错误 (4xx)

状态码描述
400Bad Request — 请求无效,通常是缺少必需参数。
401Unauthorized — 未提供有效的 API 密钥。
403Forbidden — API 密钥没有执行该请求的权限。
404Not Found — 请求的资源不存在。
409Conflict — 请求与另一个请求冲突(可能是使用了相同的幂等键)。
429Too Many Requests — 短时间内请求过多,建议使用指数退避重试。

服务端错误 (5xx)

状态码描述
500Internal Server Error — 服务器内部错误,请稍后重试。
503Service Unavailable — 服务器暂时不可用(例如维护中),请稍后重试。