CMA (Content Management API)

Última actualización: 3 de julio de 2026

La CMA (Content Management API) es una API de gestión para crear, leer, modificar y eliminar el contenido y la configuración de un Space. Permite realizar desde el código las mismas tareas que se hacen en el estudio de contenidos (redactar contenido, publicar, gestionar miembros y roles, emitir tokens, etc.). La API de solo lectura que entrega el contenido publicado a los visitantes corre por cuenta de la CDA, que es independiente.

La URL base es https://cma.weegloo.com/v1. La identidad de quien hace la llamada es la de un Weegloo User (la cuenta de plataforma de Weegloo). Desde servidores, CI o scripts se envía como Bearer un Personal Access Token; en las interfaces de administración del navegador, el token que emite el flujo de inicio de sesión del estudio de contenidos. Los tokens no son compatibles con la ACMA, que actúa con la identidad de un miembro registrado en el producto (ServiceUser).

Comportamiento común

Lo siguiente se aplica a todos los recursos de la CMA. Cada página de recurso da por sentado este comportamiento y solo trata su contenido específico.

  • CRUD completo. Admite crear (POST), consultar (GET), modificar (PUT/PATCH) y eliminar (DELETE). A diferencia de la CDA, que es de solo lectura, aquí ocurren la escritura y la publicación.
  • Modificar requiere la cabecera de versión. Al modificar un recurso hay que enviar en la cabecera x-weegloo-version el valor sys.version actual del recurso. Es un mecanismo que evita sobrescribir una versión que otra persona haya modificado antes.
  • Las modificaciones parciales se hacen con PATCH. Para cambiar solo algunos campos, se envía un PATCH con un cuerpo RFC 6902 JSON Patch. En ese caso, el Content-Type de la solicitud es application/json-patch+json. Para reemplazar con el cuerpo completo se usa PUT.
  • Hay que publicar para que se entregue. Content, Media y Content Type se entregan a la CDA solo después de crearlos o modificarlos en la CMA y publicarlos (Publish). Los Draft o los cambios sin publicar se ven en el estudio de contenidos y en la CMA, pero no llegan a la ruta de entrega.
  • Tipo de medio de la respuesta. El Content-Type de la respuesta es application/vnd.com.weegloo.v1+json;charset=UTF-8. Si se envía Accept: application/json en la solicitud, la negociación puede fallar, así que conviene omitir Accept o usar el mismo tipo de proveedor.

Los convenios comunes como los parámetros de consulta de listas (limit, order, include, select, filtros, paginación por cursor), la estructura de sys o los códigos de error se tratan en parámetros de consulta comunes, propiedades del sistema (sys), convenios y errores.

Recursos

Contenido

  • Content Type: define la plantilla (el esquema) que sigue el contenido. Establece la composición de los campos, su tipo, si admiten varios idiomas, si son obligatorios y las reglas de validación.
  • Content: crea, modifica y publica una unidad de datos real generada a partir de un Content Type.
  • Media: gestiona los recursos que contienen los archivos subidos (imágenes, documentos, etc.).
  • Tag: gestiona las etiquetas breves que clasifican Content o Media.
  • Locale: gestiona la configuración de idiomas que admite el Space (code, si es el predeterminado y fallbackCode).

Espacios y organizaciones, permisos

  • Organization: es el contenedor de máximo nivel que agrupa los Space. El plan de suscripción (plan) y las membresías se gestionan a este nivel.
  • Organization Membership: indica con qué permisos pertenece una persona a una Organization y permite incorporar nuevos integrantes mediante invitación por correo electrónico.
  • Space: es el espacio de trabajo donde se reúne todo el contenido de un proyecto.
  • Space Membership: indica con qué SpaceRole pertenece un usuario a un Space.
  • SpaceRole: es el conjunto de permisos que se concede a un integrante de un Space. Reúne las acciones por recurso (leer, crear, editar, eliminar, publicar) y los filtros de alcance.

Tokens

  • Personal Access Token: es el token de larga duración que un Weegloo User usa para llamar a la CMA, la Upload y la CDA con sus propios permisos desde servidores, CI o scripts.
  • Delivery Access Token: es el token de lectura que se usa para leer el contenido publicado en la CDA. Al emitirlo, se vincula a un único SpaceRole para definir el alcance de lectura.

Miembros del producto (ServiceUser)

  • ServiceLogin: es la configuración con la que un Space registra e inicia la sesión de los end-user (ServiceUser) de su propio producto mediante OAuth.
  • ServiceUserRole: es el conjunto de permisos que se concede a un ServiceUser registrado en el producto. Se aplica a la ACMA y la ACDA.
  • ServiceUser: es el end-user del producto registrado mediante ServiceLogin, es decir, una cuenta de miembro.

Despliegue e integración

  • Web Hosting: es el recurso que sirve un sitio web estático compilado en la dirección {subdomain}.weegloo.app.
  • Webhook: es la configuración que envía una solicitud HTTP a una URL externa indicada cuando ocurre algo en el Space (por ejemplo, la creación o la publicación de un Content).
  • CDA: la API de solo lectura que entrega el contenido publicado a los visitantes.
  • ACMA: la versión que realiza las mismas tareas de gestión con la identidad de un miembro (ServiceUser).
  • Upload: la API de subida que conecta un archivo subido con la creación de un Media.