人员查询 - 组织人事

当前接口默认查询：在职的（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)字段；20240301基线后支持

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)
20240401基线后支持

needExtraOrgInfo

boolean

需要返回兼职信息

可选

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

multiFieldList

array[string]

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

可选

支持： username 人员名称

account

string

账号

可选

支持：卡片-账号信息中账号、绑定手机、绑定邮箱、登录名

secLevelRange

object

安全级别

可选

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

from

integer

安全级别开始

可选

integer

安全级别结束

可选

needAccountInfo

boolean

是否返回账号信息

可选

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

needCompanyYear

boolean

是否需要返回司龄

可选

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

directSuperiorList

array[string]

上级

可选

20240501基线支持

containSubordinates

boolean

是否含下级

可选

是否含下级（20240501基线支持）；仅对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

修改日期-结束

可选

accounttype

integer

身份类型

可选

0 主身份，1 次身份

250301基线+支持

belongto

number

主身份id

可选

按照主身份id查询

250301基线+支持

示例

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