Audit-Logs abrufen · DeutschlandGPT

Gibt paginierte Audit-Logs für den Enterprise-Workspace zurück. Unterstützt die Filterung nach Kategorie, Aktion, Akteur und Datumsbereich. Erfordert einen Admin-API-Key und einen Enterprise-Workspace.

GEThttps://api.deutschlandgpt.de/v2/admin/audit-logs

Beispielaufruf

curl https://api.deutschlandgpt.de/v2/admin/audit-logs \
  -X GET \
  -H "Authorization: Bearer $DGPT_API_KEY"

curl https://api.deutschlandgpt.de/v2/admin/audit-logs \
  -X GET \
  -H "Authorization: Bearer $DGPT_API_KEY"

import os, requests

response = requests.get(
    "https://api.deutschlandgpt.de/v2/admin/audit-logs",
    headers={"Authorization": f"Bearer {os.environ['DGPT_API_KEY']}"},
)

print(response.json())

import os, requests

response = requests.get(
    "https://api.deutschlandgpt.de/v2/admin/audit-logs",
    headers={"Authorization": f"Bearer {os.environ['DGPT_API_KEY']}"},
)

print(response.json())

const response = await fetch('https://api.deutschlandgpt.de/v2/admin/audit-logs', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.DGPT_API_KEY}`,
  },
});

console.log(await response.json());

const response = await fetch('https://api.deutschlandgpt.de/v2/admin/audit-logs', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.DGPT_API_KEY}`,
  },
});

console.log(await response.json());

Parameter

pageintegeroptional

Seitenzahl

page_sizeintegeroptional

Ergebnisse pro Seite

categorystringoptional

Filter nach Aktions-Namespace-Präfix — passt auf Aktionen, die mit <category>. beginnen (z. B. category=api_key passt auf api_key.created).

actionstringoptional

Filter nach Aktion (z. B. api_key.created)

actor_idstringoptional

Filter nach Akteur-Benutzer-ID

start_datestring<date>optional

Startdatum (ISO 8601)

end_datestring<date>optional

Enddatum (ISO 8601)

sortstringoptional

Sortierfeld

dirstringoptional

Sortierrichtung

anonymizebooleanoptional

Wenn true (Standard), werden personenbezogene Felder durch deterministische SHA-256-Hashes ersetzt. Auf false setzen, um Rohwerte zurückzugeben.

Antwort

200application/json

{
  "object": "list",
  "data": [
    {
      "id": "string",
      "action": "string",
      "actorEmail": "string",
      "actorId": "string",
      "targetId": "string",
      "targetLabel": "string",
      "metadata": {},
      "createdAt": "2025-01-01T00:00:00Z"
    }
  ],
  "pagination": {
    "page": 0,
    "pageSize": 0,
    "total": 0,
    "totalPages": 0
  }
}

{
  "object": "list",
  "data": [
    {
      "id": "string",
      "action": "string",
      "actorEmail": "string",
      "actorId": "string",
      "targetId": "string",
      "targetLabel": "string",
      "metadata": {},
      "createdAt": "2025-01-01T00:00:00Z"
    }
  ],
  "pagination": {
    "page": 0,
    "pageSize": 0,
    "total": 0,
    "totalPages": 0
  }
}

Paginierte Audit-Logs

objectstring

dataAuditLogEntry[]

idstring

actionstring

actorEmailstring

E-Mail-Adresse des Akteurs. Standardmäßig SHA-256-gehasht, wenn anonymize=true.

actorIdstring | null

Benutzer-ID des Akteurs. Null, wenn der Akteur-Benutzer gelöscht wurde.

targetIdstring | null

targetLabelstring | null

Ziel-Label (kann personenbezogene Daten enthalten). Standardmäßig SHA-256-gehasht, wenn anonymize=true.

metadataobject | null

createdAtstring<date-time>

paginationobject

pageinteger

pageSizeinteger

totalinteger

totalPagesinteger

Statuscodes

200

Paginierte Audit-Logs

object

401

Nicht autorisiert

403

Erfordert Admin-API-Key und Enterprise-Workspace