Publier vos articles sur votre site avec un webhook signé

1. 1

   Exposez une route sur votre site

   Par exemple /api/seo-advisor/ingest, qui accepte les requêtes POST et partage un secret avec SEO Advisor.

2. 2

   Connectez le site

   Dans les réglages du site, renseignez l'URL de la route et le secret, puis envoyez un ping de test pour vérifier la connexion.

3. 3

   Publiez

   Depuis un article relu, déclenchez la publication : le site distant reçoit l'article, l'enregistre et répond avec son identifiant et son URL.

La requête transporte un document JSON dont les champs principaux sont :

• event : article.publish ou ping (test de connexion) ;
• externalId : l'identifiant stable de l'article côté SEO Advisor ;
• title, slug, pathPrefix et canonicalPath ;
• bodyMd (l'article en markdown) et bodyHtml lorsqu'il est disponible ;
• keywords, metaTitle, metaDescription, publishedAt et published.

Votre site répond avec un statut 200 et un document de la forme { ok: true, id, url } : l'id et l'URL sont conservés pour les mises à jour ultérieures.

• L'en-tête Authorization: Bearer <secret> identifie l'appelant.
• L'en-tête X-SEO-Advisor-Signature: sha256=<hmac> contient le HMAC SHA-256 du corps brut de la requête, calculé avec le secret partagé.
• Votre route doit lire le corps brut, recalculer la signature et la comparer en temps constant. Tout écart doit renvoyer une erreur 401.

Côté SEO Advisor, les adresses internes ou privées sont refusées comme cibles de publication, et les redirections ne sont pas suivies, afin que la fonction ne puisse pas servir à atteindre un réseau interne.

Utilisez externalId comme clé d'insertion ou de mise à jour (upsert) dans votre base : republier un article modifié met à jour l'entrée existante.