audit

GET /v1/audit

Read the organization's audit log.

Всички крайни точки в audit

Упълномощаване

Изпратете API ключ като токен за носене. Ключът трябва да притежава разрешението audit.read; ключ без него се отхвърля с 403, а не с 404.

Където отива идентификаторът на вашата организация

Този ендпойнт приема org_id като параметър на заявката. Оставете го празен и извикването ще обхване цялото ви поддървано дърво; изпратете го, за да ограничите извикването до една организация.

ИД на вашата организация се намира на екрана с API ключове във вашето табло за управление, до самия ключ. Това е същият ИД във всяко заявка, която правите.

Опитайте

Заменете всичко в квадратни скоби със собствени стойности, а ключовия заместващ символ – с ключ от вашето табло за управление.

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

Влязохте ли в профила си? API конзолата във вашето табло за управление попълва действителното идентификационно число на вашата организация и вашия собствен ключ и изпълнява заявката спрямо реалното API, за да можете да видите действителния отговор. Отворете този крайpoint в API конзолата

Детайли

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`.

Параметри

ИмеТипЗадължителноКакво представлява
cursor (query)stringНеOpaque cursor from a previous page's `page.next_cursor`.
limit (query)integerНеMaximum items to return (page size).
org_id (query)UuidНеRestrict to one organization in scope (default — the whole subtree).
action (query)stringНеFilter to one action code (e.g. `apikey.created`).
actor (query)stringНеFilter to one actor (e.g. `user:0190…` or `apikey:0190…`).
since (query)stringНеOnly entries at or after this ISO 8601 instant.

Отговор

ИмеТипЗадължителноКакво представлява
dataAuditEntry[]Да
pagePageMetaДа

Грешки, които този крайpoint може да върне

401 · 403 · 422 · 429