audit

GET `/v1/audit`

Read the organization's audit log.

Hitelesítés

Küldjön egy API-kulcsot bearer tokenként. A kulcsnak rendelkeznie kell a(z) audit.read jogosultsággal; az ezzel nem rendelkező kulcsok esetén a rendszer 403-as hibát ad vissza 404 helyett.

A szervezet azonosítójának helye

Ez a végpont a(z) org_id paramétert lekérdezési paraméterként várja. Hagyja ki, ha a hívás az Ön teljes bérlői részfáját lefedje; küldje el a hívás egyetlen szervezetre történő szűkítéséhez.

A szervezeted azonosítója a vezérlőpult API-kulcsok képernyőjén található, közvetlenül a kulcs mellett. Ez ugyanaz az azonosító minden indított hívásban.

Próbálja ki

Cserélje ki a hegyes zárójelek közötti részt a saját értékeivel, a kulcshelyőrzőt pedig a vezérlőpultján található kulccsal.

curl -X GET https://api.zinndigital.com/v1/audit \
  -H "Authorization: Bearer zdk_live_…"

Be van jelentkezve? A vezérlőpultban lévő API-konzol kitölti a valós szervezetazonosítóját és a saját kulcsát, és a kérést az éles API-n futtatja, hogy láthassa a tényleges választ. Nyissa meg ezt a végpontot az API konzolban

Részletek

Returns the append-only record of privileged actions taken in the tenant — including staff access — newest first, ordered by the sortable id, with older entries reachable by paging the cursor. (It described itself as oldest → newest until #462 made every collection newest-first: for an audit feed the answer to "what just happened here?" was on the last page.) The actor's IP is not exposed here (it is admin-console only). Requires audit.read.

Paraméterek

Név	Típus	Kötelező	Mi ez
`cursor (query)`	`string`	Nem	Opaque cursor from a previous page's `page.next_cursor`.
`limit (query)`	`integer`	Nem	Maximum items to return (page size).
`org_id (query)`	`Uuid`	Nem	Restrict to one organization in scope (default — the whole subtree).
`action (query)`	`string`	Nem	Filter to one action code (e.g. `apikey.created`).
`actor (query)`	`string`	Nem	Filter to one actor (e.g. `user:0190…` or `apikey:0190…`).
`since (query)`	`string`	Nem	Only entries at or after this ISO 8601 instant.

Válasz

Név	Típus	Kötelező	Mi ez
`data`	`AuditEntry[]`	Igen	—
`page`	`PageMeta`	Igen	—

Hibák, amelyeket ez a végpont visszaadhattatlan

401 · 403 · 422 · 429