Modernes Web (Content-API und Webhook)
Auf jeder Nicht-WordPress-Website veröffentlichen: Artikel per API-Schlüssel abholen (PULL) oder per Webhook empfangen (PUSH).
„Moderne Web-Integration“ ist für jede Website, die nicht mit WordPress läuft: eigene Website, Headless-CMS, statische Website. Es gibt zwei Wege, frei wählbar. Bei PULL holt Ihre Website die Artikel mit einem API-Schlüssel bei Rankfender ab. Bei PUSH schickt Rankfender jeden Artikel beim Veröffentlichen an Ihren Webhook. Jeder Tarif enthält sie.
Öffnen Sie sie mit „Verbinden“ (oder „Configure“) auf der Karte unter Einstellungen › Integrationen. Der Dialog hat zwei Reiter, „PULL (API)“ und „PUSH (Webhook)“, und ist englisch.
PULL: Ihre Website holt Artikel ab
Auf „Generate API Key“ klicken
Der Schlüssel erscheint mit der Schaltfläche „Copy“. Der Dialog erinnert daran, ihn geheim zu halten und im Produktivbetrieb Umgebungsvariablen und serverseitiges Rendern zu nutzen.
Auf „Test Connection“ klicken
„Connection successful! API key is valid and working.“ bestätigt den Schlüssel.
Ein Beispiel kopieren
Nutzen Sie den direkten API-Aufruf (curl) auf der Karte: Er funktioniert wie angegeben und sendet den Schlüssel im Header X-Rankfender-Key. Die Next.js-, React- und iframe-Beispiele der Karte setzen ein SDK-Paket und ein Einbettungsskript voraus, die nicht veröffentlicht sind – rufen Sie die API stattdessen direkt aus Ihrem Framework auf.
Parameter und Antworten: Content-API-Referenz und Authentifizierung.
PUSH: Rankfender schickt jeden Artikel
| Feld | Was eintragen |
|---|---|
| Webhook URL | Die Adresse, an die Rankfender Artikel per POST schickt, etwa https://your-website.com/api/rankfender/publish. |
| „Authentication Method“ | None, API Key (Header X-API-Key), Bearer Token, Basic Auth oder Webhook Secret (Header X-Webhook-Secret). |
| Die Zugangsdaten | Schlüssel, Token oder Secret dieser Methode. Bei der Eingabe verborgen. |
| „Custom Headers (Optional)“ | Zusätzliche HTTP-Header als JSON, etwa {"X-Custom-Header": "value"}. |
| „Enable Webhook“ | Ist es aktiv, wird jeder veröffentlichte Artikel an Ihren Webhook geschickt. |
Klicken Sie auf „Save Configuration“, dann auf „Test Webhook“: Rankfender schickt einen Testartikel „Rankfender Webhook Test“ mit dem Header X-Rankfender-Test: true. Jede 2xx-Antwort besteht den Test. Nach echten Zustellungen zeigt „Last successful call:“ das Datum.
Was Ihre Adresse empfängt
- Einen POST mit JSON-Body und den Headern X-Rankfender-Event: article.published und X-Rankfender-Domain.
- Den Artikel: title, slug, content (HTML), excerpt, meta_description, meta_title, keywords, featured_image, author, published_at sowie seo_data und custom_data.
- Ihre Adresse muss mit 200 bis 299 antworten. Sie kann {"url": "..."} mit der Adresse der veröffentlichten Seite zurückgeben.
- Rankfender speichert nichts auf Ihrer Seite: Legen Sie die Daten in Ihrer eigenen Datenbank oder Ihrem CMS ab.
Alle Felder und Header: Webhooks.
Hinweis
Welche Artikel wann veröffentlicht werden, legen Sie unter Inhalt fest: Veröffentlichung und Autopilot.