Webhooks

Das Webhook-System wird in der AWS-Region us-east-1 und eu-west-1 gehostet.

Die IP-Bereiche für AWS finden Sie unter folgendem Link:

http://docs.aws.amazon.com/general/latest/gr/aws-ip-ranges.html

Für Premium-Kund*innen mit globalen Unternehmen garantieren wir das Senden von Webhooks ausschließlich aus der folgenden Liste von IPs:

Für Premium-Kund*innen mit EU-Datenresidenz garantieren wir das Senden von Webhooks ausschließlich aus der folgenden Liste von IPs:

Falls es Änderungen an der Liste der IPs gibt, werden diese im Voraus umfassend und proaktiv über alle verfügbaren Kanäle an alle aktiven registrierten Nutzer*innen kommuniziert.

Die Bereitstellungs-API wird von einem CDN-Netzwerk betrieben, das aus Hunderten von Servern besteht, die über Kontinente verteilt sind. Der CDN Layer wird bereinigt, wenn Sie einen Eintrag in einem Space veröffentlichen. Die Bereinigung erfolgt sofort und der neue Content wird innerhalb von Sekunden verbreitet. Es gibt jedoch eine Drosselungslogik, die die Cache-Bereinigung verlangsamt, wenn Sie einen Space programmatisch veröffentlichen (z. B. alle paar Sekunden).

Wenn Sie auf neue Daten in einem Webhook-Ziel angewiesen sind, das die Veröffentlichung auslöst, ist es in der Regel am besten, ein kleines Polling-Skript zu implementieren, um sicherzustellen, dass die Daten, die Sie vom CDN erhalten, aktuell sind.

Im Folgenden finden Sie einen Ausschnitt zur Implementierung eines Polling-Skripts:

Die Webhooks werden verwendet, um Sie zu benachrichtigen, wenn Content geändert wurde. Geben Sie eine URL an, konfigurieren Sie Ihren Webhook, und wir senden eine HTTP-POST-Anfrage, wenn etwas mit Ihrem Content passiert.

Ja, Webhooks haben eine Filtereigenschaft, die verwendet werden kann, um Webhooks basierend auf den Eigenschaften der Entität zu filtern, die den Webhook ausgelöst hat. Es ist möglich, nach folgenden Kriterien zu filtern:

• Entitäts-ID, z. B. sys.id

• Umgebungs-ID, z. B. sys.environment.sys.id

• Contenttyp-ID, z. B. sys.contentType.sys.id (nur für Einträge)

Weitere Informationen finden Sie unter: Webhook-Filter.

Beim Erstellen Ihres Webhooks werden Sie aufgefordert, auszuwählen, welche Art von Ereignissen ihn auslösen sollen. Ereignisse werden durch die Art der Entität (Contenttyp, Eintrag und Asset) und die zugrunde liegende Aktion (Erstellen, Speichern, Autosave usw.) getrennt. Sie können beispielsweise einen Webhook erstellen, der ausgelöst wird, wenn die Veröffentlichung eines Eintrags aufgehoben wird.

Für eine noch feinere Kontrolle werfen Sie einen Blick auf Webhook-Filter.

Beim Erstellen eines neuen Webhooks lehnt das URL-Feld Folgendes ab:

• Private IPs (10.x, 192.x usw.)

• Localhost

• Hostnamen ohne Top-Level-Domain

• URLs, die auf localhost oder Weiterleitungen verweisen

Gehen Sie in der Navigationsleiste oben zu Einstellungen → Webhooks. Klicken Sie dort auf Webhook hinzufügen, um zu Ihrem neuen Webhook weitergeleitet zu werden.

Wählen Sie dann einen Namen, geben Sie die Informationen Ihres HTTP-Endpunkts (URL und Authentifizierung) ein, geben Sie benutzerdefinierte Header an und wählen Sie die Arten von Ereignissen aus, die den Webhook auslösen sollen. Sie können auch Filter für eine feinere Steuerung festlegen.