logo
Desarrollo
Buscar
Consultar lista de organizaciones

Consultar lista de organizaciones

Permite consultar la lista de organizaciones a las que puede acceder la cuenta a la que pertenece la clave de desarrollador actual.

Mediante esta interfaz, se puede consultar la lista de organizaciones a las que puede acceder la cuenta a la que pertenece la clave de desarrollador actual.

Método de solicitud

GET

URL de la solicitud

https://api.${endpoint}/v1/org/list

Autenticación de la solicitud

Utiliza la autenticación Basic con DevKey / DevSecret a nivel de cuenta.

Solicitud

Ejemplo de solicitud

curl -X GET 'https://api.${endpoint}/v1/org/list' \ -H 'Authorization: Basic ${BASIC_TOKEN}'
                      
                      curl -X GET 'https://api.${endpoint}/v1/org/list' \
  -H 'Authorization: Basic ${BASIC_TOKEN}'

                    
Este bloque de código en una ventana flotante

Cabeceras de la solicitud

Campo Tipo Descripción
Authorization Basic ${BASIC_TOKEN} Basic Token resultante de codificar DevKey:DevSecret en Base64.

Parámetros de la solicitud

Ninguno.

Respuesta

Ejemplo de respuesta

{ "code": 0, "message": "OK", "data": [ { "org_id": "p-xxxx", "org_name": "Demo Org", "is_owner": true } ] }
                      
                      {
  "code": 0,
  "message": "OK",
  "data": [
    {
      "org_id": "p-xxxx",
      "org_name": "Demo Org",
      "is_owner": true
    }
  ]
}

                    
Este bloque de código en una ventana flotante

Respuesta correcta

Campo Tipo Descripción
org_id String ID de la organización; las interfaces de recursos de organización posteriores requieren este campo.
org_name String Nombre de la organización.
is_owner Boolean Indica si la cuenta actual es la propietaria de la organización.

Respuesta fallida

Campo Tipo Descripción
code Integer Código de error.
message String Detalles del error.

Códigos de estado

Código de estado Descripción
200 Correcto
400 Error de parámetros
401 No autorizado
403 Permisos insuficientes
429 Demasiadas solicitudes
500 Error del servidor