跳转到内容

速率限制

了解 BoxHero API 如何按团队限制请求速率,以及如何退避和重试。


为了让所有用户都能稳定使用服务,BoxHero API 会限制每个团队可以发送的请求数量。

属于同一团队的所有 API 令牌共享相同的限制。在一个团队中签发更多令牌并不会提高限制。每秒限制和每分钟限制同时生效,响应头中报告的是每分钟限制。

API 会返回 429 和 type 为 /errors/too-many-requests 的错误信封。响应头会告诉您何时可以重试:

请求头说明
Retry-After重试前需要等待的秒数
RateLimit, X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset当前限制、剩余请求数以及限制重置的时间

请等待 Retry-After 中指定的时间后再重试。如果需要连续发送大量请求,请将其分散发送,而不要一次性全部发送。

如果来自同一 IP 地址的请求反复认证失败(60 秒内超过 30 次),则无论使用哪个令牌,该 IP 的后续请求都会收到 429。