Guida introduttiva all’API di query di audit

Adobe Experience Platform consente di controllare l’attività dell’utente per vari servizi e funzionalità sotto forma di registri di eventi di audit. Ogni azione registrata contiene metadati che indicano il tipo di azione, la data e l’ora, l’ID e-mail dell’utente che l’ha eseguita e altri attributi relativi al tipo di azione.

L’API Audit Query consente di controllare l’attività dell’utente per vari servizi e funzionalità sotto forma di registri eventi di audit. Questo documento fornisce un’introduzione ai concetti fondamentali che è necessario conoscere prima di tentare di effettuare chiamate all’API Query di audit.

Prerequisiti

Per gestire gli eventi di controllo, è necessario disporre dell'autorizzazione di controllo dell'accesso Visualizza log attività utente concessa (nella categoria Governance dei dati). Per informazioni su come gestire le singole autorizzazioni per le funzionalità di Platform, consulta la documentazione sul controllo degli accessi.

Lettura delle chiamate API di esempio

Questa guida fornisce esempi di chiamate API per illustrare come formattare le richieste. Questi includono percorsi, intestazioni richieste e payload di richieste formattati correttamente. Viene inoltre fornito un codice JSON di esempio restituito nelle risposte API. Per informazioni sulle convenzioni utilizzate nella documentazione per le chiamate API di esempio, consulta la sezione su come leggere le chiamate API di esempio nella guida alla risoluzione dei problemi di Experience Platform.

Raccogliere i valori per le intestazioni richieste

Questa guida richiede di aver completato l'esercitazione sull'autenticazione per poter effettuare correttamente le chiamate alle API di Platform. Il completamento del tutorial di autenticazione fornisce i valori per ciascuna delle intestazioni richieste in tutte le chiamate API di Experience Platform, come mostrato di seguito:

Tutte le risorse in Experience Platform sono isolate in specifiche sandbox virtuali. Tutte le richieste alle API Platform richiedono un'intestazione che specifichi il nome della sandbox in cui verrà eseguita l'operazione. Per ulteriori informazioni sulle sandbox in Platform, consulta la documentazione di panoramica sulle sandbox.

Tutte le richieste che contengono un payload (POST, PUT e PATCH) richiedono un’intestazione aggiuntiva:

Passaggi successivi

Per iniziare a effettuare chiamate utilizzando l'API Audit Query, consulta la guida dell'endpoint eventi e la guida dell'endpoint esportazione.