Web moderne (API de contenu et webhook)
Publier sur tout site hors WordPress : récupérer les articles avec une clé d'API (PULL) ou les recevoir sur votre webhook (PUSH).
« Intégration Web Moderne » sert à tout site qui n'est pas sous WordPress : site sur mesure, CMS headless, site statique. Deux modes, au choix. En PULL, votre site récupère les articles chez Rankfender avec une clé d'API. En PUSH, Rankfender envoie chaque article à votre webhook quand vous le publiez. Toutes les formules l'incluent.
Ouvrez-la avec « Connecter » (ou « Configure ») sur la carte dans Paramètres › Intégrations. La fenêtre a deux onglets, « PULL (API) » et « PUSH (Webhook) », et elle est en anglais.
PULL : votre site récupère les articles
Cliquez sur « Generate API Key »
La clé s'affiche avec un bouton « Copy ». La fenêtre rappelle de garder la clé secrète et, en production, d'utiliser des variables d'environnement et un rendu côté serveur.
Cliquez sur « Test Connection »
« Connection successful! API key is valid and working. » confirme la clé.
Copiez un exemple
Utilisez l'appel d'API direct (curl) affiché sur la carte : il fonctionne tel quel et envoie la clé dans l'en-tête X-Rankfender-Key. Les exemples Next.js, React et iframe de la carte s'appuient sur un paquet SDK et un script d'intégration qui ne sont pas publiés : appelez plutôt l'API directement depuis votre framework.
Paramètres et réponses : Référence de l'API de contenu et Authentification.
PUSH : Rankfender envoie chaque article
| Champ | Quoi saisir |
|---|---|
| Webhook URL | L'adresse où Rankfender envoie les articles en POST, comme https://your-website.com/api/rankfender/publish. |
| « Authentication Method » | None, API Key (en-tête X-API-Key), Bearer Token, Basic Auth ou Webhook Secret (en-tête X-Webhook-Secret). |
| L'identifiant | La clé, le jeton ou le secret de cette méthode. Masqué pendant la saisie. |
| « Custom Headers (Optional) » | Des en-têtes HTTP supplémentaires en JSON, comme {"X-Custom-Header": "value"}. |
| « Enable Webhook » | Une fois activé, chaque article publié est envoyé à votre webhook. |
Cliquez sur « Save Configuration », puis « Test Webhook » : Rankfender envoie un article de test intitulé « Rankfender Webhook Test » avec l'en-tête X-Rankfender-Test: true. Toute réponse 2xx valide le test. Après de vrais envois, « Last successful call: » affiche la date.
Ce que reçoit votre adresse
- Un POST avec un corps JSON et les en-têtes X-Rankfender-Event: article.published et X-Rankfender-Domain.
- L'article : title, slug, content (HTML), excerpt, meta_description, meta_title, keywords, featured_image, author, published_at, ainsi que seo_data et custom_data.
- Votre adresse doit répondre entre 200 et 299. Elle peut renvoyer {"url": "..."} avec l'adresse de la page publiée.
- Rankfender ne stocke rien chez vous : enregistrez les données dans votre propre base ou CMS.
Liste complète des champs et en-têtes : Webhooks.
À savoir
Quels articles sont publiés, et quand, se règle dans Contenu : Publication et pilote automatique.