Obtenir les membres de l’organisation
Liste des membres de l’organisation. Ce endpoint est soumis à une cohérence éventuelle. Il se peut que les nouveaux utilisateurs ne soient pas immédiatement inclus dans la réponse et que les utilisateurs supprimés n’en soient pas immédiatement retirés.
- Utilisez le paramètre
fieldspour définir, au besoin, les détails précis des membres à récupérer. Sifieldsest laissé vide, tous les champs (sauf les rôles) sont renvoyés. - Les rôles des membres ne sont pas envoyés par défaut. Utilisez
fields=rolespour récupérer les rôles attribués à chaque membre répertorié. Pour utiliser ce paramètre, vous devez inclure la portéeread:organization_member_rolesdans le token. Seuls les rôles directement attribués sont renvoyés. Pour inclure également les attributions de rôles basées sur les groupes, utilisezGET /api/v2/organizations/{id}/members/{user_id}/effective-roles.
Ce endpoint prend en charge deux types de pagination :
- Pagination par offset
- Pagination par checkpoint
La pagination par checkpoint doit être utilisée si vous devez récupérer plus de 1 000 membres de l’organisation.
Pagination par checkpoint
Pour effectuer une recherche par checkpoint, utilisez les paramètres suivants : - from : ID facultatif à partir duquel commencer la sélection. - take : Nombre total d’entrées à récupérer lorsque le paramètre from est utilisé. La valeur par défaut est 50. Remarque : la première fois que vous appelez ce endpoint à l’aide de la pagination par checkpoint, vous devez omettre le paramètre from. S’il y a d’autres résultats, une valeur next sera incluse dans la réponse. Vous pouvez l’utiliser pour les appels d’API suivants. Lorsque next n’est plus inclus dans la réponse, cela indique qu’il ne reste plus de pages.
Autorisations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Paramètres de chemin
Identifiant de l’organisation.
50Paramètres de requête
Index de la page de résultats à renvoyer. La première page est 0.
0 <= x <= 1000Nombre de résultats par page. La valeur par défaut est 50.
1 <= x <= 100Renvoyer les résultats dans un objet contenant le nombre total de résultats (true) ou sous forme de array directe de résultats (false, par défaut).
ID facultatif à partir duquel commencer la sélection.
Nombre de résultats par page. La valeur par défaut est 50.
1 <= x <= 100Liste de champs séparés par des virgules à inclure ou à exclure (selon la valeur fournie pour include_fields) dans le résultat. Laissez vide pour récupérer tous les champs.
Indique si les champs précisés doivent être inclus (true) ou exclus (false).
Réponse
Membres récupérés avec succès.