错误代码

理解API错误响应

错误响应格式

所有错误响应均遵循此格式：

{
  "success": false,
  "error": {
    "code": "error_code",
    "message": "Human-readable error message"
  }
}

错误代码

400Bad Request

请求参数无效或格式错误。

解决方案: 检查您的请求体，确保所有必填字段均已填写且数值有效。

401Unauthorized

API密钥无效或缺失。

解决方案: 请确保在Authorization请求头中包含有效的API密钥。

402Payment Required

您的API钱包余额不足。

解决方案: 购买更多积分或等待积分自动补充。

403Forbidden

API访问未获批准或您的账户已被暂停。

解决方案: 如您认为这是系统错误，请及时联系技术支持。

404Not Found

请求的资源（任务、Webhook 等）未找到。

解决方案: 请确认资源ID是否正确。

429Too Many Requests

短时间内请求过多。

解决方案: 实施指数退避机制并遵守速率限制。

500Internal Server Error

我们这边出了点问题。

解决方案: 短暂延迟后重试请求。如果问题仍然存在，请联系技术支持。

速率限制

默认频率限制：