audit

GET /v1/audit

Read the organization's audit log.

Minden audit végpont

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évTípusKötelezőMi ez
cursor (query)stringNemOpaque cursor from a previous page's `page.next_cursor`.
limit (query)integerNemMaximum items to return (page size).
org_id (query)UuidNemRestrict to one organization in scope (default — the whole subtree).
action (query)stringNemFilter to one action code (e.g. `apikey.created`).
actor (query)stringNemFilter to one actor (e.g. `user:0190…` or `apikey:0190…`).
since (query)stringNemOnly entries at or after this ISO 8601 instant.

Válasz

NévTípusKötelezőMi ez
dataAuditEntry[]Igen
pagePageMetaIgen

Hibák, amelyeket ez a végpont visszaadhattatlan

401 · 403 · 422 · 429