Blog Admin

Blog Admin est la couche CMS interne pour le blog public Rankion sur rankion.ai/blog. Ici, les owners de plateforme gèrent catégories et posts : créer, éditer, publier, dépublier, supprimer. Contrairement à l'AI Content Editor, ce module ne crée pas d'articles avec l'IA — c'est l'interface admin classique pour les contenus rédactionnellement entretenus du blog propre Rankion (marketing, updates, tutoriels). Le module est réservé aux utilisateurs admin et team-scoped sur l'équipe owner de plateforme.

Ce qu'il peut faire

• CRUD catégories — créer des catégories, les renommer, changer le slug, supprimer. Slug = composant d'URL pertinent SEO.
• CRUD posts — créer des articles, définir titre/slug/body/featured-image, attribuer à une catégorie, toggle du statut (draft, published).
• Validation de slug — les slugs sont uniques par catégorie. Les slugs en doublon sont refusés.
• Publishing — passer un post de draft à published le publie immédiatement sur rankion.ai/blog/<category>/<slug>.
• Body Markdown — les posts sont stockés en Markdown ; le frontend rend avec syntax highlighting et typographie style wiki.
• Filtres de liste — liste de posts filtrable par statut, catégorie, terme de recherche dans le titre.

Quand l'utiliser

• Tu es owner de plateforme et tu veux publier un nouvel article marketing sur rankion.ai/blog.
• Tu veux renommer une catégorie existante ou créer un nouveau topic cluster.
• Tu veux dépublier un post (par ex. parce qu'obsolète ou problématique juridiquement) sans le supprimer définitivement.
• Tu veux optimiser la structure de slug pour le SEO sans entretenir manuellement les redirections d'URL.

Note : pour les articles d'équipe réguliers (par ex. blogs clients, sites d'affiliation), utilise l'AI Content Editor — il publie via WordPress / intégration CMS et n'est pas restreint au blog propre Rankion.

Workflow

1. Créer des catégories — POST /blog/categories avec {name, slug}. Le slug devient /blog/<slug>/....
2. Créer un post — POST /blog/posts avec {title, slug, body_md, category_id, status: "draft"}. Le body est Markdown.
3. Éditer — PUT /blog/posts/{id} pour les updates de contenu. Le changement de slug casse les permalinks anciens — vérifier d'abord s'il existe des backlinks.
4. Publier — PUT /blog/posts/{id} avec {status: "published"}. Live immédiatement.
5. Lister — GET /blog/posts?status=published&category_id=3 filtre.

API

Exemple — créer un post.

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"
  }'

Crédits et limites

• Gratuit — pas de crédits. Les opérations CMS ne coûtent rien.
• Admin only — seuls les utilisateurs avec rôle admin de plateforme peuvent écrire. Les lectures sont également admin-restricted (le frontend rankion.ai/blog rend les posts publiés en public, mais via server-side rendering, pas via cette API).
• Slug unique — au sein d'une catégorie. 422 en cas de conflit.
• Soft-delete — les suppressions sont réversibles si la migration porte deleted_at ; en cas de doute, mettre le statut sur draft plutôt que supprimer.

Modules associés

• AI Content Editor — création d'articles assistée par IA pour les sites d'équipe ; pas pour le blog propre Rankion.
• Rankion OS — Storage & Files — featured images et asset library pour les blog posts.