API ReferenceRegistri Di Controllo

Recupera voci del registro di controllo per l’utente specificato

Recupera i registri di controllo per un determinato utente, con alcune opzioni di filtro tramite parametri di query. Funge da registro delle attività per l’utente specificato

Autenticazione

AuthorizationBearer

Autenticazione bearer nella forma Bearer <token>, dove token è il tuo token di autenticazione.

Parametri di percorso

user_idstringObbligatorioformat: "uuid"Predefinito a erfb57e0-79f2-4bc7-9b70-99fbc175175c
User ID

Parametri di query

filters[start_date]stringOpzionaleformat: "date"
Data ISO di inizio
filters[end_date]stringOpzionaleformat: "date"
Data ISO di fine
filters[resource_type]enumOpzionale
Filtra per tipo di risorsa
filters[event_type]enumOpzionale

Filtra per tipo di attività

filters[team_id]stringOpzionaleformat: "uuid"
Filtra per ID team
filters[project_id]stringOpzionaleformat: "uuid"
Filtra per ID progetto
filters[resource_id]stringOpzionaleformat: "uuid"

Filtra per ID risorsa (ID risorsa, ID progetto, ID utente)

filters[user_id]stringOpzionaleformat: "uuid"
Filtra per ID utente
filters[ip_address]stringOpzionale
Filtra per indirizzo IP
pageintegerOpzionalePredefinito a 1
Numero pagina
page_sizeintegerOpzionale<=200Predefinito a 50
Record per pagina

Header di risposta

page-numberinteger
Current page of results
per-pageinteger
Number of entries per page
totalinteger
Total entries across all pagess
total-pagesinteger
Number of pages

Risposta

Succesful Event logs response
account_idstring or nullOpzionaleformat: "uuid"
anonymous_user_idstring or nullOpzionaleformat: "uuid"
clientstring or nullOpzionale

Il client API che ha attivato l’evento di audit. Questo campo non viene sempre popolato.

Quando la chiamata API che ha generato un evento viene effettuata tramite un’app OAuth, il valore è simile a oauth_app/:uuid; se invece viene effettuata tramite un token sviluppatore, il valore è simile a user_token/:uuid, dove UUID corrisponde all’ID utente a cui appartiene il token.

Ecco alcuni esempi:

  • user_token/57823879-e541-49b0-b902-c43794c4400c
  • oauth_app/80ccf0bb-ae91-49c4-8aec-8f6238c14947
  • web/2024-06-10-18-15
  • pipeline-media-warden/cbd0061f6f190489e8af3137b8707b33f498f53f
  • null
event_typeenumOpzionale
event_detailsobjectOpzionale

Dettagli dell’evento. Variano notevolmente in base al tipo di evento, ma nelle risposte esemplificative ci sono alcuni esempi.

iddoubleOpzionale
Identificatore univoco
inserted_atstringOpzionaleformat: "date-time"
ip_addressstring or nullOpzionale

Indirizzo IP associato all’evento

project_idstring or nullOpzionaleformat: "uuid"

ID progetto in cui si è verificata questa azione

resource_idstringOpzionaleformat: "uuid"

L’ID della risorsa di riferimento

resource_typeenumOpzionale
Tipo di risorsa a cui si fa riferimento
team_idstring or nullOpzionaleformat: "uuid"
ID team
sourceenumOpzionale

Origine dell’azione che ha generato una determinata voce del registro di controllo

user_idstring or nullOpzionaleformat: "uuid"
ID utente
updated_atstringOpzionaleformat: "date-time"

Errori

401
Unauthorized Error
404
Not Found Error