# 获取员工列表 |拥有此API的权限集| |:----- | |组织管理-查询组织信息| **请求方式及url** - 请求方式：`POST` - 请求头：`Content-Type:application/json` - 接口地址：`https://api.xiaoe-tech.com/xe.ofs.user_list.get/1.0.0` - 频率限制: `10秒3000次` {% api method="POST", data= { "access_token": "xe_xxxxx", "groups": "g_appxxxxxx", "page_index ": 1, "page_size ": 3 }, url="https://api-doc.xiaoe-tech.com/_agent/forward?url=https://api.xiaoe-tech.com/xe.ofs.user_list.get/1.0.0" %} {% endapi %} **请求参数** |参数名|必选|类型|说明| |:---- |:---|:----- |:----- | |access_token |是 |string |[专属token](./../get_access_token.md) | |groups|否 |string|分组id，不传默认为根 | |page_index |否 |int|页码，表示第几页，从1开始；默认1 | |page_size |否 |int|每页条数，最大50条；默认10 | **请求示例** ``` { "access_token": "xe_xxxxx", "groups": "g_appxxxxxx", "page_index ": 1, "page_size ": 3 } ``` **返回参数** |参数名|类型|说明| |:----- |:----|:-----|:-----| |code |int |请求结果码 | |msg |string |描述信息 | |data |object |用户列表 | 用户列表 `data` |参数名|类型|说明| |:----- |:----|:-----| | list.user_id |string |员工id| | list.name |string |员工名| | list.account |string |账号 | | list.password |string |密码 | | list.nickname|string |昵称 | | list.avatar |string |员工头像 | | list.mobile |string |员工手机 | | list.job |string |员工职位 | | list.email|string |员工邮箱 | | list.gender|int|员工性别: 0-未定义 1-男 2-女 | | list.state|int |员工状态: 1-启用，0-停用用户所属组| | list.state_tips|int |0-账号正常激活，1-账号未激活，2-试用版账号拦截，3-正式版账号拦截| | list.groups|array |员工所属分组 | | list.auth_at|array |授权时间 | | list.created_at |array |导入时间 | | page.page_index |int |页码，表示第几页，从1开始 | | page.page_size |int |每页条数，最大50条 | | page.page_total|int |数据总数 | **返回示例** ``` { "code": 0, "msg": "success", "data": { "list": [ { "user_id": "u_xxxxxx", "name": "123", "account": "xxxxx", "password": "", "nickname": "xxx", "avatar": "xxxx", "mobile": "xxxx", "job": "xxx", "email": "xxx@xx.com", "gender": 1, "state": 1, "state_tips": 0, "groups": [ "colin" ], "auth_at": "2021-05-18 17:41:34", "created_at": "2021-05-18 17:41:34" }, ], "page": { "page_index": 2, "page_size": 1, "page_total": 2 } } } ```