Fehlgeschlagene Aufgabe automatisch wiederholen
Diese Funktion wiederholt einen fehlgeschlagenen Schritt automatisch nach einer festgelegten Strategie, statt dass Sie den Fehler manuell bemerken und den Aufruf von Hand erneut auslösen müssen – etwa nach einem kurzzeitig nicht erreichbaren Zielsystem. So bleibt ein Ablauf auch bei kurzen technischen Störungen zuverlässig.
Nicht jeder Fehler ist endgültig
Ein Zielsystem ist kurz nicht erreichbar, eine Netzwerkverbindung bricht ab, ein Dienst antwortet einmalig nicht: Solche Fehler sind oft vorübergehend und beim nächsten Versuch bereits behoben. Diese Funktion wiederholt einen fehlgeschlagenen Schritt automatisch nach einer festgelegten Anzahl Versuche, statt den Fehler unbearbeitet stehen zu lassen oder ihn manuell erneut auszulösen. Ohne eine solche Wiederholung müsste jeder vorübergehende Fehler manuell erkannt und erneut ausgelöst werden.
Wachsende Abstände zwischen den Versuchen
Statt sofort und wiederholt hintereinander erneut zu versuchen, wächst der Abstand zwischen den Versuchen mit jedem Fehlschlag – ein Verfahren, das ein kurzzeitig überlastetes Zielsystem nicht zusätzlich belastet. Nach einer festgelegten Anzahl erfolgloser Versuche gibt die Funktion den Schritt als endgültig fehlgeschlagen aus, statt endlos weiterzuversuchen. Die genaue Anzahl der Versuche und die Wachstumsrate der Abstände legen Sie selbst fest.
Preis und Einsatz
Jeder tatsächlich ausgeführte Wiederholungsversuch kostet $0.002, zusätzlich zu den Kosten des wiederholten Schritts selbst. Ein Schritt, der bereits beim ersten Versuch gelingt, verursacht keine zusätzlichen Kosten. Kombiniert mit der Kettenfunktion oder dem Zeitplan lässt sich so ein einzelner unzuverlässiger Schritt gezielt absichern, ohne den gesamten Ablauf robuster gestalten zu müssen. So entstehen keine doppelten Kosten für einen Schritt, der ohnehin sofort gelingt.
Anwendungsfälle
Webhook an ein kurzzeitig überlastetes System
Ein Onlineshop wiederholt eine fehlgeschlagene Zustellung an das Lagerverwaltungssystem automatisch, statt die Bestellung manuell nachzutragen.
E-Mail-Versand bei kurzzeitigem Fehler
Ein Softwareanbieter aus Hamburg wiederholt den Versand einer Bestätigungsmail automatisch, wenn der erste Versuch technisch fehlschlägt.
Externe Datenabfrage in einer Kette
Ein IT-Dienstleister sichert einen einzelnen unzuverlässigen Schritt einer längeren Kette mit automatischen Wiederholungen ab, statt die gesamte Kette bei einem Fehlschlag neu zu starten.
Häufige Fragen
Wie oft wird ein fehlgeschlagener Schritt wiederholt?
Sie legen die Anzahl der Versuche fest; der Abstand zwischen den Versuchen wächst mit jedem Fehlschlag.
Kostet ein erfolgreicher Schritt beim ersten Versuch zusätzlich?
Nein, berechnet wird ausschließlich ein tatsächlich ausgeführter Wiederholungsversuch, mit $0.002 je Versuch.
Was passiert nach der letzten erfolglosen Wiederholung?
Der Schritt gilt als endgültig fehlgeschlagen; das Ergebnis zeigt dies eindeutig an, statt endlos weiterzuversuchen.
Lässt sich das mit einer Kette kombinieren?
Ja, ein einzelner Schritt innerhalb einer Kette lässt sich gezielt mit automatischen Wiederholungen absichern.
Für welche Art von Fehlern eignet sich das?
Vor allem für vorübergehende Fehler wie ein kurzzeitig nicht erreichbares Zielsystem, nicht für dauerhaft falsche Eingabedaten.
Gibt es ein Höchstlimit für die Anzahl der Versuche?
Aktuell ist kein festes Höchstlimit veröffentlicht; sinnvoll sind in der Praxis wenige Versuche mit wachsendem Abstand.
Für Entwickler — API-Zugang
Alles auf dieser Seite ist auch per API verfügbar. Dieser Abschnitt richtet sich an Teams, die es in ihre eigenen Systeme einbinden möchten; alle anderen nutzen einfach das Tool oben.
Endpunkt
Authentifizierung per Bearer-Token. Ein einziger POST stellt die Aufgabe in die Warteschlange; das Ergebnis erhalten Sie per Webhook oder über einen signierten Link.
Aufruf aus Ihrem Stack
curl -X POST https://api.kit.forhosting.com/flow/retry \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"input":"…"}'const res = await fetch("https://api.kit.forhosting.com/flow/retry", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"input": "…"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/flow/retry",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"input": "…"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/flow/retry", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"input":"…"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"input":"…"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/flow/retry", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Beispiel-Anfrage
{
"input": "…"
}Beispiel-Antwort
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "flow.retry",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}Die API arbeitet asynchron: Sie erhalten sofort eine task_id. Polling ist mit 1 Anfrage pro Sekunde erlaubt.
Preis
Der Preis steht auf der Seite – keine Tokens, keine Credits. Fehlgeschlagene Aufgaben werden nicht berechnet.
Fehler
| HTTP | Code | Bedeutung |
|---|---|---|
401 | unauthorized | Der API-Schlüssel fehlt oder ist ungültig – prüfen Sie den Authorization-Header (Bearer). |
402 | insufficient_balance | Ihr Guthaben reicht für diese Aufgabe nicht aus – Aufladungen verfallen nicht. |
404 | unknown_type | Unbekannter Aufgabentyp – prüfen Sie das Feld „type“ gegen den Katalog. |
429 | rate_limited | Zu viele Anfragen – warten Sie kurz; Polling ist mit 1 Anfrage pro Sekunde erlaubt. |