API ReferenceJournaux Daudit

Obtenir les entrées du journal d’audit d’un utilisateur spécifié

Récupérer les journaux d’audit d’un utilisateur donné avec certaines fonctionnalités de filtrage via les paramètres de requête. Il est recommandé de considérer cela comme un journal d’activité pour l’utilisateur spécifié.

Authentification

AuthorizationBearer

Authentification bearer de la forme Bearer <token>, où token est votre jeton d’authentification.

Paramètres de chemin

user_idstringRequisformat: "uuid"Par défaut erfb57e0-79f2-4bc7-9b70-99fbc175175c
User ID

Paramètres de requête

filters[start_date]stringOptionnelformat: "date"

Date ISO de début

filters[end_date]stringOptionnelformat: "date"
Date ISO de fin
filters[resource_type]enumOptionnel
Filtrer par type de ressource
filters[event_type]enumOptionnel

Filtrer par type d’activité

filters[team_id]stringOptionnelformat: "uuid"

Filtrer par ID d’équipe

filters[project_id]stringOptionnelformat: "uuid"
Filtrer par ID de projet
filters[resource_id]stringOptionnelformat: "uuid"

Filtrer par ID de ressource (ID d’asset, ID de projet, ID d’utilisateur)

filters[user_id]stringOptionnelformat: "uuid"

Filtrer par ID d’utilisateur

filters[ip_address]stringOptionnel
Filtrer par adresse IP
pageintegerOptionnelPar défaut 1

Numéro de page

page_sizeintegerOptionnel<=200Par défaut 50
Enregistrements par page

En-têtes de réponse

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

Réponse

Succesful Event logs response
account_idstring or nullOptionnelformat: "uuid"
anonymous_user_idstring or nullOptionnelformat: "uuid"
clientstring or nullOptionnel

Client API à l’origine du déclenchement de l’événement d’audit. Ce champ n’est pas toujours renseigné.

Lorsqu’un appel API ayant produit un événement a été effectué via une application OAuth, il se présente ainsi : oauth_app/:uuid, et s’il a été effectué via un jeton de développeur, il se présente ainsi : user_token/:uuid, l’UUID correspondant à l’ID d’utilisateur auquel le jeton appartient.

Voici quelques exemples :

  • 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_typeenumOptionnel
event_detailsobjectOptionnel

Détails de l’événement. Cela varie considérablement d’un type d’événement à l’autre, mais vous trouverez des exemples dans les exemples de réponses.

iddoubleOptionnel
Identifiant unique
inserted_atstringOptionnelformat: "date-time"
ip_addressstring or nullOptionnel

Adresse IP associée à cet événement

project_idstring or nullOptionnelformat: "uuid"

Identifiant du projet dans lequel cette action s’est produite

resource_idstringOptionnelformat: "uuid"

ID de la ressource référencée

resource_typeenumOptionnel

Type de la ressource référencée

team_idstring or nullOptionnelformat: "uuid"

ID de l’équipe

sourceenumOptionnel

Source de l’action à l’origine d’une entrée donnée dans le journal d’audit

user_idstring or nullOptionnelformat: "uuid"

ID d’utilisateur

updated_atstringOptionnelformat: "date-time"

Erreurs

401
Unauthorized Error
404
Not Found Error