Uwierzytelnianie
Wyślij klucz API jako token bearer. Klucz musi posiadać uprawnienie audit.read; klucz bez niego jest odrzucany z kodem 403, a nie 404.
Miejsce na identyfikator organizacji
Ten punkt końcowy przyjmuje org_id jako parametr zapytania. Pomiń go, a wywołanie obejmie całe drzewo dzierżawy; prześlij go, aby ograniczyć wywołanie do jednej organizacji.
Identyfikator Twojej organizacji znajduje się na ekranie kluczy API w Twoim panelu, obok samego klucza. Jest to ten sam identyfikator w każdym wywołaniu, które wykonujesz.
Wypróbuj
Zastąp wszystko w nawiasach ostrych własnymi wartościami, a zastępczy znacznik klucza kluczem ze swojego pulpitu nawigacyjnego.
curl -X GET https://api.zinndigital.com/v1/audit \
-H "Authorization: Bearer zdk_live_…"Zalogowany? Konsola API w Twoim panelu uzupełnia rzeczywiste identyfikator organizacji oraz Twój własny klucz i wykonuje żądanie względem aktywnego API, dzięki czemu możesz zobaczyć rzeczywistą odpowiedź. Otwórz ten punkt końcowy w konsoli API
Szczegóły
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`.
Parametry
| Nazwa | Typ | Wymagane | Co to jest |
|---|---|---|---|
cursor (query) | string | Nie | Opaque cursor from a previous page's `page.next_cursor`. |
limit (query) | integer | Nie | Maximum items to return (page size). |
org_id (query) | Uuid | Nie | Restrict to one organization in scope (default — the whole subtree). |
action (query) | string | Nie | Filter to one action code (e.g. `apikey.created`). |
actor (query) | string | Nie | Filter to one actor (e.g. `user:0190…` or `apikey:0190…`). |
since (query) | string | Nie | Only entries at or after this ISO 8601 instant. |
Odpowiedź
| Nazwa | Typ | Wymagane | Co to jest |
|---|---|---|---|
data | AuditEntry[] | Tak | — |
page | PageMeta | Tak | — |
Błędy, które ten punkt końcowy może zwrócić
401 · 403 · 422 · 429