Kann deine Website Beiträge von famehub bekommen?

Statische Seiten ohne Backend gehen nicht von allein. Wird deine Seite aus einem Git-Repository gebaut, sprich uns an, dafür gibt es einen eigenen Weg.

Immer einen fertigen Beitrag, nie Rohmaterial. Du speicherst ihn, mehr ist nicht zu tun.

• Titel und Adresse, der Slug aus Kleinbuchstaben, Ziffern und Bindestrichen
• Anrisstext, ein bis zwei Sätze für Übersichtsseiten
• Fließtext als fertiges HTML, kein Markdown
• Titelbild als PNG, JPEG, WebP oder GIF, optional
• Rubrik und Zeitpunkt
• Status: öffentlich, oder zur Freigabe in deine Redaktion

Speichert dein System Markdown statt HTML, wandelst du beim Empfangen um. Wir schicken bewusst HTML, weil es in jedem Zielsystem gleich aussieht.

• HTTPS mit gültigem Zertifikat. Ohne Verschlüsselung geht nichts raus.
• Die kanonische Adresse. famehub folgt keinen Weiterleitungen. Wenn beispiel.de auf www.beispiel.de umleitet, trägst du www.beispiel.de ein. Das ist der häufigste Grund, warum eine Anbindung im ersten Anlauf scheitert.
• Ein eigener technischer Benutzer, nicht dein persönliches Konto. Er braucht genau zwei Rechte: Beiträge schreiben und Bilder hochladen.
• Ein freier Weg zur Schnittstelle. Liegt ein Proxy oder eine Firewall davor, müssen die Schnittstellen-Pfade durchgelassen werden.

Du brauchst nichts zu programmieren.

1. 1Lege einen Benutzer an, zum Beispiel famehub-bot, mit der Rolle Redakteur. Autor reicht nicht, sobald Bilder und Kategorien im Spiel sind.
2. 2Erzeuge für diesen Benutzer ein Anwendungspasswort. Das ist nicht sein Anmeldepasswort.
3. 3Gib uns drei Angaben: die kanonische Adresse deiner Seite, den Benutzernamen und das Anwendungspasswort.
4. 4Nenne uns die Rubrik für neue Beiträge. Wir lesen deine Kategorien aus, du wählst eine.

famehub legt Beiträge dann in WordPress an, lädt das Titelbild in deine Mediathek und setzt die Rubrik. Ein erneutes Freigeben aktualisiert denselben Beitrag, es entsteht kein zweiter.

Wenn WordPress den Zugang ablehnt

Fast immer liegt es an einem dieser vier Punkte, in dieser Reihenfolge geprüft:

• Ein Sicherheits-Plugin sperrt Anwendungspasswörter. Solid Security, früher iThemes Security, tut das je Benutzergruppe. Die Sperre lässt sich für genau diesen einen Benutzer aufheben, ohne sie für alle anderen zu öffnen. Wir sagen deinem Dienstleister, wie.
• Eine Weiterleitung entfernt die Anmeldung. Springt deine Seite von beispiel.de auf www.beispiel.de, geht der Anmelde-Header dabei verloren.
• Der Hoster reicht Anmelde-Header nicht weiter. Kommt bei manchen PHP-Konfigurationen vor und wird in der Serverkonfiguration freigeschaltet.
• Ein Test über die Kommandozeile beweist nichts. Ob Anwendungspasswörter verfügbar sind, zeigt nur ein echter Aufruf über HTTPS.

Läuft deine Seite bereits auf Payload CMS mit einer Sammlung articles und einer Sammlung media, bist du fertig, sobald du uns das hier gibst:

• die kanonische Adresse deiner Seite
• einen Benutzer mit Schreibrecht auf articles und media, samt Passwort
• den Namen der Rubrik für neue Beiträge
• die Entscheidung: sollen Beiträge sofort öffentlich sein oder erst in deine Redaktion zur Freigabe gehen

Weicht deine Sammlung von der Form unten ab, ergänzt du die fehlenden Felder oder gehst Weg 3.

Für jedes andere System baust du eine kleine Schnittstelle vor deinem CMS. Sie nimmt entgegen, was famehub schickt, und speichert es so, wie deine Seite es braucht. Was dahinter liegt, ist uns egal: Datenbank, Dateien, ein anderes CMS. Alle drei Endpunkte liegen unter https://deine-domain.de/api/.

Endpunkt 1: Anmelden

POST /api/users/login
Content-Type: application/json

{ "email": "[email protected]", "password": "..." }

Antwort 200 mit { "token": "..." }, bei falschen Daten 401. Das Token wird bei jedem Vorgang frisch geholt, eine Gültigkeit von 15 Minuten reicht völlig. Alle weiteren Aufrufe tragen den Kopf Authorization: JWT <token>, wirklich JWT, nicht Bearer.

Endpunkt 2: Beiträge

GET    /api/articles?where[slug][equals]=<adresse>&limit=1&depth=0
POST   /api/articles
PATCH  /api/articles/<id>
DELETE /api/articles/<id>          # freiwillig

Die Suche ist der Duplikatschutz. Ohne sie entstünde bei jedem erneuten Freigeben ein neuer Beitrag. Antworte mit { "docs": [ { "id": 42 } ], "totalDocs": 1 }. Kein Treffer heißt: docs ist leer. Bitte kein 404.

Anlegen und Ändern bekommen genau diesen Rumpf:

{
  "title":       "Überschrift des Beitrags",
  "slug":        "ueberschrift-des-beitrags",
  "status":      "published",              // oder "review"
  "category":    "blog",
  "excerpt":     "Anrisstext, ein bis zwei Sätze.",
  "bodyHtml":    "<h2>...</h2><p>...</p>",
  "publishedAt": "2026-08-26T09:00:00.000Z",
  "source":      "blog-machine",           // festes Kennzeichen der Quelle
  "heroImage":   "<id aus Endpunkt 3>"     // nur wenn ein Bild dabei war
}

Antworte auf beide mit dem gespeicherten Ergebnis: { "doc": { "id": 42, "slug": "..." } }. Der zurückgegebene Slug wird ausgewertet. Wenn dein System die Adresse selbst vergibt oder festhält, melde die tatsächlich gespeicherte Adresse zurück. Sonst zeigen Verlinkungen ins Leere.

Endpunkt 3: Bilder

POST /api/media
Authorization: JWT <token>
Content-Type: multipart/form-data

file      = <Bilddatei>            (png, jpg, webp oder gif)
_payload  = {"alt":"Bildbeschreibung"}

Antworte mit { "doc": { "id": "abc123" } }. Diese Kennung schickt famehub im nächsten Schritt als heroImage mit. Klappt der Upload nicht, veröffentlicht famehub ohne Titelbild weiter. Ein fehlendes Bild darf den Beitrag nicht verhindern.

Die öffentliche Adresse

famehub bildet die Adresse eines Beitrags als https://deine-domain.de/rubrik/adresse/. Lieferst du deine Beiträge unter einem anderen Muster aus, sag uns Bescheid oder richte eine Weiterleitung ein. Diese Adresse steht später in den Social-Media-Beiträgen, die auf den Artikel verweisen.

Damit ihr eure Seite darauf auslegen könnt.

Laufen diese sieben Punkte durch, ist die Anbindung fertig.

1. 1Die Anmeldung mit dem famehub-Benutzer liefert ein Token.
2. 2Die Beitragssuche antwortet, auch wenn nichts gefunden wird.
3. 3Ein neuer Beitrag wird angelegt und ist unter seiner Adresse erreichbar.
4. 4Dieselbe Übergabe ein zweites Mal aktualisiert den Beitrag, sie legt keinen zweiten an.
5. 5Eine geänderte Adresse zieht den Beitrag um, unter der alten ist er nicht mehr zu sehen.
6. 6status: „review" nimmt den Beitrag von der öffentlichen Seite.
7. 7Ein Bild-Upload liefert eine Kennung, und der Beitrag zeigt das Bild.

Danach schicken wir einen echten Beitrag, ihr schaut ihn euch auf der Seite an, und ab dann läuft es von allein.

Neben deinem Blog kann famehub auch Instagram, deine Facebook-Seite und LinkedIn bespielen, dein Privatprofil ebenso wie eine Unternehmensseite. Dafür musst du nichts bauen, die Verbindung entsteht über eine Anmeldung bei der jeweiligen Plattform. Was du brauchst:

• Instagram: ein Business- oder Creator-Konto, kein privates.
• Facebook: eine Seite, für die du Administrator bist.
• LinkedIn: dein Profil, oder eine Unternehmensseite, für die du als Administrator freigegeben bist.

Instagram und Facebook schalten wir gemeinsam mit dir frei. Melde dich, wenn es so weit ist, das dauert wenige Minuten.