Obtener organizaciones

Aprenda a obtener las organizaciones mediante el Auth0 Dashboard y la Management API.

Al trabajar con organizaciones de forma programática, puede que necesite obtener una lista de todas las organizaciones o una organización individual por nombre o ID.

Solo debe accederse a la Management API mediante un cliente confidencial. Su uso está sujeto a los límites de frecuencia de Auth0 Management API.

​

Obtener las organizaciones del inquilino

Puede obtener todas las organizaciones de un inquilino mediante la Management API.

Para obtener más de 1000 resultados, debe usar el método de paginación por checkpoint. Para obtener más información, consulte el endpoint Get Organizations en nuestro API Explorer.

Haga una solicitud GET al endpoint Get Organizations. Asegúrese de reemplazar el valor del marcador de posición MGMT_API_ACCESS_TOKEN por su Token de acceso de la Management API.

Busque su dominio de Auth0

Su dominio de Auth0 se compone del nombre de su inquilino, su subdominio regional (a menos que su inquilino esté en la región de EE. UU. y se haya creado antes de junio de 2020) y .auth0.com. Por ejemplo, si el nombre de su inquilino fuera travel0, el nombre de su dominio de Auth0 sería travel0.us.auth0.com. (Si su inquilino estuviera en EE. UU. y se hubiera creado antes de junio de 2020, entonces el nombre de su dominio sería https://travel0.auth0.com).

Si usa dominios personalizados, este debe ser el nombre de su dominio personalizado.

Valor	Descripción
MGMT_API_ACCESS_TOKEN	Token de acceso para la Management API con el scope read:organizations.

​

Códigos de estado de respuesta

Los posibles códigos de estado de respuesta son los siguientes:

Código de estado	Código de error	Message	Causa
200		Organizaciones recuperadas correctamente.
400	invalid_paging	La página solicitada supera el máximo permitido de 1000 registros.	La API está limitada a devolver solo hasta 1000 registros.
400	invalid_query_string	La cadena de consulta de la solicitud no es válida. El mensaje variará según la causa.	La cadena de consulta no es válida.
401		Token no válido.
401		Se recibió una firma no válida para la validación del JSON Web Token.
401		El cliente no es global.
403	insufficient_scope	Scope insuficiente; se esperaba alguno de los siguientes: read:organizations.	Se intentó leer o escribir un campo no permitido con los alcances del Bearer Token proporcionado.
429		Demasiadas solicitudes. Revise los encabezados X-RateLimit-Limit, X-RateLimit-Remaining y X-RateLimit-Reset.

​

Recuperar una organización por ID

Puede recuperar una organización por su ID mediante la Management API.

Haga una solicitud GET al endpoint Get Organization. Asegúrese de reemplazar los valores de marcador de posición ORG_ID y MGMT_API_ACCESS_TOKEN por el ID de su organización y su token de acceso de la Management API, respectivamente.

Encuentre su dominio de Auth0

Su dominio de Auth0 se compone del nombre de su inquilino, su subdominio regional (a menos que su inquilino esté en la región de EE. UU. y se haya creado antes de junio de 2020) y .auth0.com. Por ejemplo, si el nombre de su inquilino fuera travel0, el nombre de su dominio de Auth0 sería travel0.us.auth0.com. (Si su inquilino estuviera en EE. UU. y se hubiera creado antes de junio de 2020, entonces el nombre de su dominio sería https://travel0.auth0.com.)

Si usa dominios personalizados, este debe ser el nombre de su dominio personalizado.

Valor	Descripción
ORG_ID	ID de la organización que desea recuperar.
MGMT_API_ACCESS_TOKEN	Token de acceso para la Management API con el scope read:organizations.

​

Códigos de estado de respuesta

Los posibles códigos de estado de respuesta son los siguientes:

Código de estado	Código de error	Message	Causa
200		Organización obtenida correctamente.
400	invalid_query_string	Cadena de consulta de la solicitud no válida. El mensaje variará según la causa.	La cadena de consulta no es válida.
401		Token no válido.
401		Se recibió una firma no válida para la validación del JSON Web Token.
401		El cliente no es global.
403	insufficient_scope	Scope insuficiente; se esperaba alguno de los siguientes: read:organizations.	Se intentó leer o escribir un campo que no está permitido con los scopes del Bearer Token proporcionado.
429		Demasiadas solicitudes. Revise los encabezados X-RateLimit-Limit, X-RateLimit-Remaining y X-RateLimit-Reset.

​

Recuperar una organización por nombre

Puede recuperar una organización por su nombre mediante la Management API.

Haga una solicitud GET al endpoint Get Organization by Name. Asegúrese de reemplazar los valores de marcador de posición ORG_NAME y MGMT_API_ACCESS_TOKEN por el nombre de su organización y su token de acceso de la Management API, respectivamente.

Encuentre su dominio de Auth0

Su dominio de Auth0 se compone del nombre de su inquilino, su subdominio regional (a menos que su inquilino esté en la región de EE. UU. y se haya creado antes de junio de 2020) y .auth0.com. Por ejemplo, si el nombre de su inquilino fuera travel0, el nombre de su dominio de Auth0 sería travel0.us.auth0.com. (Si su inquilino estuviera en EE. UU. y se hubiera creado antes de junio de 2020, entonces el nombre de su dominio sería https://travel0.auth0.com).

Si usa dominios personalizados, este debe ser el nombre de su dominio personalizado.

Valor	Descripción
ORG_ NAME	Nombre de la organización que desea recuperar. Longitud máxima de 50 caracteres.
MGMT_API_ACCESS_TOKEN	Token de acceso para la Management API con el scope read:organizations.

​

Códigos de estado de respuesta

Los posibles códigos de estado de respuesta son los siguientes:

Código de estado	Código de error	Message	Causa
200		Organizaciones recuperadas correctamente.
400	invalid_query_string	La cadena de consulta de la solicitud no es válida. El mensaje variará según la causa.	La cadena de consulta no es válida.
401		Token no válido.
401		Se recibió una firma no válida para la validación de JSON Web Token.
401		El cliente no es global.
403	insufficient_scope	Scope insuficiente; se esperaba alguno de los siguientes: read:organizations.	Se intentó leer o escribir un campo que no está permitido con los scopes del Bearer Token proporcionado.
429		Demasiadas solicitudes. Revise los encabezados X-RateLimit-Limit, X-RateLimit-Remaining y X-RateLimit-Reset.