Introduction aux webhooks Optacy

Bienvenue dans les intégrations webhook d’Optacy. La plupart des équipes utilisent les webhooks pour automatiser le traitement des demandes d’exercice de droits ou pousser des événements vers un système de ticketing interne. Si vous avez un autre cas d’usage, contactez-nous : nous serons ravis d’en discuter.

Les webhooks vous permettent de recevoir les données des demandes d’exercice de droits en temps réel via HTTPS. Les événements se déclenchent lorsque quelque chose se produit dans Optacy ; par exemple, privacy_request.received envoie les données disponibles au moment où une demande arrive.

Fonctionnement des événements

Chaque événement inclut le dernier état de l’objet, même lors d’une relance. Le seul contenu que nous n’envoyons qu’une fois est constitué des octets MP3 d’un enregistrement de messagerie vocale. Nous ne tenons pas de liste des modifications ; nous ordonnons les événements dans le système et envoyons toutes les données disponibles au moment de la livraison.

Vous pouvez utiliser sans risque l’horodatage de la signature pour ordonner les états d’un objet. Conservez cet horodatage pour vous prémunir contre les événements plus anciens. Si vous rejouez un événement ancien, nous récupérons le dernier état et l’horodatage de la signature correspond à « maintenant » : vous pouvez donc mettre à jour votre enregistrement en toute sécurité.

Remarques

• Nous ne prenons en charge que les URL de webhook en HTTPS.
• Une API complète est en cours de développement : contactez-nous si vous souhaitez un accès anticipé pour votre cas d’usage.
• Les requêtes HTTP sont en multipart en raison de la façon dont les contenus des demandes d’exercice de droits (y compris les enregistrements) sont livrés.

Poursuivez avec Sécurité logicielle pour vérifier que les événements proviennent bien d’Optacy.