API-Ratengrenzen verstehen

Damit unsere API zuverlässig und leistungsstark bleibt, gibt es bei monday.com verschiedene Ratengrenzen. Diese Ratengrenzen helfen, die Systemlast zu steuern und eine faire Nutzung für alle Benutzer sicherzustellen. Wenn du eine Ratengrenze erreichst, kann es zu vorübergehenden Fehlern kommen. Wenn du die Ratengrenzen verstehst, kannst du solche Unterbrechungen vermeiden.

Technische Details und Beispiele findest du in unserer Entwicklerdokumentation zu Ratengrenzen.

Arten von Ratengrenzen

1. Komplexitätsgrenze

Sie bestimmt, wie „aufwendig“ eine Abfrage ist. Die meisten Benutzer stoßen nicht auf diese Grenze. Wenn doch, wird ein Fehler angezeigt:

• Fehlermeldung: COMPLEXITY_BUDGET_EXHAUSTED
• Das kannst du tun:
• Fordere nur die Daten an, die du wirklich brauchst
• Vermeide zu komplexe oder tief verschachtelte Abfragen
• Nutze Paginierung, wenn möglich

2. Tägliche Aufrufgrenze

Jedes Konto hat eine tägliche Begrenzung für API-Aufrufe:

• Fehlermeldung: DAILY_LIMIT_EXCEEDED

• Das kannst du tun:
• Optimiere deinen Code und reduziere unnötige Aufrufe
• Warte, bis die Grenze um Mitternacht (UTC) zurückgesetzt wird
• Wenn du ein Enterprise-Paket hast, kannst du im API-Analyse-Dashboard im Administrationsbereich von monday.com eine Erhöhung anfordern

3. Minuten-Ratengrenze

Begrenzt die Anzahl der Abfragen pro Minute. Wenn du diese Grenze überschreitest:

• Fehlermeldung: Ratengrenze überschritten
• Das kannst du tun:
• Reduziere die Häufigkeit deiner Anfragen
• Nutze den Retry-After-Header, um zu sehen, wann du es sicher erneut versuchen kannst

4. Gleichzeitige Aufrufgrenze

Begrenzt, wie viele API-Aufrufe gleichzeitig verarbeitet werden.

• Fehlermeldung: maxConcurrencyExceeded
• Das kannst du tun:
• Sende weniger Anfragen parallel
• Füge eine Retry-Logik hinzu und versuche es später erneut

5. IP-Ratengrenze

Begrenzt die Anzahl der Anfragen von einer einzelnen IP-Adresse in kurzer Zeit (5.000 Anfragen pro 10 Sekunden).

• Fehlermeldung: IP_RATE_LIMIT_EXCEEDED
• Das kannst du tun:
• Lege eine Pause ein und versuche es danach erneut. Orientiere dich am Feld retry_in_seconds in der Fehlerantwort

Allgemeine Best Practices

• Alle Anfragen – auch fehlgeschlagene – zählen zu deinen Grenzen.
• Vermeide es, Anfragen direkt nach einem Rate-Limit-Fehler erneut zu senden. Prüfe immer das Feld retry_in_seconds in der Antwort.
• Wenn du unser SDK verwendest, reagiert es automatisch auf Ratengrenzen und sendet Anfragen nach der entsprechenden Wartezeit erneut.

Wenn du als Entwickler mit der API arbeitest, hilft dir die vollständige Dokumentation zu den Ratengrenzen dabei, die Grenzen je nach Anwendungsfall und Paket zu verstehen.

Benötigst du Hilfe bei der Optimierung deiner API-Nutzung? Kontaktiere unser Support-Team