Webhooks: Benachrichtigungen über Änderungen erhalten

SCS verfügt über einen Mechanismus, mit dem Drittanbietersysteme informiert werden, wenn ein wichtiges Ereignis oder ein Auslöser in der Anwendung eintritt. Um eine Benachrichtigung zu erhalten, muss eine URL angegeben werden, die eine HTTP-GET-Anforderung akzeptiert. SCS enthält zusätzliche Auslöserfelder als Parameter, die an die URL angefügt werden.

Ein Satz von Webhooks sendet eine HTTP-POST-Anforderung. Mit POST werden Datenelemente als gepostete Daten gesendet, im Gegensatz zum Senden als Anforderungsparameter in der URL. Der Text der geposteten Daten ist ein JSON-Dokument. Daher sollte der Empfänger so eingerichtet sein, dass der Inhaltstyp "application/json" akzeptiert wird. Alle Webhooks verwenden GET-Anforderungen, sofern in der Dokumentation nicht anders angegeben.

Das POST-JSON-Dokument besteht aus drei Elementen: security, common und data. Die Elemente "security" und "common" enthalten die im folgenden Abschnitt dokumentierten Daten. Daten, die sich speziell auf die Webhook-Aktion beziehen, sind im Datenelement im folgenden Bereich verfügbar.

Beispiel: Webhooks