Qu’est-ce qu’un webhook ?
Un webhook vous permet d’être notifié lorsque certaines actions système se produisent via un appel à une URL que vous fournissez. Les webhooks sont également connus sous le nom de « URL Callbacks » ou « HTTP push calls ». Votre URL doit utiliser SSL et commencer par HTTPS.Actions des webhooks
Voir les actions disponibles pour les webhooks.
Comprendre les webhooks Ayrshare
Les webhooks sont catégorisés par l’action spécifique et sont enregistrés au niveau du profil principal ou du profil d’utilisateur. Toute mise à jour pour les profils principaux ou d’utilisateur est envoyée en premier au webhook enregistré pour le profil d’utilisateur. Si le profil d’utilisateur n’a pas de webhook enregistré, la mise à jour sera envoyée au webhook enregistré du profil principal. Par exemple :- Si un profil d’utilisateur a un webhook Social Action enregistré et délie TikTok, l’URL du webhook Social Action enregistré pour le profil d’utilisateur sera appelée. Le webhook du profil principal ne sera pas appelé.
- Si un profil d’utilisateur délie TikTok et n’a pas de webhook Social Action enregistré, mais que le profil principal a bien un webhook enregistré, l’URL du webhook Social Action enregistré pour le profil principal sera appelée.
Enregistrer un webhook
Enregistrez un webhook en fournissant une URL de point de terminaison et le type d’action au point de terminaison POST/hook/webhook. Lorsque l’action se produit, un message HTTP POST sera envoyé à l’URL fournie.
Par exemple, enregistrez une URL pour être notifié du statut d’une publication programmée.
L’URL du point de terminaison du webhook ne doit pas utiliser de redirections et doit être l’URL de destination finale.
Si vous n’enregistrez que le webhook du profil principal, les profils d’utilisateur hériteront automatiquement du webhook du profil principal.
Pour avoir un webhook unique pour chaque profil d’utilisateur, vous devez enregistrer un webhook pour chaque profil d’utilisateur.
Après que votre webhook a reçu le
HTTP POST, votre serveur doit répondre avec
un statut HTTP 200 pour marquer l’appel comme réussi. Si votre serveur ne
répond pas dans les 10 secondes, une réponse 503 sera enregistrée.Nouvelles tentatives de webhook
Si la réponse HTTP de votre serveur n’est pas dans la plage de succès200-299, le système réessaiera automatiquement l’appel du webhook deux fois de plus. La première tentative aura lieu après 5 secondes et la seconde tentative aura lieu 30 secondes plus tard. Les nouvelles tentatives auront le même hookId et seront marquées comme des tentatives de nouvelle exécution.
Sécurité des webhooks
Vous pouvez choisir d’ajouter une sécurité supplémentaire en configurant l’authentification HMAC en tant que requête HTTP. Cela est souvent fait pour empêcher les attaques par rejeu. Ayrshare utilise HMAC-SHA256 pour hacher le corps du message et l’inclut ainsi que l’horodatage UNIX dans l’en-tête du POST.X-Authorization-Content-SHA256 avec le HMAC-SHA256 du corps du POST. Le secret de signature est à l’échelle du profil — un secret par User Profile, utilisé pour toutes les actions de webhook de ce profil, si bien que le définir pour une action le modifie pour toutes les actions de ce profil. Les comptes multi-profils gèrent un secret distinct par profil (ciblez un profil avec l’en-tête Profile-Key).
L’en-tête X-Authorization-Content-SHA256-V2 porte la même signature sous la forme d’une valeur préfixée par v1= (v1= désigne le schéma HMAC-SHA256). Lorsque vous effectuez la rotation de votre secret de signature, cet en-tête liste à la fois la signature actuelle et la signature précédente (v1=<current-sig>,v1=<previous-sig>) pendant une fenêtre de grâce de 24 heures, afin que vous puissiez faire tourner votre secret sans aucune livraison manquée ou rejetée. Un récepteur doit accepter une livraison si son HMAC calculé correspond à n’importe quelle signature v1= listée. Consultez Rotation du secret de signature pour la procédure complète et un exemple de vérification.