跳转到内容

速率限制

了解 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 中指定的时间后再重试。如果需要连续发送大量请求,请将其分散发送,而不要一次性全部发送。