Blog Admin

Blog Admin es la capa CMS interna del blog público de Rankion en rankion.ai/blog. Aquí los platform owners gestionan categorías y posts: crear, editar, publicar, despublicar, borrar. A diferencia del AI Content Editor, este módulo no crea artículos con IA — es la interfaz admin clásica para contenidos editorialmente curados del blog propio de Rankion (marketing, updates, tutoriales). El módulo está restringido a usuarios admin y team-scoped al team del platform owner.

Qué puede hacer

• CRUD de categorías — crear, renombrar, cambiar slug, borrar categorías. Slug = componente de URL relevante para SEO.
• CRUD de posts — crear artículos, definir título/slug/body/featured image, asignar categoría, alternar status (draft, published).
• Validación de slugs — los slugs son únicos por categoría. Los slugs duplicados se rechazan.
• Publishing — pasar un post de draft a published lo publica al instante en rankion.ai/blog/<category>/<slug>.
• Body en Markdown — los posts se guardan como Markdown; el frontend renderiza con syntax highlighting y tipografía estilo wiki.
• Filtros de listado — la lista de posts es filtrable por status, categoría y término de búsqueda en el título.

Cuándo usarlo

• Eres platform owner y quieres publicar un nuevo artículo de marketing en rankion.ai/blog.
• Quieres renombrar una categoría existente o crear un nuevo topic-cluster.
• Quieres despublicar un post (p.ej. por desactualizado o problemático legalmente) sin borrarlo definitivamente.
• Quieres optimizar la estructura de slugs SEO sin gestionar redirects de URL manualmente.

Aviso: para artículos propios de un team (p.ej. blogs de cliente, sites de afiliación), usa el AI Content Editor — publica vía WordPress / integración CMS y no está restringido al blog propio de Rankion.

Workflow

1. Crea categorías — POST /blog/categories con {name, slug}. El slug se convierte en /blog/<slug>/....
2. Crea post — POST /blog/posts con {title, slug, body_md, category_id, status: "draft"}. El body es Markdown.
3. Edita — PUT /blog/posts/{id} para updates de contenido. El cambio de slug rompe los permalinks antiguos — comprueba antes si existen backlinks.
4. Publica — PUT /blog/posts/{id} con {status: "published"}. Live al instante.
5. Lista — GET /blog/posts?status=published&category_id=3 filtra.

API

Ejemplo — crear 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éditos y límites

• Sin coste — sin créditos. Las operaciones CMS no cuestan.
• Admin-only — solo usuarios con rol Platform-Admin pueden escribir. Las lecturas también están restringidas a admin (el frontend rankion.ai/blog renderiza posts published de forma pública pero vía Server-Side-Rendering, no vía esta API).
• Slug-Unique — dentro de una categoría. 422 ante conflicto.
• Soft-Delete — los borrados son reversibles si la migration lleva deleted_at; en la duda, pon status a draft en lugar de borrar.

Módulos relacionados

• AI Content Editor — creación de artículos con IA para sites propios del team; no para el blog propio de Rankion.
• Rankion OS — Storage & Files — featured images y asset library para los posts del blog.