速率限制概览
API 请求受速率限制,以确保公平使用和系统稳定性。限制在两个层级执行:每 IP 地址和每用户账户。当前限制
当任一限制被超出时,API 返回 HTTP 状态码
429 Too Many Requests 并带有 Retry-After 响应头。按账户的限制由您所在的访问组设定,因此可能与上方展示的默认值不同 —— 如需更高限制,请联系 contact@data.cloud。速率限制超出响应
当速率限制被超出时,API 响应如下:处理速率限制
实现指数退避
最佳实践
- 实现带抖动的指数退避重试
- 尽可能缓存响应以减少冗余请求
- 在支持的情况下使用批量操作(例如批量移除文档)
- 实现客户端请求队列以平滑流量峰值
- 监控请求量并记录
429响应以便可观测
存储与资源配额
存储额度与您的订阅绑定。请在控制台的 Billing 中查看当前套餐;如果预计有异常大的上传量,请联系 contact@data.cloud。
申请更高限制
如需申请更高的速率限制,请发送邮件至 contact@data.cloud 并提供以下信息:- 当前使用模式和峰值请求量
- 预期的未来使用量
- 使用场景描述
后续步骤
API 概览
返回 API 概览
错误处理
处理速率限制错误