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 |
