Skip to main content

错误格式

大多数错误响应返回如下JSON对象:

速率限制头

所有受速率限制器保护的端点返回以下头: 如果达到限制(429),您还会收到:

常见错误响应

400 — 错误请求

用于语法有效但参数无效的请求。

401 — 未授权

缺少或无效的apiKey

403 — 禁止

有效的API密钥,但无权访问此频道或功能。

422 — 验证错误

通常由FastAPI的内部验证返回。

429 — 超出速率限制

当请求量超过每个apiKey的限制时触发。
头:
  • Retry-After: 1
  • X-RateLimit-Limit: 30
  • X-RateLimit-Remaining: 0
  • X-RateLimit-Reset: 1700000000

503 — 服务不可用

如果内部系统(如速率限制器)不可用:

说明

  • code是稳定的,适合程序化处理。
  • message可能会更改(但旨在帮助开发人员)。
  • 大多数端点在速率限制时返回429——请检查您的头。
  • FastAPI验证错误始终作为422返回。