> For the complete documentation index, see [llms.txt](https://www.boxhero.io/docs/llms.txt). Every page is available as Markdown by appending `.md` to its URL; this page is [Markdown](https://www.boxhero.io/docs/de/developers/api/rate-limiting.md).

# 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.

## Limits gelten pro Team

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

## Wenn Sie das Limit erreichen

Die API antwortet mit `429` und einem [Fehlerobjekt](https://www.boxhero.io/docs/de/developers/api/errors.md), dessen `type` `/errors/too-many-requests` ist. Die Antwort-Header geben an, wann Sie es erneut versuchen können:

| Header | Beschreibung |
| --- | --- |
| `Retry-After` | Sekunden, die Sie vor einem erneuten Versuch warten sollten |
| `RateLimit`, `X-RateLimit-Limit`, `X-RateLimit-Remaining`, `X-RateLimit-Reset` | Das 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.

> **Note**
>
> Limits können sich ändern. Lesen Sie sie aus den Antwort-Headern, statt eine Rate fest in Ihrem Client zu codieren.