ForHosting KIT · Benachrichtigungen & Automatisierung

Webhook empfangen und weiterleiten

Diese Funktion nimmt eine eingehende Nachricht entgegen, liest die enthaltenen Daten aus und leitet sie strukturiert an eine von Ihnen angegebene Ziel-URL weiter – etwa um ein Ereignis aus einem System an ein anderes zu melden, ohne dafür einen eigenen Vermittlungsserver zu betreiben.

● Stabilpro Anfrage + pro Zustellung$0.002

Ausführen — $0.002 API ansehen

Nutzen Sie es über WebAPIE-MailApp baldTelegram bald

Online ausführen

Führen Sie dies mit Ihrem Konto auf unseren Servern aus. Kostenlose Tools laufen in Ihrem Browser; dieses wird zum oben genannten Preis von Ihrem KIT-Guthaben abgebucht.

Ein Vermittler zwischen zwei Systemen

Viele Dienste senden Ereignisse als Webhook: eine automatische HTTP-Anfrage mit Nutzdaten, sobald etwas passiert, etwa eine Zahlung oder eine neue Bestellung. Diese Funktion empfängt eine solche Anfrage, liest die enthaltenen Daten aus und leitet sie – bei Bedarf umgeformt – an eine Ziel-URL Ihrer Wahl weiter. Das eignet sich, um zwei Systeme zu verbinden, die sich sonst nicht direkt verstehen.

Wenn das Format nicht passt

Nicht jedes Zielsystem erwartet dieselbe Struktur wie der ursprüngliche Absender. Diese Funktion liest die eingehenden Daten aus und stellt sie in der vom Zielsystem erwarteten Form bereit, statt die Rohdaten unverändert weiterzureichen. Das erspart eine eigene kleine Vermittlungsanwendung nur für die Umformung eines einzelnen Datenformats, gerade bei älteren Systemen mit eigenwilligem Format ein spürbarer Zeitgewinn. Auch das Herausfiltern einzelner, für das Zielsystem irrelevanter Felder lässt sich auf diesem Weg erledigen.

Preis und Zuverlässigkeit

Jede weitergeleitete Zustellung kostet $0.002, unabhängig von der Größe der Nutzdaten. Schlägt die Zustellung an die Ziel-URL fehl, etwa weil das Zielsystem kurzzeitig nicht erreichbar ist, lässt sich der Versand mit der Wiederholungsfunktion automatisch erneut versuchen, statt den fehlgeschlagenen Aufruf manuell zu erkennen und neu auszulösen. So bleibt die Verbindung zwischen beiden Systemen auch bei kurzen Ausfällen stabil. Die Anzahl der Wiederholungsversuche und die Abstände dazwischen legen Sie in der Wiederholungsfunktion selbst fest.

Anwendungsfälle

Zahlungsereignis an ein internes System melden

Schneider IT-Systeme GmbH & Co. KG leitet eingehende Zahlungsbestätigungen eines Zahlungsdienstleisters automatisch an die eigene Auftragsverwaltung weiter.

Formular-Ereignis in ein anderes Format bringen

Ein Onlineshop wandelt eingehende Formulardaten in die Struktur um, die das interne CRM erwartet, ohne eine eigene Vermittlungsanwendung zu programmieren.

Bestellereignis an ein Lagerverwaltungssystem

Ein Handwerksbetrieb meldet neue Bestellungen automatisch an die Lagerverwaltung weiter, sobald sie im Onlineshop eingehen.

Häufige Fragen

Was genau ist eine Zustellung in diesem Zusammenhang?

Eine Zustellung ist eine eingehende Anfrage, die ausgewertet und an Ihre Ziel-URL weitergeleitet wird; sie ist die Abrechnungseinheit dieser Funktion.

Kann ich das Datenformat vor der Weiterleitung ändern?

Ja, die eingehenden Daten lassen sich in die vom Zielsystem erwartete Struktur umformen, statt sie unverändert durchzureichen.

Was passiert, wenn die Ziel-URL nicht erreichbar ist?

Die Zustellung schlägt für diesen Versuch fehl; in Kombination mit der Wiederholungsfunktion lässt sich ein erneuter Versuch automatisch auslösen.

Was kostet eine weitergeleitete Zustellung?

$0.002 pro Zustellung, unabhängig von der Größe der Nutzdaten.

Werden die weitergeleiteten Daten bei Ihnen gespeichert?

Nein, sie dienen ausschließlich der Weiterleitung dieser einen Zustellung und werden danach nicht aufbewahrt.

Eignet sich das auch für sehr häufige Ereignisse?

Ja, jede Zustellung wird einzeln abgerechnet und verarbeitet; ein festes Obergrenzenlimit ist aktuell nicht gesondert veröffentlicht.

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

POSThttps://api.kit.forhosting.com/notify/webhook

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/notify/webhook \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d &#39;{"input":"…"}'

const res = await fetch("https://api.kit.forhosting.com/notify/webhook", {
  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/notify/webhook",
    headers={"Authorization": f"Bearer {os.environ[&#39;KIT_KEY']}"},
    json={
    "input": "…"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/notify/webhook", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => &#39;{"input":"…"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"input":"…"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/notify/webhook", 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": "notify.webhook",
  "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

pro Anfrage$0.002

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.

Vollständige KIT-Dokumentation lesen →