Zum Inhalt springen

Ratenbegrenzung

Wie die BoxHero API die Anfragerate pro Team begrenzt und wie Sie abwarten und es erneut versuchen.

Damit der Dienst für alle stabil bleibt, begrenzt die BoxHero API, wie viele Anfragen ein Team senden kann.

Alle API-Tokens desselben Teams teilen sich dieselben Limits. Wenn Sie in einem Team weitere Tokens erstellen, erhöht sich das Limit nicht.

Die API antwortet mit 429 und einem Fehlerobjekt, dessen type /errors/too-many-requests ist. Die Antwort-Header geben an, wann Sie es erneut versuchen können:

HeaderBeschreibung
Retry-AfterSekunden, die Sie vor einem erneuten Versuch warten sollten
RateLimit, X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-ResetDas aktuelle Limit, die verbleibenden Anfragen und wann das Limit zurückgesetzt wird

Warten Sie die in Retry-After angegebene Zeit ab und versuchen Sie es dann erneut. Wenn Sie viele Anfragen hintereinander senden, verteilen Sie sie, statt alle auf einmal zu senden.