Événements
Abonnez-vous uniquement aux événements utiles à votre intégration. La liste exacte figure dans la documentation.
Développeurs · Webhooks
Webhooks : soyez notifié, traitez une seule fois.
Quand une analyse, un article ou un export change d’état, Aive peut notifier votre système. Un récepteur fiable vérifie chaque notification, la traite une seule fois et garde une trace de ce qu’il a fait.
Types d’événements, en-têtes et méthode de signature : la documentation publique fait foi.
Dernière vérification · 26 septembre 2026
À quoi servent les webhooks Aive ?
Les webhooks évitent d’interroger l’API en boucle. Aive envoie une notification HTTP à l’adresse que vous déclarez quand un traitement change d’état, par exemple une analyse terminée ou un article prêt à valider. Votre système vérifie l’authenticité du message, le déduplique, puis déclenche l’étape suivante. Les types d’événements et le format exact sont décrits dans la documentation publique.
- Événement
- Changement d’état notifié par Aive, identifié par un type et un identifiant unique.
- Idempotence
- Propriété d’un traitement qui produit le même résultat s’il reçoit deux fois le même événement.
- Reprise
- Nouvelle tentative d’envoi lorsqu’une notification n’a pas été acceptée par votre système.
Principes
Quatre règles pour un récepteur fiable.
Signature et secrets
Vérifiez l’authenticité de chaque notification selon la méthode documentée. Conservez le secret côté serveur et prévoyez sa rotation.
Idempotence
Enregistrez l’identifiant de chaque événement traité. Un doublon est accusé, pas retraité.
Reprise
Une notification peut arriver plus d’une fois ou en retard. Votre traitement doit le tolérer.
Réception
De la notification à l’action.
- 01Recevoir sur une adresse HTTPS dédiéeDéclarez une adresse réservée aux webhooks Aive, distincte de vos autres points d’entrée.
- 02Vérifier l’authenticitéRejetez tout message dont la signature ne correspond pas au secret partagé, selon la méthode décrite dans la documentation.
- 03Accuser réception rapidementRépondez dès la vérification faite, puis traitez en asynchrone pour ne pas bloquer l’envoi.
- 04DédupliquerSi l’identifiant d’événement a déjà été traité, arrêtez-vous là.
- 05Traiter et journaliserDéclenchez l’étape suivante, puis consignez l’événement, le résultat et l’horodatage.
Politique de reprise
Le nombre de tentatives et leur espacement sont ceux décrits dans la documentation publique ou définis au contrat. Ne les supposez pas : lisez la référence.
- Documentation publique
- Contrat Enterprise
Avant la mise en production
Votre récepteur est-il prêt ?
Sécurité
- Adresse HTTPS dédiée
- Vérification de signature systématique
- Secret stocké côté serveur
- Rotation du secret planifiée
Robustesse
- Accusé de réception rapide
- Traitement asynchrone
- Déduplication par identifiant d’événement
- Tolérance aux doublons et aux retards
Traçabilité
- Journal des événements reçus
- Résultat de chaque traitement
- Alerte en cas d’échecs répétés
- Contact support Aive identifié
Ce que cette page ne décrit pas.
- Les noms d’événements, en-têtes, formats de charge utile et algorithme de signature : ils figurent uniquement dans la documentation publique.
- Le nombre et l’espacement des reprises : documentés sur api.aive.tech ou définis au contrat.
- L’ordre d’arrivée des notifications n’est pas supposé garanti : concevez un traitement qui ne dépend pas de l’ordre.
- Un webhook signale un changement d’état ; il ne vaut pas validation éditoriale ni publication.
Pages liées
API vidéo GEO Quickstart conceptuel, scopes, limites et journal. Référence exacte sur api.aive.tech. API vidéo GEO Exemples d’intégration CMS headless, pipeline de publication et export analytics, décrits pas à pas. Code exact sur api.aive.tech. Exemples d’intégration Statut et incidents Processus d’incident, support Aive et engagements de service définis au contrat. Statut et incidents Architecture Enterprise Sources, workspaces isolés, rôles, clés, scopes, webhooks et journaux, jusqu’aux destinations activées. Architecture Enterprise Automatisation Un agent qui prépare et exécute, des workflows réutilisables, SSO et API pour les équipes enterprise. Automatisation Sécurité et confiance SOC 2 Type II, RGPD, démarche ISO 27001 en cours, DPA et contrôles : le centre de confiance Aive GEO. Sécurité et confiance
Questions fréquentes
Questions sur les webhooks.
Quels événements puis-je recevoir ?
La liste exacte des types d’événements et leur format sont décrits dans la documentation publique sur api.aive.tech. Abonnez-vous uniquement à ceux dont votre intégration a besoin.
Que faire si je reçois deux fois le même événement ?
C’est un cas normal à prévoir. Enregistrez l’identifiant de chaque événement traité ; si un doublon arrive, accusez réception sans relancer le traitement.
Que se passe-t-il si mon système est indisponible ?
Les notifications non acceptées peuvent faire l’objet de nouvelles tentatives, selon la politique décrite dans la documentation ou au contrat. Surveillez votre journal pour repérer les échecs répétés.