Recupera voci del registro di controllo per un account

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"
  }
]

Recupera i registri di controllo con alcune funzionalità di filtro tramite parametri di query

Autenticazione

AuthorizationBearer

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

Parametri di percorso

account_idstringObbligatorioformat: "uuid"

Account 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

Supporta IPv4 (1.1.1.1) e IPv6 (2001:db8:3333:4444:5555:6666:7777:8888)

pageintegerOpzionalePredefinito a 1

Numero pagina

page_sizeintegerOpzionale<=200Predefinito a 50

Record per pagina

Header di risposta

linkstringOpzionale

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

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