Récupérer des Organizations

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

Lorsque vous travaillez avec des organisations par programmation, vous devrez peut-être récupérer soit la liste complète des organisations, soit une organisation précise par son nom ou son ID.

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

​

Récupérer les organisations du tenant

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

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

Effectuez une requête GET vers le point de terminaison Get Organizations. Assurez-vous de remplacer la valeur de l’espace réservé MGMT_API_ACCESS_TOKEN par votre jeton d’accès pour la Management API.

Trouvez votre domaine Auth0

Votre domaine Auth0 est composé du nom de votre tenant, de votre sous-domaine régional (à moins que votre tenant soit 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 tenant était travel0, votre domaine Auth0 serait travel0.us.auth0.com. (Si votre tenant 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 de votre nom de domaine personnalisé.

Valeur	Description
MGMT_API_ACCESS_TOKEN	Jeton d’accès pour la Management API avec la portée read:organizations.

​

Codes d’état de réponse

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

Code d’état	Code d’erreur	Message	Cause
200		Organizations récupérées.
400	invalid_paging	La page demandée dépasse le maximum autorisé de 1000 enregistrements.	L’API a été limitée à un maximum de 1000 enregistrements retourné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 invalide.
401		Signature invalide reçue pour la validation du JSON Web Token.
401		Le client n’est pas global.
403	insufficient_scope	Portée insuffisante; l’une des portées suivantes est attendue : read:organizations.	Tentative de lire ou d’écrire un champ non autorisé avec les portées du jeton porteur fourni.
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 ID

Vous pouvez récupérer une organisation par son ID à l’aide de la Management API.

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

Trouvez votre domaine Auth0

Si votre domaine Auth0 correspond au nom de votre tenant, à votre sous-domaine régional (sauf si votre tenant se trouve dans la région des États-Unis et a été créé avant juin 2020), puis à .auth0.com. Par exemple, si le nom de votre tenant était travel0, votre domaine Auth0 serait travel0.us.auth0.com. (Si votre tenant 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 de votre nom de domaine personnalisé.

Valeur	Description
ORG_ID	ID de l’organisation que vous voulez récupérer.
MGMT_API_ACCESS_TOKEN	Jeton d’accès pour la Management API avec la portée 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		Organisation récupérée 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 invalide.
401		Signature invalide reçue lors de la validation du JSON Web Token.
401		Le client n’est pas global.
403	insufficient_scope	Portée insuffisante ; l’une des portées suivantes est attendue : read:organizations.	Tentative de lecture ou d’écriture d’un champ non autorisé avec les portées du bearer token fourni.
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 son nom

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

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

Trouvez votre domaine Auth0

Votre domaine Auth0 correspond au nom de votre tenant, à votre sous-domaine régional (sauf si votre tenant se trouve dans la région US et a été créé avant juin 2020), puis à .auth0.com. Par exemple, si le nom de votre tenant était travel0, votre domaine Auth0 serait travel0.us.auth0.com. (Si votre tenant se trouvait aux États-Unis et avait été créé avant juin 2020, votre domaine serait alors https://travel0.auth0.com.)

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

Valeur	Description
ORG_ NAME	Nom de l’organisation que vous voulez récupérer. Longueur maximale de 50 caractères.
MGMT_API_ACCESS_TOKEN	Jeton d’accès pour la Management API avec la portée 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		Organizations récupérées avec succès.
400	invalid_query_string	Chaîne de requête non valide. Le message varie selon la cause.	La chaîne de requête n’est pas valide.
401		Token non valide.
401		Signature non valide reçue lors de la validation du JSON Web Token.
401		Le client n’est pas global.
403	insufficient_scope	Portée insuffisante; une des portées suivantes était attendue : read:organizations.	Tentative de lecture ou d’écriture d’un champ non autorisée avec les portées du bearer token fourni.
429		Trop de requêtes. Vérifiez les headers X-RateLimit-Limit, X-RateLimit-Remaining et X-RateLimit-Reset.