API/Webhook + AymarTech

Envoyez des articles générés par IA à votre endpoint automatiquement ou après validation via des webhooks signés.

API/Webhook est destiné aux sites personnalisés et aux stacks CMS non pris en charge. Votre site peut récupérer les articles approuvés ou auto-publiés d’AymarTech avec une clé API et recevoir des notifications webhook lorsque l’état de l’article change.

Problèmes

Pourquoi la publication SEO reste bloquée

La plupart des équipes ne manquent pas d'idées. Elles bloquent parce que chaque article demande trop de petites décisions manuelles avant d'être publié.

Le choix des sujets devient approximatif

La demande de mots-clés, l'intention de recherche et l'intérêt business sont dispersés entre plusieurs onglets, donc le prochain article se choisit à l'opinion plutôt qu'à la preuve.

Chaque article devient une checklist opérationnelle

Briefs, brouillons, images, métadonnées, liens internes et QA passent d'un outil à l'autre jusqu'à rendre le processus lent et irrégulier.

La publication bloque sur la dernière étape

Les brouillons finalisés attendent les slugs, la mise en forme, les champs de plateforme et quelqu'un qui ait le temps de tout publier.

Ce que vous obtenez

De la vraie demande de recherche à des articles prêts à être indexés

Des mots-clés que les gens recherchent déjà

AymarTech trouve des requêtes avec une vraie demande, une intention claire et une chance réaliste d'attirer du trafic qualifié.

Recherche approfondie sur de nombreuses sources

Chaque article s'appuie sur une recherche large de sources afin de couvrir le sujet avec substance, pas avec du contenu générique.

Publication pensée pour Google

Structure propre, métadonnées, slugs, liens internes et publication directe aident Google à découvrir et indexer plus vite les nouveaux articles.

Workflow de contenu

Du mot-clé à l'article SEO finalisé

01

Trouver la demande

AymarTech identifie les sujets à faible concurrence que vos clients recherchent déjà.

02

Rédiger et optimiser

L'article est rédigé, vérifié, formaté, enrichi d'images et préparé avec les détails SEO.

03

Livrer le payload

AymarTech prépare l’article pour la Publishing API et les événements webhook, puis livre automatiquement ou attend validation.

Pour qui

Utilisez-la lorsque vous contrôlez le code, voulez un rendu personnalisé, ou avez besoin qu’AymarTech notifie votre backend avec livraison automatique ou confirmation avant d’exposer les données d’article.

Ce qui est envoyé

Charge utile AymarTech expose les articles publiés via la Publishing API et peut envoyer des webhooks article_published, article_updated et article_unpublished. Les payloads webhook incluent event, article id, slug, headline, état de publication et updatedAt ; les réponses d’article de l’API incluent le contenu et les métadonnées pour le rendu.

Configuration

Tous les formulaires de connexion, boutons OAuth, sélecteurs de destination, réglages du mode de publication et tests se trouvent dans le tableau de bord AymarTech. Choisissez publication automatique ou validation avant mise en ligne.

Ouvrir les intégrations du tableau de bord →
  1. Ouvrez le projet dans AymarTech et allez aux réglages publishing/API du tableau de bord.
  2. Générez une clé API pour le projet.
  3. Définissez BLOG_WRITER_BASE_URL sur l’URL de base de la publish API du projet et BLOG_WRITER_API_KEY sur la clé générée dans l’environnement de votre site.
  4. Utilisez GET /articles pour les listes, GET /articles?slug=... pour les pages d’article, et GET /sitemap pour un sitemap dynamique.
  5. Choisissez la livraison automatique ou la confirmation avant d’exposer les données d’article, et ajoutez éventuellement une URL webhook et un secret pour la revalidation du cache ou des workflows aval.
  6. Envoyez un webhook de test depuis le tableau de bord et confirmez que votre endpoint répond 2xx.

Fonctionnement de la publication ou de la livraison d'articles

  • La Publishing API ne renvoie que les données d’articles approuvés ou auto-publiés pour le projet associé à la clé API.
  • Les webhooks sont envoyés après validation ou auto-publish sur les événements article_published, article_updated et article_unpublished.
  • Si un secret webhook est configuré, AymarTech envoie les en-têtes X-Webhook-Signature et X-Webhook-Secret.
  • Les signatures webhook sont HMAC-SHA256 sur le corps JSON du payload.
  • Votre site reste responsable du rendu HTML, des métadonnées SEO, des URL canoniques, de hreflang et de l’invalidation du cache.

Dépannage

  • 401 depuis la Publishing API : confirmez que la clé API est présente dans X-API-Key ou Authorization: Bearer.
  • Aucun article renvoyé : confirmez que les articles sont approuvés ou auto-publiés dans AymarTech et que l’ID projet/URL de base est correct.
  • Signature webhook incorrecte : vérifiez que votre serveur calcule le HMAC sur le corps JSON brut exact avec le secret enregistré.
  • Timeout webhook : accusez réception rapidement avec 2xx et déplacez le traitement lourd vers une file.
  • Sitemap obsolète : générez-le dynamiquement ou revalidez-le à l’arrivée des webhooks article_published.

Questions fréquentes

La livraison API/Webhook peut-elle être automatique ?

Oui. Vous choisissez le mode : livrer ou exposer les données d’article automatiquement lorsqu’elles sont prêtes, ou exiger d’abord une confirmation. Votre site ou backend décide toujours comment rendre ou stocker le contenu.

De quels endpoints ai-je besoin ?

La plupart des sites utilisent /articles pour les listes, /articles?slug=... pour les pages de détail, et /sitemap pour la découverte SEO.

Les webhooks sont-ils obligatoires ?

Non. Ils sont optionnels, mais utiles pour la revalidation du cache et les workflows aval.

Comment vérifier les webhooks ?

Utilisez X-Webhook-Signature avec votre secret partagé. X-Webhook-Secret est aussi envoyé lorsqu’il est configuré, pour une validation plus simple.

Où sont les valeurs API exactes ?

Le tableau de bord affiche la clé API du projet, l’URL de base de la publish API, le champ URL webhook, le champ secret et les actions de test.

Liens liés

Contrôlez la livraison d’articles SEO

Commencez gratuitement, connectez votre endpoint et choisissez livraison automatique ou validation avant que les articles optimisés arrivent dans votre backend.