Saltar al contenido

Coluna lateral de um espaço de lista

GET/api/spaces/{id}/sidebar

Auth
Pública
Clave de API:
community:read
X-CommunityId
X-CommunityId Envía el X-CommunityId de la comunidad en la que ocurre la operación.
Las descripciones de los endpoints vienen de la especificación de la API y, por ahora, están en portugués. La interfaz alrededor está traducida.

Os widgets da coluna lateral de um espaço que lista itens, só com o que quem chama pode ler. Hoje só o módulo **Conteúdo** (`content`) tem coluna; para os outros módulos a resposta é `data: {}`. Aceita visitante (sem `Authorization`). Devolve **só os widgets com itens**: uma chave ausente em `data` quer dizer widget vazio. Os posts considerados são os do espaço que a pessoa pode ler, pela regra do Feed: não apagados, publicados, aprovados na moderação e com visibilidade que ela lê (`public` para visitante; `members` para membro; `plan` para quem tem plano, ou para o autor). - `tags`: as tags desses posts, cada uma uma vez (pela chave: `Vagas` = `vagas`), escrita como no post mais novo que a usa, com `count` (quantos posts a têm); mais usadas primeiro, empate em ordem alfabética da chave; até 50 (`total` é quantas tags diferentes existem). Para filtrar a lista, use `tag` em `GET /api/content?spaceId=…&tag=…`. Conta até os 2.000 posts mais novos. - `trending` (até 5, sempre preenchido quando o espaço tem post que a pessoa lê; ausente só num espaço sem nenhum): primeiro os posts dos últimos 30 dias (pela data de publicação) com interação, por reações + 2 × comentários (não apagados e de outras pessoas; o autor não conta), empate pelo mais novo; post publicado pela equipe em nome de outro membro fica fora dessa primeira parte. Faltando, completa com os mais reagidos de todos os tempos (reações, depois comentários, depois o mais novo) e, se ainda faltar, com os mais recentes. Nunca repete post. `basis` diz de onde cada um veio (`recent`, `allTime` ou `latest`); `reactions` e `comments` são as contagens do post (de outras pessoas). Visualizações não contam (posts não registram visualização). Considera os 2.000 posts mais novos.

Parámetros

NombreDóndeTipoDescripción
idobligatoriopathstring (uuid)

Headers

NombreTipoDescripción
X-CommunityIdopcionalstring (uuid)ID da comunidade em que a operação acontece. Obrigatório na maioria dos endpoints com escopo de comunidade.

Respuestas

CódigoDescripción
200Os widgets com itens.
400Requisição inválida — falha de validação.
403O leitor não abre este espaço; `data` diz por quê e o próximo passo (o mesmo 403 de `GET /api/spaces/{id}`).
404Recurso não encontrado.
500Erro interno do servidor.

Ejemplo con curl

curl -X GET "https://api.memberfy.net/api/spaces/<id>/sidebar" \
  -H "X-CommunityId: $COMMUNITY_ID"