Saltar al contenido

Lista os registros da comunidade (todas as origens)

GET/api/logs

Auth
Requiere token
Quién puede:
owner
admin
finance
SuperAdmin
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 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 ranking. - `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).

Cada item: `id`, `type`, `action` (chave estável, ex.: `member.role_changed`, `purchase.paid`, `mcp.tool.create_post`), `actor` (`profileId`, `name`, `avatarUrl`, `via`: `app`, `mcp` — feito por um assistente —, `superadmin` ou `system`; `profileId` 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`, `actorProfileId` (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.

Parámetros

NombreDóndeTipoDescripción
typeopcionalqueryteam | platform | assistant | members | emails | imports | financial | moderationSó um tipo. Sem ele, todos os que o papel pode ler.
actorProfileIdopcionalquerystring (uuid)Só o que essa pessoa fez.
fromopcionalquerystringA partir de (inclusive), no fuso da comunidade.
toopcionalquerystringAté (inclusive), no fuso da comunidade. Uma data inclui o dia todo.
searchopcionalquerystringTexto livre (nome, título, arquivo, campanha, ferramenta).
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/logs" \
  -H "Authorization: Bearer $TOKEN" \
  -H "X-CommunityId: $COMMUNITY_ID"