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-CommunityIdEnvoyez le X-CommunityId de la communauté où l’opération a lieu.
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
| Nom | Emplacement | Type | Description |
|---|---|---|---|
typefacultatif | query | team | platform | assistant | members | emails | imports | financial | moderation | apiKeys | workflows | Só um tipo. Sem ele, todos os que o papel pode ler. |
actorMemberIdfacultatif | query | string (uuid) | Só o que essa pessoa fez. |
fromfacultatif | query | string | A partir de (inclusive), no fuso da comunidade. |
tofacultatif | query | string | Até (inclusive), no fuso da comunidade. Uma data inclui o dia todo. |
searchfacultatif | query | string | Texto livre (nome, título, arquivo, campanha, ferramenta). |
workflowIdfacultatif | query | string (uuid) | Só no tipo `workflows`, as linhas deste workflow. |
levelfacultatif | query | info | warning | error | Só no tipo `workflows`, as linhas deste nível. |
pagefacultatif | query | integer | |
limitfacultatif | query | integer |
En-têtes
| Nom | Type | Description |
|---|---|---|
X-CommunityIdfacultatif | string (uuid) | ID da comunidade em que a operação acontece. Obrigatório na maioria dos endpoints com escopo de comunidade. |
Réponses
| Statut | Description |
|---|---|
200 | Lista paginada, mais recentes primeiro. |
400 | Requisição inválida — falha de validação. |
401 | Token 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`). |
403 | Autenticado, mas sem permissão para esta operação. |
500 | Erro interno do servidor. |
Exemple curl
curl -X GET "https://api.memberfy.net/api/logs" \
-H "Authorization: Bearer $TOKEN" \
-H "X-CommunityId: $COMMUNITY_ID"