Limits für API-Anfragen

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 — es überwacht das Tempo Ihrer Aufrufe, nicht das versendete Volumen.

Wichtig

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

Klicken Sie im Menü des Portals auf Module und APIs
Klicken Sie unter Meine APIs und Module auf die Karte Ihrer Anwendung
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

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

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.

Tipp

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.

War diese Seite hilfreich?

KI fragen Kopiert