Über Webhooks

Webhooks ermöglichen es Ihnen, bei jedem Auslösen des Alarms eine POST-Anfrage an eine bestimmte URL zu senden. Diese Funktion kann aktiviert werden, wenn Sie einen Alarm erstellen oder bearbeiten. Fügen Sie die richtige URL für Ihre App hinzu und wir senden eine POST-Anfrage, sobald der Alarm ausgelöst wird, mit der Beschreibung des Alarms. Wenn die Beschreibung nach JSON gültig ist, senden wir eine Anfrage mit einer "application/json"-Überschrift. Andernfalls senden wir "text/plain" als inhaltlichen Header.

Wichtiger Sicherheitshinweis: Wenn Sie Webhooks konfigurieren, dann stellen Sie bitte sicher, dass diese keine vertraulichen Informationen beinhalten (z. B.: Anmeldedaten oder Passwörter). Die Übertragung von vertraulichen Daten innerhalb von Webhooks kann diese gegenüber unbefugten Personen offenlegen und zu Sicherheitsschwachstellen führen. Verwenden Sie immer gesicherte und verifizierte Endpunkte und verschlüsseln Sie vertrauliche Daten, um auf diese Weise Ihre Nutzerinformationen zu schützen.

Hier ist eine Liste von IP-Adressen, die wir nutzen um POST-Requests zu versenden. Es ist möglich dass diese in den Apps genehmigt werden müssen:

• 52.89.214.238
• 34.212.75.30
• 54.218.53.128
• 52.32.178.7

Wenn Sie einen Request an eine URL mit einer Port-Nummer schicken wollen, beachten Sie bitte, dass wir ausschließlich URLs mit den Port-Nummern 80 und 443 zulassen. Requests mit anderen Port-Nummern werden abgelehnt. Wenn ein Server einen Request für mehr als 3 Sekunden verarbeitet, wird der Request storniert. Nehmen Sie bitte des Weiteren zur Kenntnis, dass IPv6 zurzeit nicht mit Webhooks funktioniert. Wir können dies jedoch zu einem späteren Zeitpunkt einführen.

Beachten Sie, dass viele Apps und Services erwarten, Webhooks im JSON-Format zu erhalten (und nicht den normalen Text, den wir standardmäßig als Nachricht anbieten). Bevor Sie einen Request senden, lesen Sie bitte die Anleitung der korrespondierenden App / des Services und formatieren Sie Ihre Nachricht entsprechend. Sie können in der Wiki mehr über das JSON Format erfahren.

Als Beispiel; Slack erwartet eine Nachricht, formatiert in JSON mit einem "Text" als Key. Sie können folgendes in das Nachrichtenfeld eingeben:

Da dies eine valide JSON Nachricht ist, werden wir einen Request mit einer "application/json" als Inhalt versenden. Folgendermaßen wird die Nachricht unter Verwendung von cURL aussehen:

curl -H 'Content-Type: application/json; charset=utf-8' -d '{"text": "BTCUSD Greater Than 9000"}' -X POST https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX

Wenn Ihre Nachricht normalen Text enthält (z. B. wenn Sie eine normale Alarm-Nachricht benutzen), senden wir einen Request mit einem "plain/text" als Inhalt.

curl -H 'Content-Type: text/plain; charset=utf-8' -d 'BTCUSD Greater Than 9000' -X POST https://webhook.site/test

Zum Schutz Ihrer personenbezogenen Daten können Webhooks nur verwendet werden, wenn die 2-Faktor-Authentifizierung aktiviert ist.