Der Workflow bricht ab, und die Fehlermeldung zeigt nur „404“. Dabei verrät diese eine Zahl bereits, wo die Ursache liegt.

Gesehen wird das Symptom in n8n oder Zapier meist bei einem HTTP-Node, also dem Baustein, der fremde Dienste aufruft. Das Log zeigt die dreistellige Nummer, der Workflow stoppt, und unklar bleibt, wer den Fehler beheben kann.

Der Grundbegriff dahinter ist der HTTP-Statuscode. Bei HTTP schickt ein Client eine Anfrage mit Methode, Ziel-URL, Headern und optionalem Inhalt; der Server antwortet mit einem Statuscode, Headern und optionalem Inhalt. Der Client ist hier die eigene Plattform, der Server das fremde System mit dessen API, also Schnittstelle für Programme. Die erste Ziffer des Codes nennt die Klasse: 2xx Erfolg, 3xx Umleitung, 4xx Fehler beim Client, 5xx Fehler beim Server.

Ein Workflow ruft etwa eine API mit falsch gesetzter Kundennummer in der URL auf und erhält 404. Die Lösung ist nicht, es erneut zu versuchen, sondern die URL an die dokumentierte Form anzupassen. Wer URLs oder Feldnamen frei erfindet, statt die Dokumentation zu lesen, erhält meist 404 oder 400.

So prüft man es: Erst den Statuscode lesen, dann die Anfrage prüfen. Bei 4xx die eigene Anfrage korrigieren, etwa 401 durch einen gültigen API-Schlüssel; bei 5xx beim Anbieter warten oder eine Fehlerbenachrichtigung einrichten.

Der Statuscode heißt nicht „irgendein Fehler“, sondern eine Zuordnung: 4xx gehört zur eigenen Anfrage, 5xx zum fremden System. Ein 429 zeigt zudem ein überschrittenes Rate-Limit, also ein Anfragelimit pro Zeitraum.

📌 Statuscode · Fehlerklassen · Fehlerbehandlung

📚 Automatisierung von Grund auf · Tag 2 von 30
#api #Automatisierung #n8n #workflow