Get Organization List¶
根据 Access Token 列出当前用户所在的组织(Organization Unit,简称 OU)列表。
前提条件¶
用户已登录应用门户,并进入一个 OU。如有需要,可通过 Log In API 登录应用门户,通过 Choose Organization API 选择 OU。
请求格式¶
GET https://{apigw-address}/app-portal-service/v2.2/user/organization/list
请求参数(Header)¶
名称 |
必需/可选 |
数据类型 |
描述 |
---|---|---|---|
Authorization |
必需 |
String |
用户登录并选择 OU 后生成的 Access Token,以 Bearer Token 表示,其形式为 |
响应参数¶
名称 |
数据类型 |
描述 |
---|---|---|
organizations |
IdNamePair 结构体 |
OU 列表。IdNamePair 结构体 >> |
IdNamePair 结构体 ¶
名称 |
数据类型 |
描述 |
---|---|---|
id |
String |
OU ID。 |
name |
String |
OU 名称。 |
错误码¶
代码 |
描述 |
---|---|
31401 |
提供的 Access Token 无效 |
示例¶
请求示例¶
url: https://{apigw-address}/app-portal-service/v2.2/user/organization/list
method: GET
headers: {"Authorization":"Bearer your_token"}
返回示例¶
{
"code": 0,
"message": "OK",
"data": {
"organizations": [
{
"id": "your_org_id_1",
"name": "your_org_name_1"
},
{
"id": "your_org_id_2",
"name": "your_org_name_2"
}
]
}
}