Hopp til innholdet
Sursa Developers

GET/v1/groups

Vis gruppene i organisasjonen

list_groups

Uten kind returneres vanlige grupper, «All members» og rollegrupper. Personlige grupper (single_user) returneres bare med eksplisitt kind=single_user. Medlemskapet i gruppene all_members, role og single_user beregnes fra organisasjonens brukere, og det samme gjelder members_count for dem.

Autentisering

Send en API-nøkkel i headeren Authorization: Authorization: Bearer <nøkkel>.

Spørringsparametere

  • kindGroupKind
  • limitinteger

    Sidestørrelse. Uten limit og cursor returneres hele listen; med den høyst limit elementer, og neste side oppgis i headerne Link (rel="next") og X-Next-Cursor.

    ≥ 1, ≤ 200

  • cursorstring

    Cursor for neste side fra X-Next-Cursor eller next_cursor i forrige svar med de samme filtrene; den inneholder sidestørrelsen. Sammen med offset: 422 validation.failed; en cursor fra en annen liste, med andre filtre eller i feil format: 400 api.cursor_invalid.

    length ≤ 512

  • updated_sincestring (date-time)

    Bare objekter med updated_at på eller etter dette tidspunktet (RFC 3339 med tidssoneforskyvning), for synkronisering. Med denne parameteren sorteres listen etter updated_at stigende, deretter etter id, og cursoren fortsetter i den rekkefølgen. Slettede objekter vises ikke i listen: slettinger kommer som hendelser.

    length ≤ 512

Svar

200Vellykket svar

Headere i svaret

  • Link

    Adressen til neste side, <…>; rel="next". Ingen header betyr at dette er siste side.

  • X-Next-Cursor

    Cursor for neste side til parameteren cursor. Ingen header betyr at dette er siste side.

  • RateLimit-Policy

    Gjeldende grenser i formatet fra IETF-utkastet draft-ietf-httpapi-ratelimit-headers: kommaseparerte elementer "<name>";q=<quota>;w=<window in seconds>. key er forespørselsraten til API-nøkkelen (kvoten er burst, tidsvinduet er tiden det tar å fylle den helt opp igjen; for en økt er det user, uten påloggingsinformasjon ip); minute, day og month er organisasjonens kvoter for kalenderminuttet, kalenderdøgnet og kalendermåneden i UTC.

  • RateLimit

    Hva som gjenstår av hver grense i RateLimit-Policy: "<name>";r=<remaining>;t=<seconds until reset>.

  • X-RateLimit-Limit

    Grensen for den strengeste oppføringen i RateLimit-Policy (den med færrest gjenværende forespørsler).

  • X-RateLimit-Remaining

    Gjenværende forespørsler under den strengeste grensen.

  • X-RateLimit-Reset

    Sekunder til den strengeste grensen nullstilles.

application/json

Objekt: GroupList

array of Group
  • idintegerobligatorisk
  • org_idintegerobligatorisk
  • keystringobligatorisk

    Stabil nøkkel: all, role:<role>, user:<id> eller nøkkelen til en vanlig gruppe. Grensesnittet oversetter innebygde grupper etter nøkkel.

  • titlestringobligatorisk
  • kindGroupKindobligatorisk
  • user_idinteger | nullobligatorisk

    Bare personlige grupper.

  • role_keyRole | nullobligatorisk

    Bare rollegrupper.

  • managed_byGroupManagedByobligatorisk
  • members_countintegerobligatorisk

    Antall aktive medlemmer. Deaktiverte brukere er ikke medlemmer av grupper.

  • disabledbooleanobligatorisk

    Den personlige gruppen til en deaktivert bruker: tildelingene beholdes, men har ingen virkning så lenge brukeren er inaktiv. false for alle andre grupper.

  • created_atstring (date-time)obligatorisk
  • updated_atstring (date-time)obligatorisk
401Ingen påloggingsinformasjon ble sendt (verken øktinformasjonskapsel eller API-nøkkel), eller nøkkelen ble ikke funnet.

Headere i svaret

  • RateLimit-Policy

    Gjeldende grenser i formatet fra IETF-utkastet draft-ietf-httpapi-ratelimit-headers: kommaseparerte elementer "<name>";q=<quota>;w=<window in seconds>. key er forespørselsraten til API-nøkkelen (kvoten er burst, tidsvinduet er tiden det tar å fylle den helt opp igjen; for en økt er det user, uten påloggingsinformasjon ip); minute, day og month er organisasjonens kvoter for kalenderminuttet, kalenderdøgnet og kalendermåneden i UTC.

  • RateLimit

    Hva som gjenstår av hver grense i RateLimit-Policy: "<name>";r=<remaining>;t=<seconds until reset>.

  • X-RateLimit-Limit

    Grensen for den strengeste oppføringen i RateLimit-Policy (den med færrest gjenværende forespørsler).

  • X-RateLimit-Remaining

    Gjenværende forespørsler under den strengeste grensen.

  • X-RateLimit-Reset

    Sekunder til den strengeste grensen nullstilles.

application/json

Objekt: Error

422Valideringsfeil: brødteksten eller parameterne samsvarer ikke med skjemaet (`detail` er en liste over valideringsfeil), eller en parameterverdi er utenfor tillatt område (`detail` er en melding).

Headere i svaret

  • RateLimit-Policy

    Gjeldende grenser i formatet fra IETF-utkastet draft-ietf-httpapi-ratelimit-headers: kommaseparerte elementer "<name>";q=<quota>;w=<window in seconds>. key er forespørselsraten til API-nøkkelen (kvoten er burst, tidsvinduet er tiden det tar å fylle den helt opp igjen; for en økt er det user, uten påloggingsinformasjon ip); minute, day og month er organisasjonens kvoter for kalenderminuttet, kalenderdøgnet og kalendermåneden i UTC.

  • RateLimit

    Hva som gjenstår av hver grense i RateLimit-Policy: "<name>";r=<remaining>;t=<seconds until reset>.

  • X-RateLimit-Limit

    Grensen for den strengeste oppføringen i RateLimit-Policy (den med færrest gjenværende forespørsler).

  • X-RateLimit-Remaining

    Gjenværende forespørsler under den strengeste grensen.

  • X-RateLimit-Reset

    Sekunder til den strengeste grensen nullstilles.

application/json

Objekt: Error

429For mange forespørsler (`api.rate_limited`), organisasjonens kvote for minuttet, døgnet eller måneden er brukt opp (`api.quota_exceeded`; `error.details` inneholder `quota`, `limit` og `reset_at`), organisasjonens grense er nådd, eller svartjenesten er opptatt (`answers.engine_busy`). Vent så lenge som headeren `Retry-After` angir.

Headere i svaret

  • Retry-After

    Antall sekunder du skal vente før du prøver forespørselen på nytt.

  • RateLimit-Policy

    Gjeldende grenser i formatet fra IETF-utkastet draft-ietf-httpapi-ratelimit-headers: kommaseparerte elementer "<name>";q=<quota>;w=<window in seconds>. key er forespørselsraten til API-nøkkelen (kvoten er burst, tidsvinduet er tiden det tar å fylle den helt opp igjen; for en økt er det user, uten påloggingsinformasjon ip); minute, day og month er organisasjonens kvoter for kalenderminuttet, kalenderdøgnet og kalendermåneden i UTC.

  • RateLimit

    Hva som gjenstår av hver grense i RateLimit-Policy: "<name>";r=<remaining>;t=<seconds until reset>.

  • X-RateLimit-Limit

    Grensen for den strengeste oppføringen i RateLimit-Policy (den med færrest gjenværende forespørsler).

  • X-RateLimit-Remaining

    Gjenværende forespørsler under den strengeste grensen.

  • X-RateLimit-Reset

    Sekunder til den strengeste grensen nullstilles.

application/json

Objekt: Error

Feilkoder

Kodene denne operasjonen kan returnere i error.code, i tillegg til de generelle kodene for alle forespørsler.

Hastighetsgrenser

Svarene har headerne RateLimit og RateLimit-Policy og de eldre X-RateLimit-Limit, X-RateLimit-Remaining og X-RateLimit-Reset. Et 429-svar har Retry-After i sekunder: Vent, og prøv på nytt.

← groups · API-referanse