Listar a trilha de auditoria
Toda escrita feita na v3 (criar, alterar, excluir, executar), por sessão ou por token, bem-sucedida ou recusada, da mais recente para a mais antiga. O evento diz quem fez, sobre qual recurso, qual operação e como terminou — nunca o conteúdo escrito. A revenda vê os eventos dela e os dos clientes da carteira; o cliente, os dele. Uma ação da equipe da DOM360 aparece como "Equipe DOM360", sem nome, e-mail nem endereço do funcionário, e o filtro user_id nunca a seleciona para quem não é da plataforma. A trilha guarda o ano corrente.
Autorização
bearer audit:readCredencial da v3: o JWT da sessão (o mesmo da v2) ou um token pessoal dom_pat_…. A lista de escopos de cada operação diz o que ela exige: uma capacidade (agents:read), authenticated ou session-only. Segredo de máquina (X-Agent-Secret, X-API-Token, sdk_…) não é aceito.
Em: header
Escopo: audit:read
Parâmetros de consulta
Estreita para um cliente (dentro do alcance).
int64Só as ações deste usuário.
uuidUma ou mais operações do contrato, separadas por vírgula
(agents_update,agents_delete).
O tipo do recurso tocado (agent, user, call_job).
O id do recurso tocado; exige resource_type.
Uma ou mais classes de resultado, separadas por vírgula: success,
warning, refused, error ou aborted.
Só os eventos a partir deste instante (inclusive).
date-timeSó os eventos até este instante (inclusive).
date-timeCursor opaco devolvido em page.next_cursor da página anterior. Omita para começar do início.
Tamanho da página. Padrão 50; o máximo é o da coleção: 200, ou até 500 nas coleções de itens pequenos.
int320 <= valueCorpo da resposta
application/json
application/json
curl -X GET "https://example.com/audit-events"{ "data": [ { "actor": { "display_name": "string", "email": "string", "role": "master", "type": "user", "user_id": "a169451c-8525-4352-b8ca-070dd449a1a5" }, "client_ip": "string", "credential": "session", "dealer_id": 0, "error": null, "id": 0, "method": "POST", "occurred_at": "2019-08-24T14:15:22Z", "operation_id": "string", "operation_summary": "string", "replayed": true, "request_id": "string", "resource": null, "result": "success", "status": 0, "tenant_id": 0, "via": "string", "warning": "string" } ], "page": { "has_more": true, "next_cursor": "string" }}