Au sujet des webhooks

Les Webhooks vous permettent d’envoyer une demande POST à une certaine URL chaque fois que l’alerte est déclenchée. Cette fonctionnalité peut être activée lorsque vous créez ou modifiez une alerte. Ajoutez l'URL correcte pour votre application et nous enverrons une demande POST dès que l'alerte est déclenchée, avec le message d'alerte dans le corps de la demande. Si le message d'alerte est un JSON valide, nous enverrons une demande avec un en-tête de type de contenu "application / json". Sinon, nous enverrons "text / plain" comme en-tête de type de contenu.

Avis de sécurité important: Lors de la configuration des webhooks, veillez à ne pas inclure d'informations sensibles telles que des identifiants de connexion ou des mots de passe dans le corps du webhook. La transmission de données sensibles par l'intermédiaire des webhooks peut les exposer à des parties non autorisées et entraîner des failles de sécurité. Utilisez toujours des points de terminaison sécurisés et authentifiés et cryptez les données sensibles pour protéger vos informations.

Voici une liste d'adresses IP que nous utiliserons pour envoyer des demandes POST, au cas où elles auraient besoin d'une autorisation:

52.89.214.238

34.212.75.30

54.218.53.128

52.32.178.7

Si vous souhaitez envoyer une demande à une URL avec un numéro de port, veuillez noter que nous acceptons uniquement les URL portant les numéros de port 80 et 443. Toute demande sur l'URL avec un autre numéro de port sera rejetée. Si un serveur distant traite une demande pendant plus de 3 secondes, la demande est annulée.

N'oubliez pas que de nombreuses applications et services s'attendent à recevoir des données de Webhook au format JSON (et non le texte brut que nous avons par défaut dans le message d'alerte). Avant d’envoyer une demande, veuillez lire la documentation de l’application ou du service correspondant et formater correctement votre message d’alerte. Vous pouvez en savoir plus sur le format JSON sur le wiki.

Par exemple, Slack attend un message au format JSON avec un «texte» comme clé. Vous pouvez taper dans une boîte de message:

{"text": "BTCUSD Greater Than 9000"}


Comme le message est un JSON valide, nous enverrons une demande avec un en-tête de type de contenu "application / json". Voici à quoi ressemblera la requête avec cURL:

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
TextText

Si votre message est en texte brut (par exemple, vous utilisez un message d’alerte par défaut), nous enverrons une demande avec un en-tête de type de contenu "plain / text".

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

Pour la protection de vos données, l'utilisation des webhooks d'alerte n'est autorisée que si l'authentification à deux facteurs est activée.