# 获取组织结构树 |拥有此API的权限集| |:----- | |组织管理-查询组织信息| **请求方式及url** - 请求方式：`POST` - 请求头：`Content-Type:application/json` - 接口地址：`https://api.xiaoe-tech.com/xe.ofs.tree.get/1.0.0` - 频率限制: `10秒3000次` {% api method="POST", data={ "access_token" : "xe_xxxxx", "root_id": "xxxxx", "fetch_children": 1, "fetch_user": 1, "is_auth": 1 }, url="https://api-doc.xiaoe-tech.com/_agent/forward?url=https://api.xiaoe-tech.com/xe.ofs.tree.get/1.0.0" %} {% endapi %} **请求参数** |参数名|必选|类型|说明| |:---- |:---|:----- |:----- | |access_token |是 |string |[专属token](./../get_access_token.md) | |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 } ] } } ```