Récupérer des organisations

Découvrez comment récupérer des organisations à l’aide de l’Auth0 Dashboard et de la Management API.

Lorsque vous travaillez avec des organisations par programmation, vous pourriez avoir besoin de récupérer soit la liste de toutes les organisations, soit une organisation précise par son nom ou son ID.

La Management API doit être utilisée uniquement avec un client confidentiel. Son utilisation est soumise aux limites de débit de l’Auth0 Management API.

​

Récupérer les organisations du locataire

Vous pouvez récupérer toutes les organisations d’un locataire au moyen de la Management API.

Pour récupérer plus de 1 000 résultats, vous devez utiliser la méthode de pagination par point de contrôle. Pour en savoir plus, consultez le point de terminaison Get Organizations dans notre API Explorer.

Effectuez un appel GET au point de terminaison Get Organizations. Assurez-vous de remplacer la valeur fictive MGMT_API_ACCESS_TOKEN par votre Jeton d’accès de la Management API.

Trouvez votre domaine Auth0

Votre domaine Auth0 est composé du nom de votre locataire, de votre sous-domaine régional (à moins que votre locataire se trouve dans la région des États-Unis et ait été créé avant juin 2020), puis de .auth0.com. Par exemple, si le nom de votre locataire était travel0, votre domaine Auth0 serait travel0.us.auth0.com. (Si votre locataire se trouvait aux États-Unis et a été créé avant juin 2020, votre nom de domaine serait alors https://travel0.auth0.com.)

Si vous utilisez des domaines personnalisés, utilisez le nom de votre domaine personnalisé.

Valeur	Description
MGMT_API_ACCESS_TOKEN	Jeton d’accès de la Management API avec le scope read:organizations.

​

Codes d’état de la réponse

Les codes d’état de réponse possibles sont les suivants :

Code d’état	Code d’erreur	Message	Cause
200		Organisations récupérées avec succès.
400	invalid_paging	La page demandée dépasse la limite maximale autorisée de 1000 enregistrements.	L’API ne peut renvoyer qu’un maximum de 1000 enregistrements.
400	invalid_query_string	Chaîne de requête invalide dans la requête. Le message varie selon la cause.	La chaîne de requête n’est pas valide.
401		Jeton invalide.
401		Signature invalide reçue lors de la validation du JSON Web Token.
401		L’application n’est pas globale.
403	insufficient_scope	Scope insuffisant; l’un des scopes suivants est attendu : read:organizations.	Tentative de lire ou d’écrire un champ non autorisé avec les scopes fournis dans le Bearer Token.
429		Trop de requêtes. Vérifiez les en-têtes X-RateLimit-Limit, X-RateLimit-Remaining et X-RateLimit-Reset.

​

Récupérer une organisation à partir de son ID

Vous pouvez récupérer une organisation à partir de son ID au moyen de la Management API.

Effectuez une requête GET vers le point de terminaison Get Organization. Assurez-vous de remplacer les valeurs d’espace réservé ORG_ID et MGMT_API_ACCESS_TOKEN par l’ID de votre organisation et votre jeton d’accès de la Management API, respectivement.

Trouvez votre domaine Auth0

Votre domaine Auth0 se compose du nom de votre locataire, de votre sous-domaine régional (à moins que votre locataire se trouve dans la région des États-Unis et ait été créé avant juin 2020), puis de .auth0.com. Par exemple, si le nom de votre locataire était travel0, le nom de votre domaine Auth0 serait travel0.us.auth0.com. (Si votre locataire se trouvait aux États-Unis et avait été créé avant juin 2020, le nom de votre domaine serait alors https://travel0.auth0.com.)

Si vous utilisez des domaines personnalisés, il doit s’agir du nom de votre domaine personnalisé.

Valeur	Description
ORG_ID	ID de l’organisation que vous souhaitez récupérer.
MGMT_API_ACCESS_TOKEN	jeton d’accès de la Management API avec le scope read:organizations.

​

Codes d’état de la réponse

Les codes d’état de la réponse possibles sont les suivants :

Code de statut	Code d’erreur	Message	Cause
200		Organisation récupérée avec succès.
400	invalid_query_string	Chaîne de requête invalide dans la demande. Le message varie selon la cause.	La chaîne de requête n’est pas valide.
401		Jeton invalide.
401		Signature invalide reçue lors de la validation du JSON Web Token.
401		L’application n’est pas globale.
403	insufficient_scope	Scope insuffisant; l’un des scopes suivants est requis : read:organizations.	Tentative de lire ou d’écrire un champ qui n’est pas autorisé avec les scopes fournis par le Bearer Token.
429		Trop de requêtes. Vérifiez les en-têtes X-RateLimit-Limit, X-RateLimit-Remaining et X-RateLimit-Reset.

​

Récupérer une organisation par nom

Vous pouvez récupérer une organisation par son nom au moyen de la Management API.

Effectuez un appel GET au point de terminaison Get Organization by Name. Assurez-vous de remplacer les valeurs fictives ORG_NAME et MGMT_API_ACCESS_TOKEN par le nom de votre organisation et votre jeton d’accès de la Management API, respectivement.

Trouvez votre domaine Auth0

Si votre domaine Auth0 correspond au nom de votre locataire, il sera composé de votre sous-domaine régional (à moins que votre locataire se trouve dans la région des États-Unis et ait été créé avant juin 2020), suivi de .auth0.com. Par exemple, si le nom de votre locataire était travel0, votre domaine Auth0 serait travel0.us.auth0.com. (Si votre locataire se trouvait aux États-Unis et avait été créé avant juin 2020, votre nom de domaine serait alors https://travel0.auth0.com.)

Si vous utilisez des domaines personnalisés, il doit s’agir du nom de votre domaine personnalisé.

Valeur	Description
ORG_ NAME	Nom de l’organisation que vous souhaitez récupérer. Longueur maximale de 50 caractères.
MGMT_API_ACCESS_TOKEN	jeton d’accès de la Management API avec le scope read:organizations.

​

Codes d’état de la réponse

Les codes d’état de la réponse possibles sont les suivants :

Code d’état	Code d’erreur	Message	Cause
200		Organisations récupérées avec succès.
400	invalid_query_string	Chaîne de requête invalide. Le message varie selon la cause.	La chaîne de requête n’est pas valide.
401		Jeton non valide.
401		Signature invalide reçue lors de la validation du JSON Web Token.
401		L’application n’est pas globale.
403	insufficient_scope	scope insuffisant ; l’un des scopes suivants est attendu : read:organizations.	Tentative de lecture ou d’écriture d’un champ non autorisée avec les scopes fournis par le Bearer Token.
429		Trop de requêtes. Vérifiez les en-têtes X-RateLimit-Limit, X-RateLimit-Remaining et X-RateLimit-Reset.