ServiceUser

Un ServiceUser es un end-user del producto que se ha registrado mediante ServiceLogin, es decir, una cuenta de miembro. Es una identidad independiente de la cuenta de plataforma de Weegloo (el Weegloo User que inicia sesión en el estudio de contenidos), y el token de un ServiceUser se autentica frente a ACMA/ACDA.

Un ServiceUser se crea cuando el miembro se registra por sí mismo a través de ServiceLogin. Por eso esta API no tiene endpoints de creación ni de eliminación, sino solo consulta y algunas modificaciones realizadas por un administrador (Weegloo User).

Estructura del recurso

A continuación se muestra la respuesta de consulta individual de un ServiceUser. Junto con sys (propiedades del sistema), incluye las propiedades del cuerpo nickname, avatarUrl, roleOverride, enableLogin e isAdmin, que contienen la información de visualización del miembro y la configuración de permisos.

{
  "sys": {
    "id": "3trmXRM3RqbgSnifyg7PSusr01Ex",
    "type": "ServiceUser",
    "space": { "sys": { "id": "HnQ32YiH", "type": "Refer", "targetType": "Space" } },
    "provider": "google",
    "email": "buyer@example.com",
    "createdAt": "2026-06-18T12:50:00.000Z",
    "updatedAt": "2026-06-18T12:50:00.000Z"
  },
  "nickname": "Cliente habitual",
  "avatarUrl": "https://lh3.example.com/a/buyer-avatar",
  "roleOverride": null,
  "enableLogin": true,
  "isAdmin": false
}

Claves principales:

• sys.email: la dirección de correo electrónico que el miembro usó para registrarse. Junto con sys.provider indica con qué cuenta se registró.
• sys.provider: el proveedor de OAuth usado para el registro (por ejemplo, google).
• roleOverride: el Refer que se incluye cuando se quiere asignar un ServiceUserRole distinto solo a este miembro. Si está vacío (null), se aplica el rol predeterminado de ServiceLogin.
• isAdmin: al activarlo, este miembro podrá eliminar recursos creados por otros miembros. Es un permiso reducido y no otorga permisos de modificación ni de lectura sobre los recursos de otros miembros.

Propiedades del sistema (sys)

Todo ServiceUser contiene las propiedades comunes del sistema en el objeto sys. space se incluye con la forma Refer ({ "sys": { "id", "type": "Refer", "targetType" } }).

Como un ServiceUser es un recurso que el miembro crea con su propio registro, a diferencia de otros recursos de CMA, su sys no tiene createdBy, updatedBy ni version. Como no hay version, en las modificaciones (PUT, PATCH) tampoco se envía la cabecera X-Weegloo-Version. Tampoco existe el concepto de publicación, por lo que no hay publish, archive ni status.

Propiedades del cuerpo

Gestión de miembros

Como un ServiceUser se origina con el registro, no hay endpoint de creación ni endpoint de eliminación. Lo que un administrador (Weegloo User) puede ajustar mediante modificación (PUT, PATCH) son estas tres cosas:

• Asignar o quitar roleOverride: asigna un ServiceUserRole distinto solo a un miembro concreto. Se usa cuando se quiere tratar de forma diferente a un solo miembro, como en niveles de pago, moderadores o grupos beta. El roleOverride asignado tiene prioridad sobre el defaultRole de ServiceLogin.
• Alternar enableLogin: al desactivarlo, se bloquea el inicio de sesión de ese miembro.
• Alternar isAdmin: al activarlo, permite eliminar recursos creados por otros miembros con fines de moderación.

isAdmin es un indicador reducido que solo añade la eliminación de recursos de otros miembros. No otorga permisos de modificación ni de lectura sobre los recursos de otros miembros, ni asciende a este miembro a administrador del estudio de contenidos de Weegloo (administrador de CMA). Tampoco habilita operaciones que el ServiceUserRole del miembro no permita de entrada.

API

La URL base de todos los endpoints siguientes es https://cma.weegloo.com/v1, y requieren un token Bearer que autentique frente a CMA en la cabecera Authorization. Como ServiceUser es un recurso sin version, en las modificaciones (PUT, PATCH) tampoco se envía la cabecera X-Weegloo-Version. No hay endpoints de creación ni de eliminación (se crean con el registro).

Documentos relacionados

• ServiceUserRole: el conjunto de permisos que se asigna a roleOverride.
• ServiceLogin: registro de miembros y configuración del rol predeterminado (defaultRole).
• Visión general de ACMA/ACDA: la API que llama un ServiceUser.