🔒 什么是 API 速率限制?
API 速率限制是保护服务器资源、防止滥用的重要机制。它通过设定请求频率阈值,控制单位时间内客户端可发送的请求数量。例如:

  • 📊 每分钟最多 100 次请求
  • ⏱️ 每秒最多 5 次请求

核心规则

  1. 计数方式
    • 滑动时间窗口(如 1 分钟内累计)
    • 固定时间窗口(如 每小时重置一次)
  2. 触发后果
    • 返回 429 Too Many Requests 状态码
    • 请求被直接拒绝,无响应内容
  3. 查看当前状态
    使用 /api_rate_limits/usage 路径可实时查询剩余配额

如何避免触发限制?

  • 🔄 增加请求间隔时间
  • 📝 遵循文档中的调用规范
  • 🧠 使用缓存减少重复请求

🔗 了解更多速率限制策略

API_rate_limits