Tag

Última atualização: 22 de junho de 2026

A Tag é um rótulo curto que classifica Content ou Media. Tomando uma loja de roupas como exemplo, rótulos como "Mais vendidos" ou "Novidades" são Tag. Ao aplicar a mesma Tag a vários Content e Media, é possível consultar ou selecionar depois agrupando por esse rótulo.

A Tag em si é um rótulo que tem apenas um nome (name) e é um recurso de configuração sem o conceito de publicação. Aplicar de fato algo a um item não se faz editando diretamente a Tag, mas inserindo o Refer desta Tag no metadata.tags do Content ou Media (veja Aplicar tags a conteúdo e mídia abaixo). Na CMA, a Tag é um recurso subordinado ao Space, e o caminho tem como base /spaces/{spaceId}/tags.

Estrutura do recurso

A seguir está a resposta de consulta individual da Tag "Mais vendidos". Ela tem sys (propriedades de sistema) e a propriedade de corpo name.

{
  "sys": {
    "id": "3trmXRM3RqbgSnifyg7OShPt8M8Nwh",
    "type": "Tag",
    "space": { "sys": { "id": "HnQ32YiH", "type": "Refer", "targetType": "Space" } },
    "createdBy": { "sys": { "id": "3p4tcFbQRwz503VXdtHXNI5dZH5TVB", "type": "Refer", "targetType": "User" } },
    "createdAt": "2026-06-16T01:46:07.426Z",
    "updatedBy": { "sys": { "id": "3p4tcFbQRwz503VXdtHXNI5dZH5TVB", "type": "Refer", "targetType": "User" } },
    "updatedAt": "2026-06-16T01:46:07.426Z",
    "version": 1
  },
  "name": "Mais vendidos"
}

Chaves principais:

  • sys.id: identificador único da Tag. Entra no {tagId} dos caminhos de consulta individual, edição e exclusão, e também é usado como id de destino do Refer ao aplicar a tag por metadata.tags.
  • name: nome da Tag (1 a 16 caracteres). É o próprio rótulo que aparece na classificação de conteúdo.

Propriedades de sistema (sys)

Toda Tag mantém as propriedades de sistema comuns no objeto sys. space, createdBy e updatedBy entram no formato Refer ({ "sys": { "id", "type": "Refer", "targetType" } }).

PropriedadeTipoDescrição
idstringIdentificador único do recurso.
typestringTipo do recurso. Para a Tag é sempre "Tag".
spaceRefer<Space>O Space a que esta Tag pertence.
createdByRefer<User>Usuário que criou o recurso.
createdAtstring (date-time)Momento da criação.
updatedByRefer<User>Último usuário que editou o recurso.
updatedAtstring (date-time)Momento da última edição.
versioninteger (≥1)Versão do recurso. Sobe em 1 a cada edição.

Propriedade de corpo:

PropriedadeTipoDescrição
namestring (1 a 16)Nome da Tag. Definido na criação e na edição.

A Tag é um recurso de configuração sem o conceito de publicação. Por isso, diferente de Content e Media, o sys não tem publish, archive nem status, apenas version. O version sobe a cada edição da Tag.

Aplicar tags a conteúdo e mídia

Para aplicar uma Tag, há dois passos.

  1. Crie a Tag (endpoint Criar Tag abaixo). Guarde o sys.id da resposta.
  2. Ao criar ou editar o Content ou Media, insira o Refer desta Tag no array metadata.tags do corpo.

O formato do Refer inserido em metadata.tags é o seguinte. Em id, coloque o sys.id da Tag obtido no passo 1.

"metadata": {
  "tags": [
    { "sys": { "id": "3trmXRM3RqbgSnifyg7OShPt8M8Nwh", "type": "Refer", "targetType": "Tag" } }
  ]
}

Para aplicar várias Tag, insira vários desses objetos Refer no array. Para remover uma tag, retire o item correspondente do array e edite novamente o Content ou Media. Para o modo detalhado de compor os dados de corpo de Content e Media, consulte os documentos Content e Media.

API

A URL base de todos os endpoints abaixo é https://cma.weegloo.com/v1, e é necessário um token Bearer que autentique na CMA no cabeçalho Authorization. Na edição e na edição parcial, é preciso enviar também o cabeçalho X-Weegloo-Version (o sys.version atual do recurso) para o controle de concorrência otimista. A criação e a exclusão não têm esse cabeçalho.

  • Content: dados de corpo que aplicam a Tag por metadata.tags.
  • Media: recurso de arquivo que aplica a Tag por metadata.tags.