人员查询 - 组织人事

当前接口默认查询：在职的（userStatusList）、内部的、未删除的人员；如果不希望默认请按照文档提供参数即可。

请求参数

Body 参数application/json

jobNumList

array[string]

工号

可选

subcompanyIds

array[string]

分部id

可选

departmentIds

array[string]

部门id

可选

positionList

array[string]

岗位id

可选

ids

array[string]

人员id

可选

mobileList

array[string]

手机

可选

containUserInfo

boolean

加载个人信息

可选

containAvatar

boolean

包含头像信息

可选

开启后，返回值中提供 avatarInfo，包含p1（头像原图id）,p2(照片id),p3(头像id)字段；0301基线后支持

containEmployeeExtend

boolean

加载基本信息自定义

可选

containUserInfoExtend

boolean

加载个人信息自定义

可选

这个参数为true；必然提供个人信息内容

current

integer

分页-当前页

可选

pageSize

integer

分页-页大小

可选

最大1000

userStatusList

array[string]

人员状态

可选

人员状态支持：normal 在职；unavailable 离职。如果不提供默认在职

nameLikeList

array[string]

名称模糊查询

可选

returnFieldList

array[string]

指定返回字段内容

可选

指定employee表中的字段；默认全字段返回。
示例：["id"] 仅返回人员id；["id","username"] 仅返回人员id、人员名称

needReturnBrowserInfo

boolean

浏览数据详细信息

可选

提供true;部门、岗位返回详细信息；departmentInfo(内容包含id、code、name),postionInfo(内容包含id、code、name)
0401基线后支持

needExtraOrgInfo

boolean

需要返回兼职信息

可选

开启后提供兼职信息： extraOrgInfoList
0401基线后支持

multiFieldList

array[string]

需要返回的多语言字段列表

可选

支持： username 人员名称

account

string

账号

可选

支持：卡片-账号信息中账号、绑定手机、绑定邮箱、登录名（weaver-hrm-service 1.14后支持）

secLevelRange

object

安全级别

可选

根据安全级别范围查询数据

from

integer

安全级别开始

可选

integer

安全级别结束

可选

needAccountInfo

boolean

是否返回账号信息

可选

true 返回账号信息，返回内容中额外提供：
account 账号、bindEmail 登录邮箱、bindMobile 登录手机、loginid 登录名

needCompanyYear

boolean

是否需要返回司龄

可选

0701基线后支持；返回参数中： company_year表示人员司龄

directSuperiorList

array[string]

上级

可选

0501基线支持

containSubordinates

boolean

是否含下级

可选

是否含下级（0501基线支持）；仅对subcompanyIds、departmentIds条件有效；subcompanyIds表示查询分部及其下级分部；departmentIds表示查询部门及其下级部门

createTime

object

创建日期

可选

创建日期-开始、创建日期-结束不能同时为空 ; 日期格式： yyyy-MM-dd HH:mm:ss

from

string

创建日期-开始

可选

string

创建日期-结束

可选

updateTime

object

修改日期

可选

修改日期-开始、修改日期-结束不能同时为空日期格式： yyyy-MM-dd HH:mm:ss

from

string

修改日期-开始

可选

string

修改日期-结束

可选

示例

{
  "jobNumList": [
    "RYGH5612"
  ],
  "containEmployeeExtend": true
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

message

object

必需

errcode

string

必需

errmsg

string

必需

data

object

必需

current

integer

当前页

必需

total

integer

总数

必需

data

array [object {62}]

必需

pageSize

integer

页大小

可选

示例

{
  "message": {
    "errcode": "0",
    "errmsg": "success"
  },
  "data": {
    "current": 1,
    "total": 1,
    "data": [
      {
        "employeeExtend": {
          "802830263522590723": {
            "title": "单行文本",
            "value": "aassff"
          }
        },
        "education": {
          "id": "767257884333465620",
          "name": "高中及以下"
        },
        "accumfundaccount": "sss",
        "nation": {
          "id": "767257884333465630",
          "name": "汉族"
        },
        "residence_place": "1122",
        "modifier": "2226184113539534645",
        "active_date": "2022-12-12",
        "type": "inside",
        "bankid": "798795283734192129",
        "id_no": "342401198802051876",
        "bank_accountname": "aass",
        "id": "805851627118034951",
        "bank_account": "aaas",
        "created": "2022-12-12",
        "degree": {
          "id": "767257884333465627",
          "name": "博士"
        },
        "first_work_date": "2022-12-17",
        "work_year": 0,
        "formdata": "807746708413734913",
        "login_status": "invited",
        "native_place": "安徽省",
        "last_update_time": "2022-12-17",
        "pinyin": "anbang,anbeng",
        "user_id": "2227082695389976109",
        "child_status": "ffss",
        "birthday": "1988-02-05",
        "tenant_key": "t7emfkqmmm",
        "family_contact": "3344",
        "sec_level": 0,
        "update_time": "2022-12-17",
        "job_num": "RYGH5612",
        "department": "2226184113543634646",
        "logogram": "ab",
        "personnel_status": "5",
        "im_uid": "805851627118034951",
        "household_type": {
          "id": "767257884333465611",
          "name": "本市城镇"
        },
        "graduate_school": "aaass",
        "marital_status": "married",
        "politics_status": {
          "id": "767257884333465615",
          "name": "党员（含预备党员）"
        },
        "age": 34,
        "username": "安蚌"
      }
    ],
    "pageSize": 100
  }
}