CMA (Content Management API)

Última atualização: 3 de julho de 2026

A CMA (Content Management API) é a API de gestão para criar, ler, editar e excluir o conteúdo e as configurações de um Space. O que se faz no estúdio de conteúdo (escrever conteúdo, publicar, gerenciar membros e papéis, emitir tokens etc.) pode ser feito da mesma forma a partir de código. A API somente leitura que entrega o conteúdo publicado aos visitantes fica a cargo da CDA à parte.

A URL base é https://cma.weegloo.com/v1. A identidade de quem chama é a de um Weegloo User (conta da plataforma Weegloo). Em servidor, CI ou scripts, envia-se como Bearer um Personal Access Token; em interfaces de administração no navegador, o token emitido pelo fluxo de login do estúdio de conteúdo. Os tokens não são compatíveis com a ACMA, que atua com a identidade do membro inscrito no produto (ServiceUser).

Comportamento comum

O que segue se aplica a todos os recursos da CMA. Cada página de recurso assume esse comportamento e trata apenas do que lhe é próprio.

  • CRUD completo. Suporta criar (POST), consultar (GET), editar (PUT/PATCH) e excluir (DELETE). Diferentemente da CDA, que é somente leitura, a escrita e a publicação acontecem aqui.
  • A edição exige o cabeçalho de versão. Ao editar um recurso, é preciso enviar no cabeçalho x-weegloo-version o valor de sys.version atual do recurso. É o mecanismo que impede sobrescrever uma versão que outra pessoa editou antes.
  • A edição parcial usa PATCH. Para alterar apenas alguns campos, envia-se um PATCH com o corpo no formato RFC 6902 JSON Patch. Nesse caso, o Content-Type da requisição é application/json-patch+json. Para substituir pelo corpo completo, usa-se PUT.
  • É preciso publicar para entregar. Content, Media e Content Type só são entregues pela CDA depois de criados ou editados na CMA e publicados (Publish). Antes da publicação, o Draft ou as alterações não publicadas aparecem no estúdio de conteúdo e na CMA, mas não entram no caminho de entrega.
  • Tipo de mídia da resposta. O Content-Type da resposta é application/vnd.com.weegloo.v1+json;charset=UTF-8. Enviar Accept: application/json na requisição pode falhar na negociação, por isso convém omitir o Accept ou usar o mesmo tipo de vendor.

Parâmetros de consulta de listas (limit, order, include, select, filtros, paginação por cursor), a estrutura de sys, códigos de erro e demais convenções comuns são tratados em Parâmetros de query comuns, Propriedades de sistema (sys), Convenções e Erros.

Recursos

Conteúdo

  • Content Type: define o molde (schema) que o conteúdo segue. Determina a composição dos campos, o tipo, se é multi-idioma, se é obrigatório e as regras de validação.
  • Content: cria, edita e publica um registro de dados concreto produzido a partir de um Content Type.
  • Media: gerencia o recurso que guarda os arquivos enviados (imagens, documentos etc.).
  • Tag: gerencia os rótulos curtos que classificam Content ou Media.
  • Locale: gerencia as configurações de idioma que o Space suporta (code, se é padrão e fallbackCode).

Espaço e organização, permissões

  • Organization: o contêiner de nível mais alto que abriga os Space. O plano de assinatura (plan) e as associações são gerenciados nesse nível.
  • Organization Membership: indica a qual Organization uma pessoa pertence e com qual permissão, e admite novos integrantes por convite por e-mail.
  • Space: o espaço de trabalho que abriga todo o conteúdo de um projeto.
  • Space Membership: indica a qual Space um usuário pertence e com quais SpaceRole.
  • SpaceRole: o conjunto de permissões concedido a um integrante do Space. Contém as ações por recurso (ler, criar, editar, excluir, publicar) e os filtros de escopo.

Tokens

  • Personal Access Token: o token de longa duração que um Weegloo User usa para chamar a CMA, o Upload e a CDA com a própria permissão em servidor, CI ou scripts.
  • Delivery Access Token: o token de leitura usado para ler o conteúdo publicado pela CDA. Na emissão, é vinculado a um SpaceRole para definir o escopo de leitura.

Membros do produto (ServiceUser)

  • ServiceLogin: a configuração com a qual o Space inscreve e autentica por OAuth os end-users (ServiceUser) do próprio produto.
  • ServiceUserRole: o conjunto de permissões concedido ao ServiceUser inscrito no produto. Aplica-se à ACMA/ACDA.
  • ServiceUser: o end-user do produto inscrito por ServiceLogin, ou seja, a conta de membro.

Implantação e integração

  • Web Hosting: o recurso que serve o site estático construído no endereço {subdomain}.weegloo.app.
  • Webhook: a configuração que envia uma requisição HTTP a uma URL externa indicada quando algo acontece no Space (por exemplo, a criação ou publicação de um Content).
  • CDA: a API somente leitura que entrega o conteúdo publicado aos visitantes.
  • ACMA: a versão que realiza as mesmas operações de gestão com a identidade de membro (ServiceUser).
  • Upload: a API de upload que envia um arquivo e conecta o resultado à criação de um Media.