Catalisa.Building Blocks

API do Audit Trail

6 endpoints em 5 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 →

7 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

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 6 rotas