access
GET /v1/sites/{siteId}/collaborators
Who this site is shared with.
Kimlik Doğrulama
Bir API anahtarını bearer token olarak gönderin. Bu uç nokta, teknik özelliklerde belirli bir yetki belirtmemektedir; bu nedenle, varsaymak yerine anahtarınıza ihtiyaç duyduğu en az yetkiyi verin ve yanıtı kontrol edin.
Bu uç nokta hiçbir organizasyon kimliği almaz. Anahtarınız zaten ait olduğu organizasyonu tanımlar ve yanıt bu organizasyonla sınırlandırılır.
Dene
Köşeli parantez içindeki her şeyi kendi değerlerinizle ve anahtar yer tutucusunu panonuzdan bir anahtarla değiştirin.
curl -X GET https://api.zinndigital.com/v1/sites/{siteId}/collaborators \
-H "Authorization: Bearer zdk_live_…"Oturum açtınız mı? Panonuzdaki API konsolu, gerçek organizasyon kimliğinizi ve kendi anahtarınızı otomatik olarak doldurur ve isteği canlı API üzerinde çalıştırarak gerçek yanıtı görmenizi sağlar. Bu uç noktayı API konsolunda açın
Ayrıntılar
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.
Parametreler
| Ad | Tür | Zorunlu | Ne olduğu |
|---|---|---|---|
siteId (path) | Uuid | Evet | Site ID (UUIDv7). |
cursor (query) | string | Hayır | Opaque cursor from a previous page's page.next_cursor. |
limit (query) | integer | Hayır | Maximum items to return (page size). |
Yanıt
| Ad | Tür | Zorunlu | Ne olduğu |
|---|---|---|---|
data | SiteCollaborator[] | Evet | — |
page | PageMeta | Evet | — |
Bu uç noktanın dönderebileceği hatalar
401 · 403 · 404 · 429