n8n und API-Limits: So steuerst du den Rückstau bei Aufträgen
Sendet dein n8n-Workflow bei einer Auftragsspitze mehr Anfragen, als die Ziel-API aufnimmt, sind HTTP-429-Antworten und liegen gebliebene Vorgänge die Folge. Speichere angenommene Aufträge darum zuerst dauerhaft und reiche sie danach dosiert an das Zielsystem weiter. Auf diese Weise lassen sich Eingang und Verarbeitung getrennt nachverfolgen. Bevor du die Lösung baust, prüfe jedoch, ob die verfügbare API-Kapazität überhaupt reicht, um den Rückstau wieder abzubauen.
Zuerst dauerhaft ablegen, danach weiterreichen
Eine Warteschlange, die dauerhaft gespeichert ist, fängt kurzfristige Auftragsspitzen ab. Jeder Auftrag bekommt eine eindeutige Kennung sowie einen Status. Ein nachgelagerter n8n-Ablauf holt wartende Aufträge ab und gibt sie im Rahmen des verfügbaren API-Limits weiter.
Bestätige den Eingang erst, sobald der Auftrag dauerhaft gespeichert ist. Klappt das Speichern nicht, benötigt der Absender eine passende Fehlermeldung oder einen vereinbarten Rückfallweg. Der Status „eingegangen“ heißt dabei noch nicht, dass das Zielsystem den Auftrag verarbeitet hat.
Langt die Kapazität für den Abbau?
Sieh dir zuerst die Vorgaben des API-Anbieters an: Wie viele Aufrufe sind je Zeitfenster erlaubt, wie viele braucht ein Auftrag, und welche anderen Abläufe nutzen dasselbe Limit mit? Achte ebenso auf Grenzen für parallele Anfragen und für einzelne Endpunkte.
Vereinfachtes Rechenbeispiel: Ein Auftrag benötigt genau einen API-Aufruf. Die API erlaubt 60 Aufrufe pro Minute, andere Prozesse greifen nicht darauf zu. Gehen in einer Spitze gleichmäßig 120 Aufträge pro Minute ein und werden 60 verarbeitet, wächst der Rückstau um 60 Aufträge pro Minute.
Sind danach 600 Aufträge offen und kommen weiterhin 30 pro Minute dazu, bleiben rechnerisch 30 Aufrufe pro Minute für den Abbau übrig. Unter diesen Annahmen wäre der Rückstau nach 20 Minuten abgearbeitet. Wiederholungen, Ausfälle und ungleichmäßige Last können das verlängern.
Nutze das Ergebnis als Grundlage für deine Entscheidung:
- Kapazität liegt dauerhaft über dem Eingang: Kläre, ob der berechnete Abbau in die zulässige Wartezeit passt. Dann kann eine Warteschlange Spitzen auffangen.
- Kapazität liegt dauerhaft auf Höhe des Eingangs oder darunter: Ein größerer Puffer beseitigt den Engpass nicht. Prüfe, ob weniger Aufrufe pro Auftrag, ein höheres Limit oder ein anderer Prozess möglich sind.
- Andere Systeme teilen das Limit: Kalkuliere nur mit dem Anteil, der deinem Ablauf wirklich zur Verfügung steht. Auch Wiederholungen benötigen Kapazität.
Teile den Ablauf in n8n auf
Trenne den Eingangsprozess vom Verarbeitungsprozess. Der erste legt Auftrag, Ereignis-ID, Eingangszeit und Status dauerhaft ab. Der zweite übernimmt wartende Aufträge im Rahmen des verfügbaren Budgets.
Kläre vor der Umsetzung, wie du mit diesen Fällen umgehst:
- Erneute Übermittlung: Nutze für denselben Auftrag die gleiche Kennung, für einen neuen eine andere. Damit erkennst du Wiederholungen.
- Mehrere Verarbeiter: Reserviere Aufträge im Speicher atomar, damit nicht zwei Verarbeiter denselben Auftrag gleichzeitig übernehmen. Eine abgelaufene Reservierung muss nach einem Ausfall kontrolliert freigegeben werden können.
- Gemeinsames API-Limit: Beziehe alle Abläufe und Systeme ein, die dasselbe Budget nutzen. Weniger parallele Ausführungen ersetzen keine Begrenzung über die Zeit. Auch eine Wartezeit in jeder einzelnen Workflow-Ausführung kontrolliert nicht alle parallelen Aufrufe gemeinsam.
- Ergebnis und Wiederholung: Markiere einen Auftrag erst nach bestätigtem Ergebnis als verarbeitet. Halte Fehler, Versuchszahl und nächsten zulässigen Versuchstermin fest.
- Unklares Ergebnis: Bricht die Verbindung nach dem Senden ab, kann der Auftrag bereits im Zielsystem angelegt sein. Prüfe anhand der Kennung nach oder nutze einen unterstützten Idempotenzschlüssel, bevor du erneut schreibst. Das gilt auch, wenn du einen Auftrag nach Ablauf einer Reservierung wieder aufnimmst.
Welche Lösung für Speicherung und Steuerung passt, hängt davon ab, wie du n8n betreibst und welche Schnittstellen dir zur Verfügung stehen.
Bei HTTP 429 besonnen reagieren
HTTP 429 signalisiert, dass die Gegenstelle zu viele Anfragen erhält. Enthält die Antwort einen -Header, plane den nächsten Versuch nicht vor der angegebenen Wartezeit beziehungsweise dem genannten Zeitpunkt. Prüfe zusätzlich die Regeln des Anbieters.
Fehlt die Angabe, lege eine begrenzte Wiederholungsstrategie fest: Warte zwischen den Versuchen zunehmend länger und verteile die Zeitpunkte mit einem zufälligen Versatz. Erfasse jeden Versuch und benachrichtige nach einer festgelegten Grenze die verantwortliche Person, statt endlos weiterzulaufen.
Betrifft der 429 ein gemeinsames Limit, muss die Steuerung auch die anderen Verarbeiter dieses Budgets bremsen. Ungültige Daten oder fehlende Berechtigungen behandelst du anders: Gib diese Aufträge zur Prüfung, statt sie unverändert immer wieder zu senden.
Sammelaufrufe bewusst prüfen
Nimmt die API mehrere Aufträge in einem Aufruf an, kann Bündeln die Zahl der Aufrufe senken. Prüfe aber, ob das Limit pro Aufruf oder pro enthaltenem Datensatz zählt. Ein Sammelaufruf umgeht die Begrenzung nicht automatisch.
Kläre auch Teilerfolge: Nimmt das Zielsystem nur einen Teil der Aufträge an, musst du das Ergebnis jedem Auftrag einzeln zuordnen. Wiederhole nur Positionen, deren erneute Verarbeitung sicher ist. Müssen Aufträge sofort einzeln bestätigt werden oder bietet die API keine geeignete Sammeloperation, ist Bündeln möglicherweise keine passende Lösung.
Halte den Rückstau sichtbar
Beobachte neben der Zahl offener Aufträge auch das Alter des ältesten wartenden Auftrags, Eingangs- und Verarbeitungsrate, 429-Antworten und dauerhaft fehlgeschlagene Vorgänge. Ein steigendes Alter zeigt, dass Aufträge länger liegen bleiben, selbst wenn ihre Zahl noch überschaubar ist.
Vereinbare mit deinem Team konkrete Schwellen und Zuständigkeiten: Wann wird jemand benachrichtigt? Wer prüft das API-Limit und wer entscheidet über den Rückfallweg? Lege auch fest, was bei voller oder nicht verfügbarer Warteschlange geschieht. Bestätige keinen Auftrag als angenommen, wenn er nicht gespeichert wurde.
Wann reicht ein einfacher Wiederholungsversuch?
Bei seltenen, kurzen Spitzen und wenigen unkritischen Vorgängen kann eine begrenzte Wiederholung ausreichen. Voraussetzung ist, dass ein Fehlschlag sichtbar wird und du prüfen kannst, ob erneutes Senden sicher ist.
Eine eigene Warteschlange kostet mehr Aufwand für Speicherung, Überwachung und Betrieb. Sie ist besonders dann eine Option, wenn Aufträge nicht verloren gehen dürfen, mehrere Ausführungen ein Limit teilen oder dein Team Wartezeiten nachvollziehen muss. Sie löst aber weder dauerhaft zu geringe Kapazität noch das Problem, dass sich ein unklarer Schreibvorgang im Zielsystem nicht verlässlich prüfen lässt.
Den nächsten Schritt an einem konkreten Auftrag festmachen
Notiere für einen konkreten Auftragsweg die Eingangsspitze, API-Aufrufe pro Auftrag, das gemeinsam genutzte Limit, den offenen Rückstau und die zulässige Wartezeit. Prüfe dann, wo du den Auftrag vor dem Versand dauerhaft speicherst und wie du einen unklaren Schreibversuch klärst.
Wenn du den Engpass in einem bestehenden n8n-Ablauf besprechen möchtest, kannst du einen Termin zur Prüfung deines Auftragswegs vereinbaren.