Blog Admin

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

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

API

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.

Verwandte Module

• AI Content Editor — KI-gestützte Artikel-Erstellung für team-eigene Sites; nicht für den Rankion-Eigenblog.
• Rankion OS — Storage & Files — Featured-Images und Asset-Library für Blog-Posts.