Skip to content

获取员工列表

拥有此API的权限集
组织管理-查询

请求方式及url

  • 请求方式:POST
  • 请求头:Content-Type:application/json
  • 接口地址:https://api.xiaoe-tech.com/xe.ofs.user_list.get/1.0.0
  • 频率限制: 10秒3000次

接口调试

请求参数
响应结果
暂无响应数据

请求参数

参数名必选类型说明
access_tokenstring专属token
groupsstring分组id,不传默认为根
page_indexint页码,表示第几页,从1开始;默认1
page_sizeint每页条数,最大50条;默认10

请求示例

{
     "access_token": "xe_xxxxx",
     "groups": "g_appxxxxxx",
     "page_index ": 1,
     "page_size ": 3
}

返回参数

|参数名|类型|说明| |:----- |:----|:-----|:-----| |code |int |请求结果码 | |msg |string |描述信息 | |data |object |用户列表 |

用户列表 data

参数名类型说明
list.user_idstring员工id
list.namestring员工名
list.accountstring账号
list.passwordstring密码
list.nicknamestring昵称
list.avatarstring员工头像
list.mobilestring员工手机
list.jobstring员工职位
list.emailstring员工邮箱
list.genderint员工性别: 0-未定义 1-男 2-女
list.stateint员工状态: 1-启用,0-停用用户所属组
list.state_tipsint0-账号正常激活,1-账号未激活,2-试用版账号拦截,3-正式版账号拦截
list.groupsarray员工所属分组
list.auth_atarray授权时间
list.created_atarray导入时间
page.page_indexint页码,表示第几页,从1开始
page.page_sizeint每页条数,最大50条
page.page_totalint数据总数

返回示例

{
  "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
    }
  }
}