Saltar al contenido

Conteúdo mais lido do período

GET/api/analytics/content

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.

Owner e admin (moderador, financeiro e membro recebem 403). Os posts (`Content`) não apagados com mais **leituras** no período, depois expansões e cliques. Período em dias do fuso da comunidade (`from`/`to` inclusivos; padrão os últimos 30 dias até hoje), com o dia corrente vindo do bruto.

Cada número conta **pessoas por post 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. `reads`: abriram a página do post. `expands`: abriram o "…ver mais". `clicks`: clicaram em algum link do post. `topLinkHosts`: os 3 domínios mais clicados (pessoas por domínio). Só tráfego humano. As métricas começam a contar quando a funcionalidade entrou no ar (sem retroativo).

Para o link do post no app: `path` (`/{seção}/{espaço}/{id}`, null quando o espaço ou a seção não existem mais), ou `section.slug` e `space.slug`.

Parámetros

NombreDóndeTipoDescripción
fromopcionalquerystring (date)
toopcionalquerystring (date)
limitopcionalqueryinteger

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
200Ranking do período.
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/analytics/content" \
  -H "Authorization: Bearer $TOKEN" \
  -H "X-CommunityId: $COMMUNITY_ID"