Webhooks
7 endpoints
Registrierung und Verwaltung von Webhooks: verfügbare Ereignistypen lesen, Endpunkte an- und abmelden, das Datenformat setzen und das Zustellprotokoll abrufen.
Ein Webhook liefert keine Nutzdaten, sondern eine Referenz auf den Datensatz — entityId samt Abruf-Endpunkt. Den eigentlichen Abruf macht Ihr System selbst.
Zwei Dinge sind für den Betrieb entscheidend:
- Antworten Sie sofort mit
200. Nach 10 fehlgeschlagenen Zustellungen wird die Registrierung pausiert. - Auch dann gehen keine Ereignisse verloren: sie werden weiter protokolliert und lassen sich über den Protokoll-Endpunkt nachträglich abrufen.
Wie das im Zusammenspiel aussieht, zeigt der Integrationsguide.
GET/webhooks/event/typesWebhook Ereignistypen lesenGET/webhooks/settingsWebhook Einstellungen lesenPUT/webhooks/settings/eventdatatype/{webhookEventDataType}Webhook Ereignisdatentyp setzenGET/webhooks/subscriptionsSubscriptions lesenPOST/webhooks/subscribeSubscribePOST/webhooks/unsubscribeUnsubscribePOST/webhooks/protocolProtocol lesen