## Was das Anfragelimit beschränkt

Ein Anfragelimit überwacht, wie oft Ihre Anwendung die API aufrufen darf — also
die Anzahl der Anfragen, nicht die Anzahl der gesendeten Nachrichten. Das Portal
weist in den Einstellungen selbst darauf hin:

> Durch das Festlegen dieses Limits wird die Anzahl der API-Anfragen beschränkt,
> nicht die Anzahl der gesendeten Nachrichten. Wenn das Limit erreicht ist, gibt die
> API den HTTP-Code `429 Too Many Requests` zurück und Nachrichten werden nicht akzeptiert.

Eine einzige Anfrage kann Hunderte von Nachrichten enthalten, daher schützt dieses
Limit etwas anderes als die [API-Nachrichtenlimits](https://www.bulkgate.com/de/dokumentation/api-verwaltung-und-tokens/api-limits/) — es
überwacht das Tempo Ihrer Aufrufe, nicht das versendete Volumen.

> [!IMPORTANT]
> Ist das Limit ausgeschöpft, lehnt die API die **gesamte Anfrage** ab. Die darin enthaltenen
> Nachrichten werden nirgends gespeichert und auch nicht später versendet — anders als beim
> Nachrichtenlimit, bei dem Nachrichten über dem Limit gemäß der eingestellten Aktion bei Limitüberschreitung behandelt werden.

## Wo Sie das Limit finden

1. Klicken Sie im Menü des Portals auf `Module und APIs`
2. Klicken Sie unter `Meine APIs und Module` auf die Karte Ihrer Anwendung
3. Bleiben Sie auf dem Tab `Die Einstellungen` und scrollen Sie zum Abschnitt `API-Grenzwerte`

Die Karte `API-Anforderungslimits` zeigt die Werte in zwei Zeilen — `Maximale Anfragen
pro Minute` und `Maximale Anfragen pro Sekunde`. Solange nichts eingestellt ist, steht
dort `Sie haben keine Einstellungen.` und eine Schaltfläche `Konfigurieren`.

![Die Karte API-Anforderungslimits im Detail der Anwendung](docs:api-request-limits/request-limit-card_en)

## So stellen Sie das Limit ein

Die Schaltfläche `Konfigurieren` (oder `Bearbeiten`, wenn Sie bereits ein Limit haben)
öffnet das Fenster `API-Anforderungslimits` mit zwei voneinander unabhängigen Optionen:

| Option | Was sie einstellt |
|:--|:--|
| `Aktivieren Sie das API-Anforderungslimit pro Minute` | Wie viele Anfragen die Anwendung innerhalb einer Minute senden darf |
| `Aktivieren Sie das API-Anforderungslimit pro Sekunde` | Wie viele Anfragen die Anwendung innerhalb einer Sekunde senden darf |

Durch Ankreuzen einer Option wird das Feld `Geben Sie die Anzahl der Anfragen ein`
eingeblendet. Sie können eine der beiden Optionen aktivieren oder beide gleichzeitig.

![Das Fenster mit den Einstellungen des Anfragelimits](docs:api-request-limits/request-limit-settings_en)

Für die Einstellung gelten zwei Regeln:

- der kleinste zulässige Wert ist `1` — andernfalls weist Sie das Portal mit
  `Minimum value is 1` darauf hin
- wenn Sie beide Optionen aktivieren, darf das Limit pro Sekunde nicht größer sein als
  das Limit pro Minute; andernfalls erhalten Sie `Der Wert darf die Anfragen pro Minute nicht überschreiten`

Die Schaltfläche `sparen` (*Save*) bleibt deaktiviert, bis beide Regeln erfüllt sind —
und auch so lange, bis Sie die Werte gegenüber den bereits gespeicherten ändern.

## Wie das Limit gezählt wird

Der Zähler ist an die Kalendersekunde und -minute gebunden, nicht an ein gleitendes
Zeitfenster. Sobald eine neue Sekunde beginnt (beim Minutenlimit eine neue Minute),
beginnt der Zähler wieder bei null.

> [!TIP]
> Das Limit pro Sekunde eignet sich zum Glätten von Spitzen, das Limit pro Minute für
> das Gesamttempo. Wenn Sie beide einstellen, gelten sie gleichzeitig — eine Anfrage
> geht nur durch, wenn sie in beide passt.

## So entfernen Sie das Limit

Der Pfeil neben der Schaltfläche `Bearbeiten` öffnet ein Menü mit der Option `Löschen`.
Das Bestätigungsfenster `API-Anforderungslimits löschen` fragt `Möchten Sie die
API-Anforderungslimits wirklich löschen?` — nach der Bestätigung beschränkt die API das
Tempo Ihrer Aufrufe nicht mehr.