Module

Blog Admin

Verwalte den Rankion-Blog: Artikel-Liste, Kategorien, Slugs, Veröffentlichung — für Plattform-Owner.

Blog Admin ist die interne CMS-Schicht für den öffentlichen Rankion-Blog auf rankion.ai/blog. Hier verwalten Plattform-Owner Kategorien und Posts: anlegen, editieren, veröffentlichen, depublishen, löschen. Anders als der AI Content Editor erstellt dieses Modul keine Artikel mit KI — es ist die klassische Admin-Oberfläche für redaktionell betreute Inhalte des Rankion-Eigenblogs (Marketing, Updates, Tutorials). Das Modul ist für Admin-User vorbehalten und team-gescoped auf das Plattform-Owner-Team.

Was es kann

Kategorien-CRUD — Kategorien anlegen, umbenennen, slug ändern, löschen. Slug = SEO-relevante URL-Komponente.
Posts-CRUD — Artikel anlegen, Titel/Slug/Body/Featured-Image setzen, Kategorie zuordnen, Status (draft, published) toggeln.
Slug-Validierung — Slugs sind unique je Kategorie. Doppelte Slugs werden abgelehnt.
Publishing — Post von draft auf published setzen veröffentlicht ihn sofort auf rankion.ai/blog/<category>/<slug>.
Markdown-Body — Posts werden als Markdown gespeichert; Frontend rendert mit syntax-highlighting und Wiki-ähnlicher Typografie.
Listen-Filter — Posts-Liste filterbar nach Status, Kategorie, Suchbegriff im Titel.

Wann nutzen

Du bist Plattform-Owner und willst einen neuen Marketing-Artikel auf rankion.ai/blog veröffentlichen.
Du willst eine bestehende Kategorie umbenennen oder ein neues Topic-Cluster anlegen.
Du willst einen Post depublishen (z.B. weil veraltet oder rechtlich problematisch) ohne ihn endgültig zu löschen.
Du willst die Slug-Struktur SEO-optimieren ohne URL-Redirects manuell zu pflegen.

Hinweis: Für regulär team-eigene Artikel (z.B. Customer-Blogs, Affiliate-Sites) nutze den AI Content Editor — der publisht via WordPress / CMS-Integration und ist nicht auf den Rankion-Eigenblog beschränkt.

Workflow

Kategorien anlegen — POST /blog/categories mit {name, slug}. Slug wird zu /blog/<slug>/....
Post anlegen — POST /blog/posts mit {title, slug, body_md, category_id, status: "draft"}. Body ist Markdown.
Editieren — PUT /blog/posts/{id} für inhaltliche Updates. Slug-Änderung bricht alte Permalinks — vorher prüfen ob Backlinks existieren.
Publishen — PUT /blog/posts/{id} mit {status: "published"}. Sofort live.
Listen — GET /blog/posts?status=published&category_id=3 filtert.

API

Methode	Endpoint	Beschreibung
`GET`	`/v1/blog/categories`	Liste aller Kategorien
`POST`	`/v1/blog/categories`	Neue Kategorie
`PUT`	`/v1/blog/categories/{id}`	Update
`DELETE`	`/v1/blog/categories/{id}`	Löschen (nur wenn keine Posts)
`GET`	`/v1/blog/posts`	Liste mit Filter `?status=&category_id=&search=`
`POST`	`/v1/blog/posts`	Neuen Post anlegen
`GET`	`/v1/blog/posts/{id}`	Detail
`PUT`	`/v1/blog/posts/{id}`	Update inkl. Status-Toggle
`DELETE`	`/v1/blog/posts/{id}`	Löschen (Soft-Delete falls aktiviert)

Beispiel — Post anlegen.

curl -X POST $BASE/blog/posts \
  -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  -d '{
    "title": "Neue AI-Visibility-Features in Rankion",
    "slug": "ai-visibility-update-mai-2026",
    "category_id": 2,
    "body_md": "## Was ist neu\n\n- Reality-Check ...\n",
    "status": "draft"
  }'

Credits & Limits

Kostenfrei — keine Credits. CMS-Operationen kosten nichts.
Admin-only — nur User mit Plattform-Admin-Rolle dürfen schreiben. Reads sind ebenfalls Admin-restricted (Frontend rankion.ai/blog rendert published Posts public, aber via Server-Side-Rendering, nicht via diese API).
Slug-Unique — innerhalb einer Kategorie. 422 bei Konflikt.
Soft-Delete — Löschungen sind reversibel falls die Migration deleted_at führt; im Zweifel Status auf draft setzen statt löschen.

Blog Admin

Was es kann

Wann nutzen

Workflow

API

Credits & Limits

Verwandte Module