Zum Inhalt springen

Coluna lateral do Feed

GET/api/feed/sidebar

Auth
Öffentlich
API-Schlüssel:
feed:read
X-CommunityId
X-CommunityId Sende die X-CommunityId der Community, in der die Operation stattfindet.
Die Beschreibungen der Endpoints stammen aus der API-Spezifikation und sind vorerst auf Portugiesisch. Die Oberfläche drumherum ist übersetzt.

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).

Parameter

NameOrtTypBeschreibung
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).

Header

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

Antworten

StatusBeschreibung
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-Beispiel

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