Přejít na obsah
Sursa Developers

GET/v1/groups

Vypsat skupiny organizace

list_groups

Bez kind vrací běžné skupiny, „All members“ a skupiny rolí. Osobní skupiny (single_user) se vracejí jen s explicitním kind=single_user. Členství ve skupinách all_members, role a single_user se počítá z uživatelů organizace, stejně jako jejich members_count.

Autentizace

Odešlete klíč API v hlavičce Authorization: Authorization: Bearer <klíč>.

Parametry dotazu

  • kindGroupKind
  • limitinteger

    Velikost stránky. Bez limit a cursor se vrací celý seznam; s ním nejvýše limit položek a další stránka je uvedena v hlavičkách Link (rel="next") a X-Next-Cursor.

    ≥ 1, ≤ 200

  • cursorstring

    Kurzor další stránky z X-Next-Cursor nebo z next_cursor předchozí odpovědi se stejnými filtry; nese i velikost stránky. Společně s offset: 422 validation.failed; kurzor jiného seznamu, jiných filtrů nebo poškozený kurzor: 400 api.cursor_invalid.

    length ≤ 512

  • updated_sincestring (date-time)

    Jen objekty s updated_at v tento okamžik nebo později (RFC 3339 s časovým posunem), pro synchronizaci. S tímto parametrem je seznam seřazen podle updated_at vzestupně, poté podle id, a kurzor pokračuje v tomto pořadí. Smazané objekty se nevypisují: smazání přicházejí jako události.

    length ≤ 512

Odpovědi

200Úspěšná odpověď

Hlavičky odpovědi

  • Link

    Adresa další stránky, <…>; rel="next". Chybí-li hlavička, jde o poslední stránku.

  • X-Next-Cursor

    Kurzor další stránky pro parametr cursor. Chybí-li hlavička, jde o poslední stránku.

  • RateLimit-Policy

    Platné limity ve formátu návrhu IETF draft-ietf-httpapi-ratelimit-headers: položky oddělené čárkou "<name>";q=<quota>;w=<window in seconds>. key je četnost požadavků klíče API (kvóta je nárazová špička, okno je doba jejího úplného obnovení; pro relaci je to user, bez přihlašovacích údajů ip); minute, day a month jsou kvóty organizace na kalendářní minutu, den a měsíc v UTC.

  • RateLimit

    Kolik zbývá z každého limitu v RateLimit-Policy: "<name>";r=<remaining>;t=<seconds until reset>.

  • X-RateLimit-Limit

    Limit nejpřísnější položky v RateLimit-Policy (té, ve které zbývá nejméně požadavků).

  • X-RateLimit-Remaining

    Počet požadavků, které zbývají v rámci nejpřísnějšího limitu.

  • X-RateLimit-Reset

    Počet sekund do obnovení nejpřísnějšího limitu.

application/json

Objekt: GroupList

array of Group
  • idintegerpovinné
  • org_idintegerpovinné
  • keystringpovinné

    Stálý klíč: all, role:<role>, user:<id> nebo klíč běžné skupiny. Rozhraní překládá vestavěné skupiny podle klíče.

  • titlestringpovinné
  • kindGroupKindpovinné
  • user_idinteger | nullpovinné

    Jen osobní skupiny.

  • role_keyRole | nullpovinné

    Jen skupiny rolí.

  • managed_byGroupManagedBypovinné
  • members_countintegerpovinné

    Počet aktivních členů. Deaktivovaní uživatelé nejsou členy skupin.

  • disabledbooleanpovinné

    Osobní skupina deaktivovaného uživatele: její přiřazení se zachovávají, ale dokud je uživatel neaktivní, nemají účinek. false u všech ostatních skupin.

  • created_atstring (date-time)povinné
  • updated_atstring (date-time)povinné
401Nebyly odeslány žádné přihlašovací údaje (ani cookie relace, ani klíč API), nebo klíč nebyl nalezen.

Hlavičky odpovědi

  • RateLimit-Policy

    Platné limity ve formátu návrhu IETF draft-ietf-httpapi-ratelimit-headers: položky oddělené čárkou "<name>";q=<quota>;w=<window in seconds>. key je četnost požadavků klíče API (kvóta je nárazová špička, okno je doba jejího úplného obnovení; pro relaci je to user, bez přihlašovacích údajů ip); minute, day a month jsou kvóty organizace na kalendářní minutu, den a měsíc v UTC.

  • RateLimit

    Kolik zbývá z každého limitu v RateLimit-Policy: "<name>";r=<remaining>;t=<seconds until reset>.

  • X-RateLimit-Limit

    Limit nejpřísnější položky v RateLimit-Policy (té, ve které zbývá nejméně požadavků).

  • X-RateLimit-Remaining

    Počet požadavků, které zbývají v rámci nejpřísnějšího limitu.

  • X-RateLimit-Reset

    Počet sekund do obnovení nejpřísnějšího limitu.

application/json

Objekt: Error

422Chyba validace: tělo nebo parametry neodpovídají schématu (`detail` je seznam chyb validace), nebo je hodnota parametru mimo povolený rozsah (`detail` je zpráva).

Hlavičky odpovědi

  • RateLimit-Policy

    Platné limity ve formátu návrhu IETF draft-ietf-httpapi-ratelimit-headers: položky oddělené čárkou "<name>";q=<quota>;w=<window in seconds>. key je četnost požadavků klíče API (kvóta je nárazová špička, okno je doba jejího úplného obnovení; pro relaci je to user, bez přihlašovacích údajů ip); minute, day a month jsou kvóty organizace na kalendářní minutu, den a měsíc v UTC.

  • RateLimit

    Kolik zbývá z každého limitu v RateLimit-Policy: "<name>";r=<remaining>;t=<seconds until reset>.

  • X-RateLimit-Limit

    Limit nejpřísnější položky v RateLimit-Policy (té, ve které zbývá nejméně požadavků).

  • X-RateLimit-Remaining

    Počet požadavků, které zbývají v rámci nejpřísnějšího limitu.

  • X-RateLimit-Reset

    Počet sekund do obnovení nejpřísnějšího limitu.

application/json

Objekt: Error

429Příliš mnoho požadavků (`api.rate_limited`), kvóta organizace na minutu, den nebo měsíc je vyčerpána (`api.quota_exceeded`; `error.details` obsahuje `quota`, `limit` a `reset_at`), organizace dosáhla svého limitu nebo je služba odpovědí vytížená (`answers.engine_busy`). Počkejte dobu uvedenou v hlavičce `Retry-After`.

Hlavičky odpovědi

  • Retry-After

    Počet sekund, které je třeba počkat před opakováním požadavku.

  • RateLimit-Policy

    Platné limity ve formátu návrhu IETF draft-ietf-httpapi-ratelimit-headers: položky oddělené čárkou "<name>";q=<quota>;w=<window in seconds>. key je četnost požadavků klíče API (kvóta je nárazová špička, okno je doba jejího úplného obnovení; pro relaci je to user, bez přihlašovacích údajů ip); minute, day a month jsou kvóty organizace na kalendářní minutu, den a měsíc v UTC.

  • RateLimit

    Kolik zbývá z každého limitu v RateLimit-Policy: "<name>";r=<remaining>;t=<seconds until reset>.

  • X-RateLimit-Limit

    Limit nejpřísnější položky v RateLimit-Policy (té, ve které zbývá nejméně požadavků).

  • X-RateLimit-Remaining

    Počet požadavků, které zbývají v rámci nejpřísnějšího limitu.

  • X-RateLimit-Reset

    Počet sekund do obnovení nejpřísnějšího limitu.

application/json

Objekt: Error

Chybové kódy

Kódy, které tato operace může vrátit v error.code, kromě obecných kódů každého požadavku.

Limity četnosti

Odpovědi obsahují hlavičky RateLimit a RateLimit-Policy a starší X-RateLimit-Limit, X-RateLimit-Remaining a X-RateLimit-Reset. Odpověď 429 má hlavičku Retry-After v sekundách: počkejte a požadavek zopakujte.

← groups · Reference API