速率限制

概述

为了确保所有用户的公平使用并维持最佳性能，Curosa API 对所有端点实施了速率限制。速率限制有助于防止 API 过载，并确保为每个人提供可靠的服务。

速率限制

每个 API 端点都应用了特定的速率限制，除非另有说明，通常为每秒 1 次请求。有关具体的速率限制详情，请参阅各个端点的文档。

速率限制响应

当您超过速率限制时，API 将返回 429 Too Many Requests HTTP 状态码，并附带以下响应：

{"success":false,"message":"Too many requests. Please try again later."}

如果您收到此响应，应暂停请求并在短暂延迟后重试。

最佳实践

为了避免触发速率限制并确保最佳的 API 使用体验，请遵循以下建议：

1. 实施指数退避算法

当您收到 429 响应时，请在重试逻辑中实施指数退避：

• 第一次重试前等待 1 秒
• 每次后续重试的等待时间翻倍（2秒、4秒、8秒等）
• 设置最大重试限制以防止无限循环

重试逻辑示例：

初始请求失败 → 等待 1s → 重试
仍然失败 → 等待 2s → 重试
仍然失败 → 等待 4s → 重试

2. 在适当的情况下缓存响应

通过缓存不经常变化的响应来减少不必要的 API 调用：

• 缓存参考数据（产品目录、类别等）
• 根据数据波动性设置适当的缓存过期时间
• 在可用时使用条件请求

3. 使用 Webhooks 代替轮询

与其反复轮询端点以获取更新，不如使用 Webhook 接收实时通知：

• Webhook 会自动向您推送更新
• 消除频繁轮询请求的需要
• 效率更高，并减轻两个系统的负载
• 有关设置说明，请参阅 Webhooks 文档

4. 尽可能使用批量请求

如果您需要检索多个资源，请检查 API 是否支持批量操作，以减少单个请求的数量。

5. 监控您的使用情况

跟踪您的 API 使用模式并调整您的集成，使其保持在速率限制范围内，并为活动高峰留出空间。

需要更高的限制？

如果您的应用程序需要更高的速率限制，请联系我们的支持团队以讨论您的使用场景并探索可用选项。