Catalisa.Building Blocks

API do Audit Trail

10 endpoints em 6 recursos. A permissão de cada rota é a que o código exige — conferida linha a linha, não copiada do nome.

Ver a referência detalhada, com corpo de requisição e catálogo de erros →

11 endpoints

Consulta da trilha

/audit-trail/api/v1/logs2
  • GET/audit-trail/api/v1/logsLista a trilha da organização, paginada e filtrávelAUDIT_LOGS_READ
  • GET/audit-trail/api/v1/logs/resource/:type/:idLinha do tempo completa de um recursoAUDIT_LOGS_READ

Ingestão

/audit-trail/api/v1/events1
  • POST/audit-trail/api/v1/eventsRecebe um evento de domínio, ou até 100 em events[], de um produtor fora deste código (o painel, um sistema parceiro) e **publica no fluxo iam-events** — não grava linha. 202 com {accepted, messageIds}AUDIT_EVENTS_WRITE

Integridade

/audit-trail/api/v14
  • GET/audit-trail/api/v1/verify?from=&to=Recalcula a corrente da organização e devolve {valid, checked, firstBrokenSequence, reason, head, preChain, anchorsChecked, prunedThroughSequence, prunedThroughHash, anchorsCoveringPruned, unchainedAfterChainStart, pendingAfterHead, range}AUDIT_LOGS_READ
  • GET/audit-trail/api/v1/anchorsLista as âncoras assinadas, da mais recente para a mais antiga, paginadaAUDIT_LOGS_READ
  • GET/audit-trail/api/v1/keysChaves de assinatura da organização — **só a metade pública**AUDIT_LOGS_READ
  • GET/audit-trail/api/v1/export?from=&to=&format=ndjsonTransmite a trilha encadeada em NDJSON, com a âncora que a cobre na última linhaAUDIT_LOGS_READ

Configuração

/audit-trail/api/v1/config2
  • GET/audit-trail/api/v1/configRetenção vigente da organizaçãoAUDIT_LOGS_READ
  • PUT/audit-trail/api/v1/config/retentionDefine a retenção, de 1 a 3.650 diasAUDIT_CONFIG_MANAGE

Expurgo

/audit-trail/api/v1/cleanup1
  • POST/audit-trail/api/v1/cleanupRemove **fisicamente** as linhas fora do prazo de retençãoAUDIT_CONFIG_MANAGE

Saúde do serviço

/audit-trail/health1
  • GET/audit-trail/healthStatus estático do serviço. Pública, **não contabilizada** nas 10 rotas