Modern Web (content-API en webhook)
Publiceer op elke site die niet op WordPress draait: haal artikelen op met een API-sleutel (PULL) of ontvang ze op je webhook (PUSH).
„Modern Web Integration” is voor elke site die niet op WordPress draait: een maatwerksite, een headless CMS, een statische site. Er zijn twee manieren, naar keuze. Met PULL haalt je site de artikelen bij Rankfender op met een API-sleutel. Met PUSH stuurt Rankfender elk artikel naar je webhook zodra je het publiceert. Elk abonnement heeft het.
Open het met „Connect” (of „Configure”) op de kaart in Settings › Integraties. Het venster heeft twee tabbladen, „PULL (API)” en „PUSH (Webhook)”, en is in het Engels.
PULL: je site haalt artikelen op
Klik op „Generate API Key”
De sleutel verschijnt met een knop „Copy”. Het venster herinnert je eraan hem geheim te houden en in productie omgevingsvariabelen en server-side rendering te gebruiken.
Klik op „Test Connection”
„Connection successful! API key is valid and working.” bevestigt de sleutel.
Kopieer een voorbeeld
Gebruik de directe API-aanroep (curl) op de kaart: die werkt zoals hij er staat en stuurt de sleutel in de header X-Rankfender-Key. De Next.js-, React- en iframe-voorbeelden op de kaart gebruiken een SDK-pakket en een insluitscript die niet gepubliceerd zijn; roep de API daarom rechtstreeks aan vanuit je framework.
Parameters en antwoorden: Content API-referentie en Authenticatie.
PUSH: Rankfender stuurt elk artikel
| Veld | Wat invullen |
|---|---|
| Webhook URL | Het adres waar Rankfender artikelen per POST naartoe stuurt, zoals https://your-website.com/api/rankfender/publish. |
| „Authentication Method” | None, API Key (header X-API-Key), Bearer Token, Basic Auth of Webhook Secret (header X-Webhook-Secret). |
| De inloggegevens | De sleutel, het token of het geheim van die methode. Verborgen tijdens het typen. |
| „Custom Headers (Optional)” | Extra HTTP-headers als JSON, zoals {"X-Custom-Header": "value"}. |
| „Enable Webhook” | Staat het aan, dan gaat elk gepubliceerd artikel naar je webhook. |
Klik op „Save Configuration” en daarna op „Test Webhook”: Rankfender stuurt een testartikel „Rankfender Webhook Test” met de header X-Rankfender-Test: true. Elk 2xx-antwoord slaagt. Na echte leveringen toont „Last successful call:” de datum.
Wat je adres ontvangt
- Een POST met een JSON-body en de headers X-Rankfender-Event: article.published en X-Rankfender-Domain.
- Het artikel: title, slug, content (HTML), excerpt, meta_description, meta_title, keywords, featured_image, author, published_at, plus seo_data en custom_data.
- Je adres moet antwoorden met 200 tot 299. Het kan {"url": "..."} terugsturen met het adres van de gepubliceerde pagina.
- Rankfender bewaart niets aan jouw kant: sla de gegevens op in je eigen database of CMS.
Alle velden en headers: Webhooks.
Let op
Welke artikelen wanneer gepubliceerd worden, stel je in bij Content: Publiceren en autopilot.