错误处理

我们的 API 使用标准 HTTP 响应码来表示请求的成功或失败。以下是你可能遇到的常见错误码及其处理方法。

HTTP 状态码

200 OK

请求成功。

400 Bad Request

请求无效或无法处理。

401 Unauthorized

身份验证失败或未提供。

403 Forbidden

请求已被理解，但被拒绝或不允许访问。

404 Not Found

找不到请求的资源。

429 Too Many Requests

你已超出速率限制。

500 Internal Server Error

我们这边出现了问题。

错误响应格式

所有错误响应都遵循以下格式：

{
  "error": "error_code",
  "message": "Human-readable error message",
  "details": {}
}

常见错误码

invalid_api_key: 提供的 API 密钥无效。

missing_api_key: 未提供 API 密钥。

invalid_ip: 提供的 IP 地址无效。

invalid_domain: 提供的域名无效。

rate_limit_exceeded: 你已超出速率限制。

quota_exceeded: 你已超出每月配额。

server_error: 发生了内部服务器错误。

错误处理最佳实践

检查状态码：在处理响应前，请务必先检查 HTTP 状态码。

处理速率限制：针对 429 错误实施适当的退避和重试逻辑。

记录错误：记录详细的错误信息以便调试。