Saltar al contenido

Lista os registros de atividade da comunidade

GET/api/activity-logs

Auth
Requiere token
Quién puede:
owner
admin
moderator
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.

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.

Parámetros

NombreDóndeTipoDescripción
sourceopcionalqueryteam | assistant | membersSó uma origem. Sem ele, as três.
profileIdopcionalquerystring (uuid)Só o que essa pessoa fez.
fromopcionalquerystring (date-time)A partir de (inclusive).
toopcionalquerystring (date-time)Até (inclusive). `2026-10-06` inclui o dia todo.
pageopcionalqueryinteger
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
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.

Ejemplo con curl

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