API-Rate-Limits planen: Workflows im Mittelstand absichern

Wenn Workflows mittags um zwölf stillstehen

Der CRM-Sync läuft seit Wochen stabil. Dann, mitten am Vormittag, brechen alle Leads ab. Die Fehler-Mail zeigt „429 Too Many Requests”. Das Vertriebs-Team ruft an, weil keine neuen Kontakte ankommen. Die Ursache: Ihr Workflow hat das API-Rate-Limit des CRM-Anbieters überschritten, weil ein Marketing-Kollege parallel eine Liste mit 800 Kontakten hochgeladen hat.

Solche Ausfälle sind vermeidbar. Rate-Limits sind keine willkürliche Schikane, sondern schützen API-Anbieter vor Überlast. Jeder SaaS-Dienst legt fest, wie viele Anfragen pro Minute, Stunde oder Tag erlaubt sind. Wer das übersieht, plant Workflows, die unter Last zusammenbrechen. Dieser Artikel zeigt, wie Sie Ihre API-Calls dimensionieren, Puffer einbauen und Engpässe frühzeitig erkennen.

Was sind API-Rate-Limits

Ein API-Rate-Limit definiert die maximale Zahl von Anfragen, die ein Dienst in einem bestimmten Zeitfenster akzeptiert. Typische Grenzen liegen bei 100 Anfragen pro Minute oder 10.000 pro Tag. Überschreiten Sie das Limit, antwortet die API mit HTTP-Statuscode 429 und lehnt weitere Anfragen ab, bis das Zeitfenster abgelaufen ist.

Die Grenzen stehen in der Dokumentation des Anbieters, oft unter „API Reference” oder „Rate Limiting Policy”. Manche Dienste staffeln nach Preisstufe: Ein Basis-Tarif erlaubt 60 Calls pro Minute, ein Business-Tarif 300. Andere zählen pro Account, wieder andere pro API-Key oder IP-Adresse. Klären Sie vor dem Start, welche Dimension gilt, sonst rechnen Sie mit falschen Werten.

Häufige Engpässe in mittelständischen Workflows

Im Mittelstand entstehen Engpässe oft dort, wo mehrere Systeme gleichzeitig auf dieselbe API zugreifen:

• CRM-Sync: Ein Workflow holt alle 5 Minuten neue Leads aus dem CRM. Parallel importiert ein Kollege manuell eine Excel-Liste. Beide Vorgänge addieren sich und überschreiten das Limit.
• E-Mail-Versand: Marketing verschickt eine Kampagne über die API. Der Versanddienstleister erlaubt 100 Mails pro Minute, Ihr Workflow versucht aber 200 in einem Durchlauf.
• Dokumenten-OCR: Sie scannen Belege und rufen für jeden ein OCR-API auf. Bei 50 Rechnungen am Morgen stoßen Sie an die Grenze von 30 Calls pro Minute.
• Reporting-Dashboards: Ein Cron-Job sammelt jede Nacht Daten aus fünf Systemen. Wenn alle Abfragen gleichzeitig starten, blockiert ein Dienst die anderen.

In allen Fällen fehlt eine zentrale Übersicht, wer wann wie viele Calls auslöst. Ohne Planung eskaliert jede manuelle Aktion zur Störung.

So ermitteln Sie Ihren tatsächlichen Bedarf

Bevor Sie Workflows bauen, rechnen Sie aus, wie viele API-Calls pro Zeiteinheit anfallen. Nehmen Sie dazu ein typisches Szenario und multiplizieren Sie:

1. Anzahl Datensätze: Wie viele Leads, Rechnungen oder Kontakte verarbeitet der Workflow pro Durchlauf?
2. Calls pro Datensatz: Manche Workflows brauchen mehrere Anfragen, etwa eine für Kundendaten, eine für Bestellhistorie, eine für Produktdetails.
3. Durchläufe pro Zeiteinheit: Läuft der Workflow alle 5 Minuten, jede Stunde oder einmal täglich?
4. Parallele Workflows: Greifen andere Automatisierungen oder manuelle Prozesse auf dieselbe API zu?

Addieren Sie alle Werte und vergleichen Sie das Ergebnis mit dem Limit des Anbieters. Liegt Ihr Bedarf über 70 Prozent des Limits, planen Sie einen Puffer ein. Manuelle Ad-hoc-Aktionen oder Lastspitzen verbrauchen die Reserve.

Strategien zur Einhaltung von Limits

Wenn der Bedarf das Limit übersteigt, haben Sie vier Stellschrauben:

Batching: Fassen Sie mehrere Datensätze in einer Anfrage zusammen. Statt 100 einzelne Calls für 100 Kontakte senden Sie einen Batch-Call mit allen 100 Einträgen. Viele APIs bieten Bulk-Endpunkte, die 500 oder mehr Datensätze in einem Request akzeptieren. Die Dokumentation nennt die maximale Batch-Größe.

Throttling: Bauen Sie Wartezeiten zwischen die Calls ein. Workflow-Plattformen wie n8n oder Make bieten „Delay”-Nodes. Wenn die API 60 Calls pro Minute erlaubt, warten Sie nach jedem Call eine Sekunde. So bleiben Sie unter der Grenze, auch wenn der Workflow viele Datensätze verarbeitet.

Zeitliche Verteilung: Starten Sie Workflows zu unterschiedlichen Zeiten. Wenn der CRM-Sync um 09:00 Uhr läuft, legen Sie den Reporting-Job auf 09:30 Uhr. Manuelle Importe planen Sie für den Nachmittag, wenn die automatischen Prozesse durch sind.

Upgrade oder Splitting: Prüfen Sie, ob ein höherer Tarif beim API-Anbieter mehr Kontingent bringt. Manche Dienste verdoppeln das Limit für 20 Euro im Monat. Alternativ verteilen Sie die Last auf mehrere API-Keys oder Sub-Accounts, falls der Anbieter das erlaubt.

Rechenbeispiel: CRM-Sync mit Batch und Throttling

Nehmen Sie an, Ihr CRM enthält täglich 200 neue Leads. Der Workflow holt sie alle 10 Minuten ab. Ohne Batching brauchen Sie pro Durchlauf 200 Calls. In einer Stunde sind das 6 Durchläufe mal 200, also 1.200 Calls. Die API erlaubt aber nur 300 pro Stunde.

Mit Batching fassen Sie 50 Leads pro Call zusammen. Dann brauchen Sie 4 Calls pro Durchlauf, in einer Stunde 24 Calls. Das liegt weit unter dem Limit. Sollte das CRM-Batch-API 100 Leads pro Call akzeptieren, sinkt der Bedarf auf 12 Calls pro Stunde.

Falls Batching nicht möglich ist, bauen Sie Throttling ein. Sie warten nach jedem Call 1,2 Sekunden. Dann dauern 200 Calls rund 4 Minuten. In einer Stunde passen 15 Durchläufe, das sind 3.000 Calls, immer noch zu viel. Sie reduzieren die Frequenz auf alle 30 Minuten. Dann sind es 400 Calls pro Stunde, knapp über dem Limit. Ein Delay von 2 Sekunden pro Call verlängert den Durchlauf auf 6,7 Minuten und senkt die stündlichen Calls auf unter 300.

Diese Werte sind Annahmen für die Kalkulation. Die tatsächlichen Grenzen entnehmen Sie der API-Dokumentation Ihres Anbieters.

Monitoring und Fehlerbehandlung

Planen Sie Monitoring ein, bevor der erste 429-Fehler auftritt. Workflow-Plattformen loggen Fehlercodes. Richten Sie Alerts ein, die Sie sofort informieren, wenn ein Rate-Limit erreicht wird. So können Sie reagieren, bevor der Workflow komplett stoppt.

Bauen Sie Retry-Logik in kritische Workflows ein. Wenn die API mit 429 antwortet, wartet der Workflow 60 Sekunden und versucht den Call erneut. Manche APIs liefern im Response-Header „Retry-After” die Wartezeit in Sekunden. Lesen Sie diesen Wert aus und pausieren Sie entsprechend.

Dokumentieren Sie, welche Workflows welche APIs nutzen und wie viel Kontingent sie verbrauchen. Eine einfache Tabelle reicht: Workflow-Name, API-Anbieter, Calls pro Stunde, Limit, Auslastung in Prozent. Aktualisieren Sie die Tabelle, wenn Sie neue Automatisierungen hinzufügen oder bestehende ändern.

Was nicht funktioniert

Viele Mittelständler versuchen, Limits durch Polling-Intervalle zu umgehen: Sie fragen die API alle paar Sekunden ab, ob neue Daten da sind. Das verbraucht Kontingent für leere Antworten. Nutzen Sie stattdessen Webhooks, falls der Anbieter sie anbietet. Der Dienst pusht dann Änderungen aktiv an Ihren Workflow, ohne dass Sie ständig nachfragen müssen.

Ein weiterer Fehler ist, Calls in Schleifen ohne Pause abzufeuern. Workflow-Plattformen führen Nodes schnell hintereinander aus. Ohne explizites Delay senden Sie in Sekundenbruchteilen Dutzende Requests und sprengen jedes Limit.

Verlassen Sie sich nicht darauf, dass der Anbieter großzügig ist. Dokumentierte Limits werden durchgesetzt. Überschreitungen führen zu HTTP-429-Fehlern, manchmal zu temporären IP-Sperren oder zur Sperrung des API-Keys. Die Wiederherstellung kostet Zeit und nervt Ihr Team.

Fazit und nächster Schritt

API-Rate-Limits sind kein technisches Detail, sondern ein Planungsfaktor für stabile Automatisierungen. Ermitteln Sie Ihren Bedarf, vergleichen Sie ihn mit den Grenzen der Anbieter und bauen Sie Puffer ein. Batching, Throttling und zeitliche Verteilung halten die Last im Rahmen. Monitoring zeigt frühzeitig, wenn ein Workflow das Limit erreicht.

Wenn Sie Ihre bestehenden Workflows prüfen oder neue Automatisierungen aufsetzen möchten, sprechen Sie mit uns. Wir dimensionieren API-Calls für mittelständische Szenarien und richten Monitoring ein, bevor Workflows ausfallen.

Sprechen Sie mit uns

Sie möchten das in Ihrem Betrieb umsetzen? Wir bauen die passende Maschine mit Ihnen.

Telefon: 040 468 967 680
E-Mail: info@whitefox-automations.com
Oder über unser Kontaktformular.