Get User Structures¶
获取当前用户所分配的组织结构节点。
前提条件¶
用户已登录应用门户,并进入一个 OU。如有需要,可通过 Log In API 登录应用门户,通过 Choose Organization API 选择 OU。
请求格式¶
GET https://{apigw-address}/app-portal-service/v2.2/user/structures
请求参数(Header)¶
名称 |
必需/可选 |
数据类型 |
描述 |
---|---|---|---|
Authorization |
必需 |
string |
用户登录并选择 OU 后生成的 Access Token,以 Bearer Token 表示,其形式为 |
响应参数¶
名称 |
数据类型 |
描述 |
---|---|---|
structures |
StructureDTO 结构体 |
组织结构列表。StructureDTO 结构体 |
StructureDTO 结构体 ¶
名称 |
数据类型 |
描述 |
---|---|---|
id |
String |
组织结构节点 ID。 |
name |
String |
组织结构名称。 |
parentId |
String |
父节点 ID。 |
错误码¶
代码 |
描述 |
---|---|
31401 |
提供的 Access Token 无效 |
31512 |
未选择 OU |
示例¶
请求示例¶
url: https://{apigw-address}/app-portal-service/v2.2/user/structures
method: GET
header: {"Authorization":"Bearer your_token"}
返回示例¶
{
"code":0,
"data":{
"structures":[
{
"id":"your_node_id_1",
"name":"your_node_name_1",
"parentId":"your_parent_node_id_1"
},
{
"id":"your_node_id_2",
"name":"your_node_name_2",
"parentId":"your_parent_node_id_2"
},
]
},
"message":""
}