audit

GET `/v1/audit`

Read the organization's audit log.

Аутентификација

Пошаљите API кључ као bearer токен. Кључ мора имати дозволу audit.read; кључ без ње се одбија уз 403, а не 404.

Где се уноси ID ваше организације

Ова крајња тачка прихвата org_id као параметар упита. Изоставите га и позив ће обухватити цело подстабло вашег закупа; пошаљите га да бисте сузили позив на једну организацију.

Идентификатор ваше организације се налази на екрану са API кључевима на вашој контролној табли, поред самог кључа. То је исти идентификатор у сваком позиву који упутите.

Испробајте

Замените све што је у угластим заградама сопственим вредностима, а чувар места кључа кључем са своје контролне табле.

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

Пријављени сте? API конзола на вашој контролној табли попуњава ваш прави id организације и ваш сопствени кључ, и покреће захтев према живом API-ју како бисте могли да видите стварни одговор. Отворите ову крајњу тачку у 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. An undeclared query parameter is refused with 422, never ignored. A filter this endpoint does not read used to answer 200 with the whole log, which is indistinguishable from a real answer and reads as "there is a lot of history here" rather than "the filter was dropped" (D26500). Every parameter below is 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…`).
`target (query)`	`string`	Не	Filter to one acted-on object — the exact `target` a row carries (a hostname, a site id, a deploy sha). Exact match, never a prefix: a substring match would make `site-1`…
`since (query)`	`string`	Не	Only entries at or after this ISO 8601 instant (inclusive).
`until (query)`	`string`	Не	Only entries at or before this ISO 8601 instant (inclusive), so `since` and `until` together bound an incident window. `since == until` selects that instant rather than nothing.

Одговор

Назив	Тип	Обавезно	Шта је ово
`data`	`AuditEntry[]`	Да	—
`page`	`PageMeta`	Да	—

Грешке које ова крајња тачка може вратити

401 · 403 · 422 · 429

GET /v1/audit