获取组织结构树
| 拥有此API的权限集 |
|---|
| 组织管理-查询 |
请求方式及url
- 请求方式：
POST - 请求头：
Content-Type:application/json - 接口地址：
https://api.xiaoe-tech.com/xe.ofs.tree.get/1.0.0 - 频率限制:
10秒3000次
在线调试工具
请求
响应
请求参数
| 参数名 | 必选 | 类型 | 说明 |
|---|---|---|---|
| access_token | 是 | string | 专属token |
| root_id | 否 | string | 顶级分组id，不传默认为根id |
| fetch_children | 否 | int | fetch_children = 1 时，获取子部门 |
| fetch_user | 否 | int | fetch_user = 1 时，获取用户 |
| is_auth | 否 | int | is_auth = 1 时，只获取授权的用户 |
请求示例
{
"access_token" : "xe_xxxxx",
"root_id": "xxxxx",
"fetch_children": 1,
"fetch_user": 1,
"is_auth": 1
}
返回参数
| 参数名 | 类型 | 说明 |
|---|---|---|
| code | int | 请求结果码 |
| msg | string | 描述信息 |
| data | object | 用户列表 |
用户列表 data
| 参数名 | 类型 | 说明 |
|---|---|---|
| id | int | 用户id |
| type | string | 类型：group-分组 user-用户 |
| name | string | 分组/用户 名称 |
| image | string | 用户头像 |
| attr.id | string | 属性id |
| attr.group_id | string | 分组id |
| attr.name | string | 分组名称 |
| attr.parent_id | string | 父级分组id |
| attr.path | string | 分组路径 |
| attr.children | arrary | 子分组 |
返回示例
{
"code": 0,
"msg": "success",
"data": {
"id": "g_xxxxxxxx",
"type": "group",
"name": "全部",
"image": "",
"attr": {
"id": "g_xxxxxxxx",
"group_id": "g_xxxxxxxx",
"name": "全部",
"parent_id": "appxxxxx",
"path": "",
"count": 0
},
"children": [
{
"id": "g_xxxxxxxx",
"type": "group",
"name": "学习二组",
"image": "",
"attr": {
"id": "g_xxxxxxxx",
"group_id": "g_xxxxxxxx",
"name": "学习二组",
"parent_id": "g_xxxxxxxx",
"path": "xxx/xxxx",
"count": 0
},
"children": []
},
{
"id": "g_xxxxxxxx",
"type": "group",
"name": "学习一组",
"image": "",
"attr": {
"id": "g_xxxxxxxx",
"group_id": "g_xxxxxxxx",
"name": "学习一组",
"parent_id": "g_xxxxxxxx",
"path": "/xxxxxx",
"count": 0
},
"children": [
{
"id": "g_xxxxxxxx",
"type": "group",
"name": "前端组",
"image": "",
"attr": {
"id": "g_xxxxxxxx",
"group_id": "g_xxxxxxxx",
"name": "前端组",
"parent_id": "g_xxxxxxxx",
"path": "xxxxxx/xxxx",
"count": 0
},
"children": []
}
]
},
{
"id": "u_xxxx_xxxx",
"type": "user",
"name": "jeffery",
"image": "https://xxx.com/aaa/default.svg",
"attr": null,
"children": null
}
]
}
}