Space

O Space é o espaço de trabalho onde fica armazenado todo o conteúdo de um projeto. O Content Type, que define a estrutura do conteúdo, o Content, que são os dados reais, o Media, como imagens e arquivos, e o Locale, que é a configuração de idioma, vivem todos dentro de um único Space. Um Space pertence a uma Organization, que é o recipiente de nível superior, e normalmente se mantém um Space para cada serviço.

A lista de Spaces aos quais você pertence é consultada por GET /me/space-memberships.

Estrutura do recurso

A seguir está a resposta de consulta única do Space "Loja DailyWear". Ele possui sys (propriedades do sistema) e a propriedade de corpo name.

{
  "sys": {
    "id": "HnQ32YiH",
    "type": "Space",
    "organization": { "sys": { "id": "ilLRJxDp", "type": "Refer", "targetType": "Organization" } },
    "createdBy": { "sys": { "id": "3p4tcFbQRwz503VXdtHXNI5dZH5TVB", "type": "Refer", "targetType": "User" } },
    "createdAt": "2026-06-14T14:56:04.737Z",
    "updatedBy": { "sys": { "id": "3p4tcFbQRwz503VXdtHXNI5dZH5TVB", "type": "Refer", "targetType": "User" } },
    "updatedAt": "2026-06-14T14:56:58.670Z",
    "version": 2
  },
  "name": "Loja DailyWear"
}

Chaves principais:

  • name: o nome do Space (1 a 64 caracteres). É o nome de exibição do projeto ou serviço.
  • organization: é o Refer<Organization> que aponta para a Organization de nível superior à qual este Space pertence.

O plano de assinatura não está vinculado ao Space, e sim à Organization de nível superior. Para conferir ou trocar o plano, veja Organization.

Propriedades do sistema (sys) e corpo

Todo Space mantém as propriedades de sistema comuns no objeto sys. organization entra como Refer<Organization>, e createdBy e updatedBy entram no formato Refer ({ "sys": { "id", "type": "Refer", "targetType" } }).

PropriedadeTipoDescrição
idstringIdentificador único do recurso.
typestringTipo do recurso. Para o Space é sempre "Space".
organizationRefer<Organization>A Organization de nível superior à qual este Space pertence.
createdByRefer<User>Usuário que criou.
createdAtstring (date-time)Momento da criação.
updatedByRefer<User>Último usuário que modificou.
updatedAtstring (date-time)Momento da última modificação.
versioninteger (≥1)Versão do recurso. Aumenta em 1 a cada modificação.

Propriedades de corpo:

PropriedadeTipoDescrição
namestring (1 a 64)Nome do Space. Definido na criação e na modificação.
descriptionstring (1 a 128)Descrição do Space. É um item opcional.
iconstring (leitura) / object (escrita)Ícone do Space. Na resposta é uma string de URL da imagem. Na requisição de modificação é enviado como um objeto que aponta para o arquivo carregado: { "upload": { "sys": { ..., "targetType": "Upload" } } } (referência ao Upload obtido pela API Upload).

O Space é um recurso de configuração que não tem o conceito de publicação. Por isso, ao contrário de Content e Media, o sys não tem publish, archive nem status, tendo apenas version. O version aumenta a cada modificação do Space.

A configuração que troca a tela inicial do Space por outra página não fica neste recurso, e sim na Organization de nível superior. Ao definir o consoleHomeUrl da Organization, a tela inicial de todos os Spaces que ficam sob ela passa a ser essa página.

Erros

São os códigos que você encontra ao lidar com o Space. Para os códigos comuns a todos os recursos, consulte Erros comuns.

CódigoCondição
WGL422024Houve uma tentativa de excluir o Space enquanto ainda restava dentro dele algum Content Type, Content, Media ou Web Hosting. A exclusão só é possível depois que tudo o que restou for apagado.
WGL422046O arquivo enviado como icon ultrapassa o tamanho permitido.
WGL422047O arquivo enviado como icon não é PNG, JPG nem WebP.

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. Para modificação e modificaçã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. A listagem, a criação, a modificação, a modificação parcial e a exclusão ficam sob o caminho da Organization de nível superior (/organizations/{organizationId}/spaces). A consulta única pode ser feita pelo caminho direto /spaces/{spaceId}, como abaixo (a consulta única também existe no caminho da Organization de nível superior /organizations/{organizationId}/spaces/{spaceId}).

  • Organization: a Organization de nível superior à qual este Space pertence.
  • Space Membership: membros do Space e consulta dos Spaces aos quais pertenço.
  • Locale: configuração de idioma do Space.