Aller au contenu

Lista os registros da comunidade (todas as origens)

GET/api/logs

Auth
Jeton requis
Qui peut l’appeler:
owner
admin
finance
SuperAdmin
Clé d’API:
reports:read
X-CommunityId
X-CommunityId Envoyez le X-CommunityId de la communauté où l’opération a lieu.
Les descriptions des endpoints viennent directement de la spécification de l’API et sont en portugais pour l’instant. L’interface autour est traduite.

Linha do tempo única de tudo o que a comunidade do `X-CommunityId` registra, mais recentes primeiro. Owner e admin leem todos os tipos; o papel **financeiro** lê só o tipo `financial` (pedir outro tipo responde 403 `logs.typeForbidden`; sem `type`, recebe só o financeiro). Moderator e member recebem 403.

Tipos (`type`): - `team`: ações da equipe — mudança de papel, remoção de membro (e saída voluntária), alteração dos dados e das configurações da comunidade, ações sobre assinaturas (cancelar, desconto, cortesia…) e correções de visitas da Presença. - `platform`: histórico da plataforma sobre a comunidade — análise do cadastro da empresa e da conta de recebimento, vendas ligadas ou pausadas, entrada de novos membros suspensa ou retomada, transmissão nativa. - `assistant`: o que um assistente de IA (Claude, ChatGPT, Cursor) fez pela conexão MCP. - `members`: ações de membros que pontuam no Engajamento. - `emails`: envios de campanhas de e-mail (com contagem de destinatários e entregas). - `imports`: importações de membros que rodaram. - `financial`: vendas, reembolsos e saques como eventos, com o valor bruto. - `moderation`: a última decisão de moderação de cada item (aprovado, recusado, devolvido à fila). - `apiKeys`: chaves de API pessoais criadas, renomeadas, com IPs alterados ou revogadas, e as chamadas de escrita e exclusão que uma chave fez (`apiKey.request`, ex.: "POST /api/products via chave n8n"; quem agiu é o dono da chave, com `via: api_key`). Os `details` trazem `keyName`, `prefix` e, nas chamadas, `method`, `path` e `status`. Só owner e admin. - `workflows`: as linhas do bloco "Registrar log" dos workflows (`workflow.log.info|warning|error`, e `workflow.logLimitReached` quando a execução passou de 20 linhas). `summary` é a mensagem; `target` é o workflow; `actor.via` é `system`; `details` traz `level`, `workflowId`, `runId`, `nodeId` e `member` (a pessoa da execução). Filtros próprios: `workflowId` e `level`. Só owner e admin.

Cada item: `id`, `type`, `action` (chave estável, ex.: `member.role_changed`, `purchase.paid`, `mcp.tool.create_post`), `actor` (`memberId`, `name`, `avatarUrl`, `via`: `app`, `mcp` — feito por um assistente —, `api_key` — feito por uma chave de API —, `superadmin` ou `system`; `memberId` e `name` nulos quando foi o sistema), `target` (`kind`, `id`, `label`; `spaceId` quando o alvo vive num space; nulo no login diário), `summary` (a frase no idioma do `Accept-Language`), `createdAt` e `details` (só campos seguros: papel antes e depois, status, contagens, valor bruto e moeda).

Nunca aparecem: tokens, argumentos e resultados do MCP, documentos, conta bancária, e-mails, custos do provedor, taxas ou valor líquido.

Filtros: `type`, `actorMemberId` (quem agiu; perfil de outra comunidade não traz nada), `from` e `to` no **fuso da comunidade** (`2026-10-14` é o dia inteiro lá; data e hora sem fuso são hora local da comunidade; com `Z` ou offset, valem como enviadas) e `search` (nome de quem agiu ou do alvo, título, arquivo, campanha, ferramenta). A paginação é exata entre todas as origens.

Paramètres

NomEmplacementTypeDescription
typefacultatifqueryteam | platform | assistant | members | emails | imports | financial | moderation | apiKeys | workflowsSó um tipo. Sem ele, todos os que o papel pode ler.
actorMemberIdfacultatifquerystring (uuid)Só o que essa pessoa fez.
fromfacultatifquerystringA partir de (inclusive), no fuso da comunidade.
tofacultatifquerystringAté (inclusive), no fuso da comunidade. Uma data inclui o dia todo.
searchfacultatifquerystringTexto livre (nome, título, arquivo, campanha, ferramenta).
workflowIdfacultatifquerystring (uuid)Só no tipo `workflows`, as linhas deste workflow.
levelfacultatifqueryinfo | warning | errorSó no tipo `workflows`, as linhas deste nível.
pagefacultatifqueryinteger
limitfacultatifqueryinteger

En-têtes

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

Réponses

StatutDescription
200Lista paginada, mais recentes primeiro.
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.

Exemple curl

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