Vai al contenuto

Lista os registros de atividade da comunidade

GET/api/activity-logs

Auth
Richiede un token
Chi può:
owner
admin
moderator
X-CommunityId
X-CommunityId Invia l’X-CommunityId della community in cui avviene l’operazione.
Le descrizioni degli endpoint provengono dalla specifica dell’API e per ora sono in portoghese. L’interfaccia intorno è tradotta.

Linha do tempo única do que aconteceu na comunidade do `X-CommunityId`, mais recentes primeiro. Exige owner ou admin dessa comunidade (moderator e member recebem 403).

Três origens (`source`): - `team`: ações da equipe sobre assinaturas (cancelar, reativar, desconto, cortesia, prorrogação, adicional, link de pagamento). `details` traz o que mudou (`before`, `after`) e o papel de quem agiu (`actorRole`). - `assistant`: o que um assistente de IA (Claude, ChatGPT, Cursor) fez pela conexão MCP — ferramentas chamadas, conexões autorizadas e revogadas. `details.args` é um **resumo** dos argumentos: tokens de confirmação e de idempotência, imagens em base64 e qualquer campo com nome de segredo ficam de fora; textos são cortados em 200 caracteres e listas de objetos viram `{ count }`. - `members`: ações de membros que pontuam no ranking (publicar, comentar, curtir, participar de evento, se inscrever em curso, login diário). `details.points` é a pontuação ganha.

Cada item: `id`, `at`, `source`, `actor` (`profileId`, `name`, `avatarUrl`; `profileId` nulo quando quem agiu não tem perfil na comunidade; `actor` nulo quando não se sabe), `action` (chave estável para o app traduzir: `subscription.CANCEL_NOW`, `mcp.tool.create_post`, `mcp.oauth.consent`, `game.LIKE_POST`), `actionLabel` (a ação no idioma do `Accept-Language`), `target` (`type`, `id`, `label`; nulo no login diário) e `details`.

Quando o alvo vive dentro de um space (`target.type` `content`, `event`, `status` ou `course`), `target` traz também `spaceId`, para abrir o item no space dele. Vem `null` quando o item foi excluído ou não está em nenhum space; nos outros tipos o campo não aparece.

Filtros: `source`, `profileId` (a pessoa que agiu; perfil de outra comunidade não traz nada), `from` e `to` (ISO 8601; uma data sem hora em `to` inclui o dia inteiro, em UTC). A paginação é exata entre as três origens.

Parametri

NomeDoveTipoDescrizione
sourcefacoltativoqueryteam | assistant | membersSó uma origem. Sem ele, as três.
profileIdfacoltativoquerystring (uuid)Só o que essa pessoa fez.
fromfacoltativoquerystring (date-time)A partir de (inclusive).
tofacoltativoquerystring (date-time)Até (inclusive). `2026-10-06` inclui o dia todo.
pagefacoltativoqueryinteger
limitfacoltativoqueryinteger

Header

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

Risposte

CodiceDescrizione
200Lista paginada, mais recentes primeiro.
400Requisição inválida — falha de validação.
401Token ausente, inválido ou expirado.
403Autenticado, mas sem permissão para esta operação.
500Erro interno do servidor.

Esempio con curl

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