Skip to content

Coluna lateral do Feed

GET/api/feed/sidebar

Auth
Public
API key:
feed:read
X-CommunityId
X-CommunityId Send the X-CommunityId of the community the operation happens in.
Endpoint descriptions come straight from the API specification and are in Portuguese for now. The interface around them is translated.

Os widgets da coluna lateral do Feed, só com o que quem chama pode abrir. Aceita visitante (sem `Authorization`). Devolve **só os widgets ligados e com itens**: uma chave ausente em `data` quer dizer widget desligado, vazio ou não permitido para quem chama; com `data` vazio (`{}`), o Feed fica na coluna única. - `events` (até 5): eventos publicados que ainda não terminaram, o mais cedo primeiro, de todos os espaços que a pessoa abre e os sem espaço, pela regra do `GET /api/events` (rascunho, `private`, aguardando moderação e apagado/cancelado ficam fora). Evento sem fim termina no fim do dia em que começa, no fuso do evento (sem fuso, o da comunidade): `endsAt` é esse fim e `timezone` o fuso usado. `isLive` quando está acontecendo. - `trending` (até 5): posts de Conteúdo e status publicados nos últimos 7 dias (pela data de publicação, ou a de criação), ordenados por reações + 2 × comentários (só os não apagados e de outras pessoas; o autor não conta), empate pelo mais novo; só entra post com ao menos uma interação. Ficam fora: status agendado para o futuro, post retroativo para antes da semana, post publicado pela equipe em nome de outro membro, rascunho, aguardando moderação e o que a pessoa não pode ler. O ranking pode levar até 1 minuto para refletir uma reação nova. Em status, `title` é o começo do texto. - `newMembers` (até 6; desligado por padrão): quem entrou nos últimos 30 dias, mais novo primeiro, só nome e avatar. Nunca para visitante. - `leaderboard` (top 5 dos últimos 30 dias; desligado por padrão): só com a gamificação ativa; `space` é o espaço de Ranking que a pessoa abre (para o link "Ver ranking"), ou `null`. Nunca para visitante.

Quais widgets estão ligados vem do `feedWidgets` do espaço de Feed pedido em `spaceId` (`null` ou sem `spaceId`: eventos e em alta ligados, os outros dois desligados).

Parameters

NameInTypeDescription
spaceIdoptionalquerystring (uuid)O espaço de Feed aberto, de onde vêm os widgets ligados. 404 para espaço de outra comunidade (ou inexistente); 403 para espaço que a pessoa não abre (com o motivo do cadeado).

Headers

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

Responses

StatusDescription
200Os widgets ligados e com itens.
400Requisição inválida — falha de validação.
403Autenticado, mas sem permissão para esta operação.
404Recurso não encontrado.
500Erro interno do servidor.

curl example

curl -X GET "https://api.memberfy.net/api/feed/sidebar" \
  -H "X-CommunityId: $COMMUNITY_ID"