Skip to main content

速率限制概览

API 请求受速率限制,以确保公平使用和系统稳定性。限制在两个层级执行:每 IP 地址每用户账户

当前限制

当任一限制被超出时,API 返回 HTTP 状态码 429 Too Many Requests 并带有 Retry-After 响应头。按账户的限制由您所在的访问组设定,因此可能与上方展示的默认值不同 —— 如需更高限制,请联系 contact@data.cloud

速率限制超出响应

当速率限制被超出时,API 响应如下:

处理速率限制

实现指数退避

最佳实践

  • 实现带抖动的指数退避重试
  • 尽可能缓存响应以减少冗余请求
  • 在支持的情况下使用批量操作(例如批量移除文档)
  • 实现客户端请求队列以平滑流量峰值
  • 监控请求量并记录 429 响应以便可观测

存储与资源配额

存储额度与您的订阅绑定。请在控制台Billing 中查看当前套餐;如果预计有异常大的上传量,请联系 contact@data.cloud

申请更高限制

如需申请更高的速率限制,请发送邮件至 contact@data.cloud 并提供以下信息:
  • 当前使用模式和峰值请求量
  • 预期的未来使用量
  • 使用场景描述

后续步骤

API 概览

返回 API 概览

错误处理

处理速率限制错误