Zum Inhalt

Auditereignisse eines Mandanten auflisten.

Methode

GET https://papi.afi.ai/api/v1/tenants/{tenant_id}/audit/events

Beschreibung

Ruft Auditereignisse für den angegebenen Mandanten ab. Mit den Abfrageparametern limit und page_token können Sie alle Ereignisse seitenweise durchlaufen.

Pfadparameter
tenant_id string erforderlich

ID des Mandanten, dessen Ereignisse aufgelistet werden sollen.

Abfrageparameter
limit int32

Maximale Anzahl der pro Seite zurückzugebenden Elemente.

page_token string

Token aus dem vorherigen Listenaufruf (`next_page_token`), mit dem die Auflistung fortgesetzt wird.

start_time date-time

Beginn des Zeitraums zum Abrufen von Auditereignissen. Verwenden Sie das RFC-3339-Format.

end_time date-time

Ende des Zeitraums zum Abrufen von Auditereignissen. Verwenden Sie das RFC-3339-Format.

curl -X GET \
    -H 'Authorization: {api-key}' \
    https://papi.afi.ai/api/v1/tenants/{tenant_id}/audit/events

Schema der erfolgreichen Antwort (200)
object

AuditEventsPage enthält die Ergebnisse der Auditereignisauflistung.

next_page_token string

Token für die nächste Seite der Auflistung. Legen Sie diesen Wert in der nachfolgenden Anfrage als `page_token` fest. Auf der letzten Seite ist er leer.

items array of objects

Liste der Auditereignisse.

object

AuditEvent beschreibt ein Auditereignis.

id string

Ereignis-ID.

actor_email string

E-Mail-Adresse des Akteurs, der das Ereignis ausgelöst hat.

actor_name string

Name des Akteurs, der das Ereignis ausgelöst hat.

action string

Vom Akteur ausgeführte Aktion.

subject string

Von der Aktion betroffenes Objekt.

created_at date-time

Zeitstempel der Ereigniserstellung.

details string

Zusätzliche Ereignisinformationen im JSON-Format. Die genaue Struktur hängt vom Auditereignistyp ab und kann sich in zukünftigen Produktversionen ändern.

Antwortbeispiel
{
  "next_page_token": "string",
  "items": [
    {
      "id": "string",
      "actor_email": "string",
      "actor_name": "string",
      "action": "string",
      "subject": "string",
      "created_at": "2025-11-19T20:02:49.314307Z",
      "details": "string"
    }
  ]
}