Saltar al contenido

Novidades desde a última visita, por espaço e por seção (contadores do menu)

GET/api/menu/counters

Auth
Requiere token
Clave de API:
No acepta clave de API
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.

Uma chamada só para o menu inteiro. Para cada espaço de **Feed**, **Conteúdo** e **Eventos** que quem pede pode abrir, quantos itens chegaram desde a última visita dele ao espaço; e a soma por seção.

- **Última visita:** registrada ao abrir o espaço (`GET` do espaço), no máximo uma vez por minuto por pessoa e espaço. Quem nunca abriu o espaço conta desde que entrou na comunidade. - **O que conta:** em Feed e Conteúdo, posts de **outras pessoas** naquele espaço, publicados, aprovados e de uma visibilidade que quem pede lê (rascunho, agendado, pendente e excluído não contam). Um Feed que mostra a seção inteira conta só os posts dele (os outros espaços da seção têm o seu contador). Em Eventos, eventos publicados e aprovados que quem pede pode ver. Novo é o que foi escrito ou publicado depois da última visita. - **Acesso:** espaço que a pessoa não abre (privado, de plano, de grupo, de produto, com cadeado, módulo fora do plano) não aparece nem entra na soma da seção.

O número é exato; o app mostra "99+" acima de 99. Qualquer papel da comunidade do `X-CommunityId`.

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
200Contadores do menu.
400Requisição inválida — falha de validação.
401Token ausente, inválido ou expirado; token de outra comunidade (o `X-CommunityId` ou o `communityId` do corpo não é o do token); token antigo ou de uma sessão encerrada (troca de senha, convite aceito). Nesses casos a mensagem pede para entrar de novo (`auth.signInAgain`).
403Autenticado, mas sem permissão para esta operação.
500Erro interno do servidor.

Ejemplo con curl

curl -X GET "https://api.memberfy.net/api/menu/counters" \
  -H "Authorization: Bearer $TOKEN" \
  -H "X-CommunityId: $COMMUNITY_ID"