ServiceUser

ServiceUser é o end-user do produto que se cadastrou via ServiceLogin, ou seja, uma conta de membro. É uma identidade distinta da conta da plataforma Weegloo (o Weegloo User que faz login no estúdio de conteúdo), e o token de um ServiceUser é autenticado contra a ACMA/ACDA.

O ServiceUser é criado quando o membro se cadastra diretamente via ServiceLogin. Por isso, esta API não tem endpoints de criação nem de exclusão, apenas a consulta e algumas modificações feitas por um administrador (Weegloo User).

Estrutura do recurso

A seguir está a resposta de consulta individual de um ServiceUser. Junto com sys (propriedades de sistema), ele tem as propriedades de corpo nickname, avatarUrl, roleOverride, enableLogin e isAdmin, que guardam as informações de exibição do membro e as configurações de permissão.

{
  "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 fiel",
  "avatarUrl": "https://lh3.example.com/a/buyer-avatar",
  "roleOverride": null,
  "enableLogin": true,
  "isAdmin": false
}

Chaves principais:

• sys.email: o endereço de e-mail que o membro usou para se cadastrar. Junto com sys.provider, indica com qual conta o cadastro foi feito.
• sys.provider: o provedor OAuth usado no cadastro (por exemplo, google).
• roleOverride: o Refer que se informa para atribuir um ServiceUserRole diferente apenas a este membro. Se estiver vazio (null), segue a função padrão do ServiceLogin.
• isAdmin: quando ativado, permite que este membro exclua recursos criados por outros membros. É uma permissão restrita, e não concede permissão de modificação ou leitura sobre os recursos de outros membros.

Propriedades de sistema (sys)

Todo ServiceUser guarda as propriedades de sistema comuns no objeto sys. O space entra no formato Refer ({ "sys": { "id", "type": "Refer", "targetType" } }).

Como o ServiceUser é um recurso que o próprio membro cria ao se cadastrar, ao contrário de outros recursos da CMA, ele não tem createdBy, updatedBy nem version em sys. Como não há version, a modificação (PUT, PATCH) também não envia o cabeçalho X-Weegloo-Version. Também não existe o conceito de publicação, portanto não há publish, archive nem status.

Propriedades de corpo

Gerenciamento de membros

Como o ServiceUser surge a partir do cadastro, não há endpoint de criação nem de exclusão. O que um administrador (Weegloo User) pode ajustar por meio da modificação (PUT, PATCH) são estas três coisas.

• Definir/remover roleOverride: atribui um ServiceUserRole diferente apenas a um membro específico. Usa-se quando se quer tratar um único membro de forma diferente, como em planos pagos, moderadores ou grupos beta. O roleOverride informado tem precedência sobre o defaultRole do ServiceLogin.
• Alternar enableLogin: se desativado, bloqueia o login daquele membro.
• Alternar isAdmin: quando ativado, permite excluir recursos criados por outros membros para fins de moderação.

O isAdmin é uma flag restrita que adiciona apenas a exclusão sobre recursos de outros membros. Não concede permissão de modificação ou leitura sobre os recursos de outros membros, nem promove este membro a administrador do estúdio de conteúdo Weegloo (administrador da CMA). Também não abre operações que o ServiceUserRole do membro já não permita por si só.

API

A URL base de todos os endpoints abaixo é https://cma.weegloo.com/v1, e é necessário um token Bearer que autentica a CMA no cabeçalho Authorization. Como o ServiceUser é um recurso sem version, a modificação (PUT, PATCH) também não envia o cabeçalho X-Weegloo-Version. Não há endpoints de criação nem de exclusão (criação por cadastro).

Documentos relacionados

• ServiceUserRole: o conjunto de permissões a atribuir em roleOverride.
• ServiceLogin: cadastro de membros e configuração da função padrão (defaultRole).
• Visão geral de ACMA/ACDA: a API que o ServiceUser chama.