ForHosting KIT · Entwickler-Tools

Webhook verzögert senden

Lassen Sie Ihre URL nach einer Wartezeit Ihrer Wahl aufrufen, von wenigen Sekunden bis zu 30 Tagen: eine Erinnerung 24 Stunden vor Ende einer Testphase oder eine unbezahlte Rechnung, die nach 30 Tagen storniert wird, ohne eigenen Planer. Sie zahlen nach Nutzung, ohne Abo.

● Stabilpro Anfrage + pro Callback$0.002
Nutzen Sie es über Web nur APIAPIE-MailTelegramApp bald

Callback ohne eigenen Timer

Wenn etwas später passieren soll, nicht jetzt

Die meisten Anwendungen reagieren auf das, was gerade geschieht: ein abgeschicktes Formular, eine Zahlung, eine Anmeldung. Sobald etwas eine bestimmte Zeit nach einem Ereignis passieren soll, greifen Teams meist zu einem zusätzlichen Cronjob, einer Nachrichtenwarteschlange oder einer Tabellenzeile, die jede Minute abgefragt wird. Alles drei funktioniert, ist aber für einen einzigen Rückruf überdimensioniert. Hier beschreiben Sie nur die Wartezeit, und wir behalten die Uhr im Blick. Ihr Auftrag wird sofort angenommen, sodass Ihr Programm ohne Warten weiterarbeiten kann.

Wie die Wartezeit funktioniert und wo sie hilft

Sie geben eine Wartezeit von wenigen Sekunden bis zu 30 Tagen an, dazu beliebigen Inhalt, den Sie zurückbekommen möchten. Nichts läuft vorzeitig: Zum gewünschten Zeitpunkt wird Ihre URL mit diesem Inhalt aufgerufen. Scheitert die Zustellung, wird sie dreimal wiederholt, bevor ein klarer Fehler gemeldet wird, und ein gescheiterter Versuch wird nicht berechnet. Typische Fälle sind Erinnerungen vor dem Ende einer Testphase, ein Hinweis nach einem verlassenen Warenkorb, die automatische Stornierung unbezahlter Rechnungen, bewusst verzögerte Wiederholungen bei begrenzten externen Diensten und die Eskalation unbeantworteter Support-Tickets. Es gibt keine Abfrageschleife zu pflegen und keinen Cron-Eintrag, den Sie später entfernen müssen.

Einmalig statt wiederkehrend

Anders als ein Cronjob, der nach einem festen Zeitplan immer wieder auslöst, feuert diese Funktion genau einmal, nach Ablauf der von Ihnen gewählten Wartezeit. Das eignet sich für Vorgänge, die auf ein einzelnes künftiges Ereignis warten, etwa eine Erinnerung 24 Stunden nach einer Bestellung oder eine Zahlungsprüfung zehn Minuten nach dem Start eines Vorgangs.

Wartezeit statt Uhrzeit

Sie geben keine feste Uhrzeit an, sondern eine Verzögerung relativ zum Zeitpunkt der Einrichtung, etwa 15 Minuten, 2 Stunden oder 3 Tage. Das ist praktisch, wenn der Auslöser ein Ereignis in Ihrem System ist, dessen genauer Zeitpunkt erst zur Laufzeit feststeht, und nicht ein bereits im Voraus bekanntes Datum.

Was der Callback mitbringt

Der verzögerte Aufruf sendet die Nutzdaten, die Sie bei der Einrichtung übergeben haben, unverändert an Ihren Endpunkt, zusammen mit einem eindeutigen Kennzeichen für den jeweiligen Vorgang. So lässt sich auf der empfangenden Seite ohne eigene Datenbank nachvollziehen, zu welchem ursprünglichen Vorgang der verspätete Aufruf gehört.

Zahlungsprüfung nach zehn Minuten

Katrin Baumann prüft mit einem verzögerten Callback zehn Minuten nach dem Start einer Zahlung, ob diese abgeschlossen wurde, und markiert unbestätigte Vorgänge automatisch als offen.

Was passiert, wenn mein Endpunkt zum Callback-Zeitpunkt nicht erreichbar ist?

Der Versuch wird protokolliert und als fehlgeschlagen markiert; eine automatische Wiederholung erfolgt nicht von selbst.

Kann ich einen bereits eingerichteten Callback wieder abbrechen?

Ja, solange die Wartezeit noch nicht abgelaufen ist, lässt sich der geplante Aufruf über die zugehörige Kennung stornieren.

Werden die übergebenen Nutzdaten gespeichert?

Nur bis zur Auslösung des Callbacks, danach werden sie nicht weiter aufbewahrt.

Wie lang darf die Wartezeit sein?

Von wenigen Sekunden bis zu 30 Tagen. Sie geben die Wartezeit in Sekunden oder in Minuten an, und vor dem gewünschten Zeitpunkt wird nichts zugestellt.

Wofür nutzt man einen verzögerten Rückruf typischerweise?

Für alles, was eine bestimmte Zeit nach einem Ereignis passieren soll: eine Erinnerung 24 Stunden vor Ende der Testphase, ein Hinweis zwei Stunden nach einem verlassenen Warenkorb, das Stornieren einer unbezahlten Rechnung nach 30 Tagen oder das Eskalieren eines offenen Tickets.

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.

POSThttps://api.kit.forhosting.com/dev/delay

Ein authentifizierter POST erstellt die Aufgabe; das Ergebnis kommt per Webhook oder über einen signierten Link. Diese Funktion ist per API verfügbar, nicht als interaktives Web-Werkzeug.

curl -X POST https://api.kit.forhosting.com/dev/delay \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"webhook_url":"https://example.com/hook"}'
{
  "webhook_url": "https://example.com/hook"
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "dev.delay",
  "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.

pro Anfrage$0.002

Der Preis steht auf der Seite – keine Tokens, keine Credits. Fehlgeschlagene Aufgaben werden nicht berechnet.

HTTPCodeBedeutung
401unauthorizedDer API-Schlüssel fehlt oder ist ungültig – prüfen Sie den Authorization-Header (Bearer).
402insufficient_balanceIhr Guthaben reicht für diese Aufgabe nicht aus – Aufladungen verfallen nicht.
404unknown_typeUnbekannter Aufgabentyp – prüfen Sie das Feld „type“ gegen den Katalog.
429rate_limitedZu viele Anfragen – warten Sie kurz; Polling ist mit 1 Anfrage pro Sekunde erlaubt.

Diese Funktion plant einen einmaligen Webhook-Aufruf für einen späteren Zeitpunkt: Sie geben eine Ziel-Adresse und eine Wartezeit an, zwischen wenigen Sekunden und mehreren Tagen, und KIT ruft die Adresse dann automatisch auf, ohne dass Sie selbst einen Timer oder eine Warteschlange betreiben müssen.

Wo die Verzögerung verwaltet wird

Die Wartezeit läuft auf der KIT-Infrastruktur, nicht auf Ihrem eigenen Server, sodass der Callback auch dann ausgelöst wird, wenn Ihr System zwischenzeitlich neu startet. Genutzt wird die Funktion über diese Seite oder per API; ein eigener Warteschlangendienst allein für verzögerte Aufrufe wird damit überflüssig.

Erinnerung 24 Stunden nach der Bestellung

Ein Onlineshop lässt 24 Stunden nach jeder Bestellung automatisch einen Webhook auslösen, der eine Erinnerungs-E-Mail an Kundinnen und Kunden mit leerem Warenkorb verschickt.

Follow-up drei Tage nach der Registrierung

Die Schneider IT-Systeme GmbH & Co. KG lässt drei Tage nach einer Testregistrierung automatisch einen Webhook auslösen, der eine persönliche Follow-up-E-Mail an neue Interessenten anstößt.

Was kostet ein verzögerter Webhook?

$0.002 pro tatsächlich ausgelöstem Callback, unabhängig von der gewählten Wartezeit.

Wie lange kann die Verzögerung maximal sein?

Von wenigen Sekunden bis zu mehreren Tagen; für sehr lange Fristen über Wochen eignet sich der Cronjob-Webhook mit einem einmaligen Zeitplan besser.

Ist diese Funktion im Browser kostenlos nutzbar?

Nein. Ein verzögerter Aufruf benötigt eine laufende Infrastruktur zwischen Einrichtung und Auslösung; Einrichtung und Ausführung erfolgen über diese Seite oder per API, abgerechnet pro Callback.

Vollständige KIT-Dokumentation lesen →