Obtenir les entrées du journal d’audit d’un compte

import requests
url = "https://api.frame.io/v2/accounts/erfb57e0-79f2-4bc7-9b70-99fbc175175c/events"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.json())

[
  {
    "anonymous_user_id": null,
    "client": null,
    "event_type": "asset_created",
    "event_details": {
      "account_id": "6bdcb4d9-9a2e-4548-a765-ae6b27a6c024",
      "ext": ".png",
      "filesize": 170144,
      "filetype": "image/png",
      "index": -17,
      "name": "Sample asset.png",
      "parent_id": "ba6cd478-5ca3-4c1a-2186-82cdaecb3e6c",
      "private": false,
      "project_id": "e9794c94-16a4-4e33-b4e6-cdd9757d0e24",
      "sm_refresh_at": "2024-06-28T21:42:54Z",
      "uploaded_at": "2024-06-28T21:42:54.437202Z"
    },
    "id": 1944044771,
    "inserted_at": "2024-06-28T21:42:54.516273Z",
    "ip_address": "255.255.255.255",
    "project_id": "j2794c94-16a4-4e33-b4e6-cdd9757d0e24",
    "resource_id": "92je2963-24ae-4cd1-be13-19a93c92eb6e",
    "resource_type": "asset",
    "team_id": "5j4d6420-fa8d-4e85-af05-0f26785c54f5",
    "source": "unknown",
    "user_id": "b72b57e0-79f2-4bc7-9b70-99fbc175175c",
    "updated_at": "2024-06-28T21:42:54.516273Z"
  }
]

Récupérer les journaux d’audit avec des fonctionnalités de filtrage via les paramètres de requête

Authentification

AuthorizationBearer

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

Paramètres de chemin

account_idstringRequisformat: "uuid"

Account 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

Sont pris en charge IPv4 (1.1.1.1) et IPv6 (2001:db8:3333:4444:5555:6666:7777:8888).

pageintegerOptionnelPar défaut 1

Numéro de page

page_sizeintegerOptionnel<=200Par défaut 50

Enregistrements par page

En-têtes de réponse

linkstring

Pagination links

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 nullformat: "uuid"

anonymous_user_idstring or nullformat: "uuid"

clientstring or null

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_typeenum

event_detailsobject

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.

iddouble

Identifiant unique

inserted_atstringformat: "date-time"

ip_addressstring or null

Adresse IP associée à cet événement

project_idstring or nullformat: "uuid"

Identifiant du projet dans lequel cette action s’est produite

resource_idstringformat: "uuid"

ID de la ressource référencée

resource_typeenum

Type de la ressource référencée

team_idstring or nullformat: "uuid"

ID de l’équipe

sourceenum

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

user_idstring or nullformat: "uuid"

ID d’utilisateur

updated_atstringformat: "date-time"

Erreurs

401

Unauthorized Error

404

Not Found Error