access

GET /v1/sites/{siteId}/collaborators

Who this site is shared with.

Усі кінцеві точки access

Уся документація для розробників

Автентифікація

Надішліть ключ API як маркер носія (bearer token). Ця кінцева точка не вказує конкретного дозволу в специфікації, тому надайте своєму ключу мінімально необхідні права та перевірте відповідь, замість того щоб припускати.

Цей кінцевий пункт не потребує ідентифікатора організації. Ваш ключ уже ідентифікує організацію, якій він належить, і відповідь обмежується її межами.

Спробувати

Замініть усе в кутових дужках власними значеннями, а заповнювач ключа — ключем із вашої панелі керування.

curl -X GET https://api.zinndigital.com/v1/sites/{siteId}/collaborators \
  -H "Authorization: Bearer zdk_live_…"

Увійшли в систему? Консоль API у вашій панелі керування автоматично підставляє ваш реальний ідентифікатор організації та ваш власний ключ, а також виконує запит до робочого API, щоб ви могли побачити справжню відповідь. Відкрийте цю кінцеву точку в консолі API

Деталі

Per-site collaborators — one person's access to ONE site, rather than to the whole organisation. Every grant on this site, newest first, live and lapsed alike: a revoked grant is kept because "who could reach this site in March" is the question an incident asks, and a deleted row cannot answer it. ⛔ Read and write share the sites.collaborators.manage permission. The list is the access-control state of the site — who else is in it, at what level, and why — and that is an account owner's business rather than a developer's. Among the customer roles only owner holds the key; dev deliberately does not, because a developer who could grant site access could grant it to themselves on a site they were never given. A site outside the caller's scope, and a site they can see but may not administer, both answer 404. Same code, two reasons: a 403 on the second would tell a developer that a collaborator list exists on their client's site, and a 403 on the first is an existence oracle.

Параметри

НазваТипОбов'язковеЩо це таке
siteId (path)UuidТакSite ID (UUIDv7).
cursor (query)stringНіOpaque cursor from a previous page's page.next_cursor.
limit (query)integerНіMaximum items to return (page size).

Відповідь

НазваТипОбов'язковеЩо це таке
dataSiteCollaborator[]Так
pagePageMetaТак

Помилки, які може повертати ця кінцева точка

401 · 403 · 404 · 429