API Webhook + AymarTech

Envoyez chaque article généré par IA depuis AymarTech vers votre endpoint via des webhooks signés.

AymarTech publie les articles finalisés en brouillons structurés dans votre flux API Webhook, afin que votre équipe valide avant publication.

Pour qui

Cette intégration s’adresse aux équipes qui utilisent API Webhook et veulent publier du contenu SEO de manière fiable.

Ce qui est publié

Charge utile AymarTech envoie un payload JSON contenant article ID, title, slug, excerpt, HTML body, plain text body, cover image URL, locale, tags, publish intent et timestamps.

Configuration

  1. Créez l’intégration API Webhook dans AymarTech et ajoutez votre URL endpoint.
  2. Générez un secret de signature côté réception.
  3. Définissez le mapping des champs article vers votre système.
  4. Envoyez un payload test et vérifiez signature et code réponse.

Fonctionnement technique

  • Les requêtes sont envoyées en HTTPS avec signature HMAC.
  • Les erreurs temporaires sont retentées avec backoff exponentiel.
  • Le schéma de payload est versionné.
  • Les logs incluent le statut et le nombre de tentatives.

Dépannage

  • 401 ou signature invalide : vérifiez secret partagé et validation.
  • Timeout : rendez le traitement asynchrone.
  • Erreur 4xx : corrigez le mapping du récepteur.
  • Doublons : implémentez l’idempotence avec IDs article/révision.

Questions fréquentes

Le webhook inclut-il le HTML complet ?

Oui, avec le corps, les métadonnées et les URLs médias.

Comment vérifier l’authenticité ?

Validez la signature HMAC avec votre secret.

Puis-je séparer staging et production ?

Oui, via des intégrations webhook distinctes.

Quelle politique de retry ?

Backoff exponentiel plafonné pour erreurs temporaires.

Peut-on déclencher des flux non-CMS ?

Oui, API internes, files de messages, workflows, etc.

Liens liés