Saltar al contenido

Métricas de leitura de um post

GET/api/analytics/content/{contentId}

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

Leituras, expansões e cliques de um post (`Content`) e os 5 domínios mais clicados. Veem: **owner e admin da comunidade e o autor do post**; moderador, financeiro e membro que não é o autor recebem **403**. Post de outra comunidade, apagado ou inexistente: **404**. O detalhe do post (`GET /api/content/{id}`) traz `canViewMetrics` para o app decidir se mostra o bloco.

Sem `from`, desde o início (o dia em que o post foi criado; as métricas começam a contar quando a funcionalidade entrou no ar); sem `to`, até hoje. Cada número conta **pessoas por dia** (o perfil logado, senão a sessão da aba; a sessão que fez login no dia conta como o perfil) e o do período é a **soma dos dias**: quem volta em outro dia conta de novo; expandir dez vezes no mesmo dia conta 1. `reads`: abriram a página do post. `expands`: abriram o "…ver mais". `clicks`: clicaram em algum link do post; `topLinkHosts[].clicks`: pessoas que clicaram naquele domínio. Só o domínio é guardado, nunca o endereço. Só tráfego humano.

Parámetros

NombreDóndeTipoDescripción
contentIdobligatoriopathstring (uuid)
fromopcionalquerystring (date)Opcional; sem ele
toopcionalquerystring (date)Opcional; sem ele

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
200Métricas do post.
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.
404Recurso não encontrado.
500Erro interno do servidor.

Ejemplo con curl

curl -X GET "https://api.memberfy.net/api/analytics/content/<contentId>" \
  -H "Authorization: Bearer $TOKEN" \
  -H "X-CommunityId: $COMMUNITY_ID"