Webhooks

Le système de webhook est hébergé dans les régions AWS us-east-1 et eu-west-1.

Les plages d’adresses IP pour AWS sont fournies dans le lien suivant :

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

Pour les clients Premium ayant des organisations mondiales, nous garantissons l’envoi de webhooks exclusivement à partir de la liste d’adresses IP suivante :

Pour les clients Premium avec résidence des données dans l’UE, nous garantissons l’envoi de webhooks exclusivement à partir de la liste d’adresses IP suivante :

En cas de modification de la liste des adresses IP, celles-ci seront communiquées de manière large et proactive à l’avance par tous les canaux disponibles à tous les utilisateurs enregistrés actifs.

Delivery API est alimentée par un réseau CDN composé de centaines de serveurs répartis sur tous les continents. La couche CDN est purgée lorsque vous publiez une entrée dans un espace. La purge est instantanée et le nouveau contenu se propage en quelques secondes. Cependant, il existe une logique de limitation qui ralentit la purge du cache si vous publiez un espace par programme (par exemple, toutes les quelques secondes).

Si vous dépendez de nouvelles données dans une cible de webhook qui déclenche la publication, il est généralement préférable d’implémenter un petit script d’interrogation pour vous assurer que les données que vous obtenez du CDN sont à jour.

Voici un extrait pour implémenter un script d’interrogation :

Les webhooks sont utilisés pour vous avertir lorsque le contenu a été modifié. Renseignez une URL, configurez votre webhook : une requête HTTP POST sera alors envoyée automatiquement à chaque changement de votre contenu.

Oui, les webhooks ont une propriété de filtre qui peut être utilisée pour filtrer les webhooks en fonction des propriétés de l’entité qui a déclenché le webhook. Il est possible de filtrer en fonction de :

• l’identifiant de l’entité, par exemple sys.id

• l’identifiant de l’environnement, par exemple sys.environment.sys.id

• l’identifiant du type de contenu, par exemple sys.contentType.sys.id (pour les entrées uniquement)

Pour plus d’informations, consultez : Filtres de webhooks.

Lors de la création de votre webhook, il vous sera demandé de choisir le type d’événements qui doivent le déclencher. Les événements sont séparés par le type d’entité (type de contenu, entrée et ressource média) et l’action sous-jacente (créer, enregistrer, enregistrer automatiquement, etc.). Par exemple, vous pouvez créer un webhook qui sera déclenché chaque fois qu’une entrée est non publiée.

Pour un contrôle encore plus précis, consultez les filtres de webhooks.

Lors de la création d’un nouveau webhook, le champ URL rejettera :

• Les adresses IP privées (10.x, 192.x, etc.)

• Localhost

• Les noms d’hôte sans domaine de premier niveau

• Les URL qui se résolvent en localhost ou redirections

Accédez à Paramètres → Webhooks dans la barre de navigation en haut. À partir de là, cliquez sur Ajouter un webhook, et vous accéderez à votre nouveau webhook.

Ensuite, choisissez un nom, entrez les informations de votre point de terminaison HTTP (URL et authentification), spécifiez les en-têtes personnalisés et sélectionnez les types d’événements qui doivent déclencher le webhook. Vous pouvez également spécifier des filtres pour un contrôle plus précis.