Handbuch · 7

Webhooks

Ein Webhook ruft bei einem Ereignis eine externe URL per HTTP auf – gebunden an eine Datenquelle, nicht an eine einzelne Tabelle (optional lässt sich die Tabellen-Auswahl aber auf bestimmte Tabellen einschränken; leer heißt “alle Tabellen dieser Datenquelle”).

Konfiguration (“Webhooks verwalten” auf der Datenquellen-Detailseite):

  • Ziel-URL
  • Ereignisse – record.created, record.updated, record.deleted
  • Tabellen – optional einschränkbar
  • Secret (optional) – wenn gesetzt, wird jede Zustellung mit HMAC-SHA256 signiert (Header X-Webhook-Signature), damit der Empfänger die Echtheit prüfen kann.
  • Aktiv/Inaktiv-Schalter.

Zustellung läuft nebenläufig, mit bis zu drei Wiederholungsversuchen bei Fehlschlag (Wartezeiten 1s, 5s, 15s). Status der letzten Zustellung (Zeitpunkt, HTTP-Status, ggf. Fehlermeldung) wird angezeigt.

Für Automatisierung innerhalb von IllusionDB (statt eines externen HTTP-Aufrufs) siehe stattdessen Hooks – gleiches Ereignisset, aber ein Skript statt eines externen Ziels.