Récupérer des Organisations

Apprenez à récupérer des Organisations en utilisant l’Auth0 Dashboard et Management API.

Lorsque vous travaillez avec organizations de manière programmatique, vous pouvez avoir besoin de récupérer soit une liste de toutes les organisations, soit des organisations individuellement par nom ou par ID.

Vous ne devez accéder à Management API qu’à l’aide d’un client confidentiel. Son utilisation est soumise aux limites anti-attaques de Management API Auth0.

​

Récupérer les organisations d’un locataire

Vous pouvez récupérer toutes les organisations d’un locataire via Management API.

Pour récupérer plus de 1000 résultats, vous devez utiliser la méthode de pagination par points de contrôle. Pour en savoir plus, consultez Obtenir le point de terminaison de l’organisation dans notre API Explorer.

Effectuez un appel GET au point de terminaisonGet Organizations. Veillez à remplacer la valeur de remplacement MGMT_API_ACCESS_TOKEN par votre jeton d’accès au Management API.

cURL

curl --request GET \
  --url 'https://{yourDomain}/api/v2/organizations' \
  --header 'authorization: Bearer MGMT_API_ACCESS_TOKEN'

Trouvez votre domaine Auth0

Si votre domaine Auth0 est le nom de votre locataire, votre sous-domaine régional (sauf si votre locataire se trouve aux États-Unis et a été créé avant juin 2020), est .auth0.com. Par exemple, si votre nom de locataire est travel0, votre nom de domaine Auth0 sera travel0.us.auth0.com. (Si votre locataire est aux États-Unis et qu’il a été créé avant juin 2020, votre nom de domaine Auth0 sera https://travel0.auth0.com.)

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

Valeur	Description
MGMT_API_ACCESS_TOKEN	Jeton d’accès à Management API avec la permission read:organizations.

​

Codes d’état des réponses

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 le maximum autorisé de 1000 enregistrements.	L’API a été limitée à ne renvoyer qu’un maximum de 1000 enregistrements.
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		Jeton non valide.
401		Signature non valide reçue pour la validation du jeton Web JSON.
401		Le client n’est pas global.
403	insufficient_scope	Permission insuffisante; permission attendue : read:organizations.	Tentative de lire/écrire un champ qui n’est pas autorisé avec les permissions de jeton du 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 son ID

Vous pouvez récupérer une organisation par son identifiant via Management API.

Effectuez un appel GET au point de terminaisonGet Organization. Veillez à remplacer les valeurs de remplacement ORG_ID et MGMT_API_ACCESS_TOKEN par l’identifiant de votre organisation et le jeton d’accès à Management API, respectivement.

cURL

curl --request GET \
  --url 'https://{yourDomain}/api/v2/organizations/ORG_ID' \
  --header 'authorization: Bearer MGMT_API_ACCESS_TOKEN'

Trouvez votre domaine Auth0

Si votre domaine Auth0 est le nom de votre locataire, votre sous-domaine régional (sauf si votre locataire se trouve aux États-Unis et a été créé avant juin 2020), est .auth0.com. Par exemple, si votre nom de locataire est travel0, votre nom de domaine Auth0 sera travel0.us.auth0.com. (Si votre locataire est aux États-Unis et qu’il a été créé avant juin 2020, votre nom de domaine Auth0 sera https://travel0.auth0.com.)

Si vous utilisez des domaines personnalisés, votre domaine est le 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 à Management API avec la permission read:organizations.

​

Codes d’état des réponses

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 de demande non valide. Le message variera en fonction de la cause.	La chaîne de requête n’est pas valide.
401		Jeton non valide.
401		Signature non valide reçue pour la validation du jeton Web JSON.
401		Le client n’est pas global.
403	insufficient_scope	Permission insuffisante; on s’attend à l’un des éléments suivants : read:organizations.	Tentative de lire/écrire un champ qui n’est pas autorisé avec les permissions de jeton du 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 son nom

Vous pouvez récupérer une organisation par son nom via Management API.

Effectuez un appel GET au point de terminaisonGet Organization by Name. Veillez à remplacer les valeurs fictives ORG_NAME et MGMT_API_ACCESS_TOKEN par l’identifiant de votre organisation et le jeton d’accès à Management API, respectivement.

cURL

curl --request GET \
  --url 'https://{yourDomain}/api/v2/organizations/name/ORG_NAME' \
  --header 'authorization: Bearer MGMT_API_ACCESS_TOKEN'

Trouvez votre domaine Auth0

Si votre domaine Auth0 est le nom de votre locataire, votre sous-domaine régional (sauf si votre locataire se trouve aux États-Unis et a été créé avant juin 2020), est .auth0.com. Par exemple, si votre nom de locataire est travel0, votre nom de domaine Auth0 sera travel0.us.auth0.com. (Si votre locataire est aux États-Unis et qu’il a été créé avant juin 2020, votre nom de domaine Auth0 sera https://travel0.auth0.com.)

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

Valeur	Description
ORG_ NAME	Nom de l’organisation à récupérer. Longueur maximum : 50 caractères.
MGMT_API_ACCESS_TOKEN	Jeton d’accès à Management API avec la permission read:organizations.

​

Codes d’état des réponses

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_query_string	Chaîne de requête de demande non valide. Le message variera en fonction de la cause.	La chaîne de requête n’est pas valide.
401		Jeton non valide.
401		Signature non valide reçue pour la validation du jeton Web JSON.
401		Le client n’est pas global.
403	insufficient_scope	Permission insuffisante; on s’attend à l’un des éléments suivants : read:organizations.	Tentative de lire/écrire un champ qui n’est pas autorisé avec les permissions de jeton du porteur fourni.
429		Trop de requêtes. Vérifiez les en-têtes X-RateLimit-Limit, X-RateLimit-Remaining et X-RateLimit-Reset.