Saltar al contenido principal

Directus

Directus es un headless CMS moderno que convierte cualquier base de datos SQL en una API REST y GraphQL instantánea, con un panel de administración elegante.

Primeros Pasos​

1. Acceder a Directus​

Después de que tu deployment esté listo:

  1. Visita tu URL: https://tu-subdominio.deployalo.com
  2. Verás la pantalla de inicio de sesión

2. Credenciales de Administrador​

  • Email: Ve a Tab Técnico → Variables de Entorno → ADMIN_EMAIL
  • Contraseña: Ve a Tab Técnico → Variables de Entorno → ADMIN_PASSWORD

3. Primer Login​

  1. Inicia sesión con las credenciales anteriores
  2. Accederás al panel de administración de Directus

Configuración Inicial​

Crear tu Primera Colección​

Las colecciones en Directus son como tablas en una base de datos:

  1. Ve a Settings → Data Model
  2. Click "Create Collection"
  3. Ingresa nombre (ej: articles, products)
  4. Añade campos:
    • title (String)
    • content (WYSIWYG)
    • published_date (DateTime)
    • image (Image)
  5. Click "Save"

Añadir Contenido​

  1. Ve a Content → [Tu Colección]
  2. Click "+" para crear un nuevo item
  3. Completa los campos
  4. Click "Save"

API REST​

Tu contenido está disponible automáticamente via API:

# Listar items
GET https://tu-subdominio.deployalo.com/items/articles

# Obtener un item
GET https://tu-subdominio.deployalo.com/items/articles/1

# Crear item (autenticado)
POST https://tu-subdominio.deployalo.com/items/articles
{
  "title": "Mi Artículo",
  "content": "Contenido aquí..."
}

Autenticación​

# Obtener token
POST https://tu-subdominio.deployalo.com/auth/login
{
  "email": "tu@email.com",
  "password": "tu-password"
}

# Usar token
GET https://tu-subdominio.deployalo.com/items/articles
Authorization: Bearer <token>

API GraphQL​

También disponible en /graphql:

query {
  articles {
    id
    title
    content
    published_date
  }
}

Permisos y Roles​

  1. Ve a Settings → Roles & Permissions
  2. Crea roles personalizados:
    • Editor - puede crear/editar contenido
    • Author - solo su propio contenido
    • Public - permisos de lectura pública
  3. Configura permisos por colección

Webhooks​

Automatiza acciones cuando el contenido cambia:

  1. Ve a Settings → Webhooks
  2. Click "Create Webhook"
  3. Configura:
    • URL de destino
    • Eventos (create, update, delete)
    • Colecciones a monitorear

Flows (Automatización)​

Directus incluye un sistema de automatización visual:

  1. Ve a Settings → Flows
  2. Crea un flow:
    • Trigger: Cuando se crea un artículo
    • Action: Enviar email de notificación

Casos de Uso​

  • Blog/CMS - Gestiona artículos, categorías, autores
  • E-commerce - Productos, categorías, inventario
  • App Backend - API para tu app móvil/web
  • Dashboard - Panel de administración para cualquier dato

Recursos​