ForHosting KIT · Entwickler-Tools

Webhook-Payloads umwandeln

Diese Funktion wandelt den JSON-Inhalt eines eingehenden Webhooks in ein anderes Format um – Felder umbenennen, verschachteln, zusammenführen oder herausfiltern. Gedacht für alle, die Webhook-Daten eines Anbieters an die von einer eigenen Anwendung erwartete Struktur anpassen müssen, ohne dafür eigenen Code zu schreiben.

● StabilKostenlos · im Browser
Nutzen Sie es über WebAPIE-MailApp baldTelegram bald

Läuft direkt in Ihrem Browser – kostenlos. Ihre Datei verlässt Ihren Browser nicht und wird an keinen Server übertragen.

Eine Zuordnung statt eigenem Code

Sie fügen ein Beispiel des eingehenden Payloads ein und legen fest, wie die Felder im Ergebnis heißen und angeordnet sein sollen – etwa das Feld „customer.email“ eines Anbieters auf „kunde_email“ in der eigenen Struktur. Die Funktion wendet diese Zuordnung auf jeden weiteren Payload an, ohne dass Sie dafür eine eigene Transformationsfunktion schreiben müssen. Auch feste Zusatzwerte, etwa ein Herkunftskennzeichen, das im ursprünglichen Payload gar nicht vorkommt, lassen sich beim Anlegen der Zuordnung ergänzen.

Verschachtelte Felder und Listen

Die Zuordnung funktioniert auch über mehrere Ebenen hinweg und bei Listen: Ein Array aus Bestellpositionen lässt sich zu einer Summe zusammenfassen, ein tief verschachteltes Feld lässt sich auf die oberste Ebene heben. Damit passt sich der Payload auch dann an, wenn die eigene Anwendung eine deutlich flachere oder andere Struktur erwartet als der Anbieter liefert. Einzelne Elemente einer Liste lassen sich zusätzlich herausfiltern, etwa um nur bezahlte Positionen einer Bestellung an die eigene Anwendung weiterzugeben.

Kostenlos im Browser, per API automatisierbar

Im Browser läuft die Umwandlung direkt im Widget dieser Seite, ohne Limit und ohne dass der Payload übertragen wird. Für den laufenden Betrieb – etwa als Zwischenschritt zwischen einem Zahlungsanbieter und der eigenen Anwendung – steht dieselbe Zuordnung über die API zur Verfügung, für $0.002 pro Ereignis. So lässt sich eine im Browser entworfene und getestete Zuordnung ohne weiteren Aufwand in eine produktive Pipeline übernehmen.

Typische Anbieter und Formate

Häufig eingesetzt wird die Funktion für Webhooks von Zahlungsanbietern, Formular-Diensten oder CRM-Systemen, deren Payload-Struktur sich vom eigenen Datenmodell unterscheidet. Statt bei jeder neuen Integration eine eigene Übersetzungsfunktion zu schreiben, genügt eine einmal eingerichtete Zuordnung, die sich bei Bedarf anpassen lässt. Ändert der Anbieter später die Struktur seines Payloads, lässt sich die bestehende Zuordnung entsprechend nachziehen, statt den gesamten Integrationscode neu zu schreiben.

Zahlungsanbieter an eigenes Datenmodell anpassen

Ein Entwickler bei der Schneider IT-Systeme GmbH & Co. KG richtet eine Zuordnung ein, die eingehende Webhooks eines Zahlungsanbieters in das interne Bestellformat der eigenen Anwendung umwandelt, bevor sie weiterverarbeitet werden.

Formulardaten für ein internes System aufbereiten

Anna Hoffmann leitet Webhook-Daten eines Formular-Dienstes über die Funktion um, damit Feldnamen und Struktur zum internen CRM-System passen, ohne dass jemand im Team eigenen Übersetzungscode pflegen muss.

Testfälle für die eigene Webhook-Verarbeitung prüfen

Ein Entwickler testet im Browser-Widget, ob ein Beispiel-Payload korrekt in das erwartete Zielformat überführt wird, bevor er die Zuordnung in die produktive Pipeline übernimmt.

Verlässt der Payload meinen Browser?

Nein, solange Sie die Funktion im Browser nutzen. Die Umwandlung läuft direkt auf dieser Seite, ohne Übertragung an einen Server.

Muss ich mich anmelden?

Nein. Es gibt derzeit keine Konten – die Nutzung im Browser ist kostenlos und ohne Limit.

Wie richte ich eine Zuordnung ein?

Sie fügen ein Beispiel des eingehenden Payloads ein und legen fest, wie die Zielfelder heißen und angeordnet sein sollen; die Zuordnung lässt sich anschließend speichern und wiederverwenden.

Funktioniert das auch mit verschachtelten Feldern und Listen?

Ja. Felder lassen sich über mehrere Ebenen hinweg verschieben, und Listen lassen sich zusammenfassen oder filtern.

Was kostet die Nutzung über die API?

$0.002 pro Ereignis. Im Browser bleibt die Funktion unabhängig davon kostenlos.

Für welche Webhook-Anbieter eignet sich das?

Für jeden Anbieter, dessen Payload im JSON-Format vorliegt – häufig genutzt bei Zahlungsanbietern, Formular-Diensten und CRM-Systemen.

Gibt es einen AVV für die Verarbeitung von Kundendaten im Payload?

Aktuell steht kein separater Auftragsverarbeitungsvertrag zur Verfügung. Wer das für sein Unternehmen benötigt, schreibt uns bitte vorab an [email protected].

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/webhook-transform

Authentifizierung per Bearer-Token. Ein einziger POST stellt die Aufgabe in die Warteschlange; das Ergebnis erhalten Sie per Webhook oder über einen signierten Link.

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

Vollständige KIT-Dokumentation lesen →