access
GET /v1/orgs/{orgId}/delegated-access
Everybody this organisation has shared sites with, one row per person.
Аутентификација
Пошаљите API кључ као bearer токен. Кључ мора имати дозволу sites.collaborators.manage; кључ без ње се одбија уз 403, а не 404.
Где се уноси ID ваше организације
Ова крајња тачка узима ID ваше организације у самом URL-у, као orgId. Замените га у путањи — не постоји заглавље или параметар упита који могу послужити уместо тога.
Идентификатор ваше организације се налази на екрану са API кључевима на вашој контролној табли, поред самог кључа. То је исти идентификатор у сваком позиву који упутите.
Испробајте
Замените све што је у угластим заградама сопственим вредностима, а чувар места кључа кључем са своје контролне табле.
curl -X GET https://api.zinndigital.com/v1/orgs/{orgId}/delegated-access \
-H "Authorization: Bearer zdk_live_…"Пријављени сте? API конзола на вашој контролној табли попуњава ваш прави id организације и ваш сопствени кључ, и покреће захтев према живом API-ју како бисте могли да видите стварни одговор. Отворите ову крајњу тачку у API конзоли
Детаљи
Delegated access, seen from the person rather than from the site (W43-96, docs/736). One row per person — an address that has been invited and not yet accepted is a person too — with every site they hold, the role on each, and when they were invited, accepted and were last active. Paged over PEOPLE, keyset on the address, so a freelancer holding forty sites is one row and never split across a page boundary. Lapsed grants (past their end date, not revoked) are listed with status: expired; revoked ones are not — they are history, and a site's own collaborator list keeps them. last_active_at is the last request the person made while a grant was live, stamped at most every five minutes; null means they have not used the access since it shipped. Requires sites.collaborators.manage in the organisation. An organisation outside the caller's scope, and one they can see without that key, both answer 404.
Параметри
| Назив | Тип | Обавезно | Шта је ово |
|---|---|---|---|
orgId (path) | Uuid | Да | Organization ID (UUIDv7). |
cursor (query) | string | Не | Opaque cursor from a previous page's page.next_cursor. |
limit (query) | integer | Не | Maximum items to return (page size). |
Одговор
| Назив | Тип | Обавезно | Шта је ово |
|---|---|---|---|
data | DelegatedPerson[] | Да | — |
page | PageMeta | Да | — |
Грешке које ова крајња тачка може вратити
401 · 403 · 404 · 422 · 429