批量查询任职信息 - 睿人事OpenAPI

scope: employee:batch:workInfo:select

body参数

名称	类型	是否必填	描述
corpId	String	是	企业 ID；同一请求只能查询一个企业的数据。
empIds	Array	条件必填	按员工 ID 查询任职信息，至少 1 项、最多 200 项；与 jobDataIds 必须二选一。
jobDataIds	Array	条件必填	按任职记录 ID 查询任职信息，至少 1 项、最多 200 项；与 empIds 必须二选一。系统会校验记录属于 corpId，避免跨企业读取。
effectDate	String	否	仅在按 empIds 查询时生效，格式 `yyyy-MM-dd`；不传时取当前日期。

empIds 和 jobDataIds 不能同时传入，也不能同时为空；违反该规则或所选列表超过 200 项时，请求级校验失败。

返回参数

名称	类型	描述
success	Boolean	请求是否成功受理。`true` 仅表示鉴权和参数校验通过，单条任职记录的查询结果请查看 data 内的 successList、failList。
errorCode	String	请求级失败编码；success 为 false 时返回。
errorMsg	String	请求级失败原因；success 为 false 时返回。
data	Object	批量查询结果；success 为 true 时返回。

Object数据结构解释

名称	类型	描述
total	Integer	所选定位键列表的总项数，重复输入也会计入。
successCount	Integer	成功查询到任职信息的项数。
failCount	Integer	未查询到任职信息的项数。
successList	Array	成功项列表，顺序与所选定位键列表保持一致。
failList	Array	失败项列表，顺序与所选定位键列表保持一致。

successList对象数据结构

名称	类型	描述
empId	String	员工 ID。
jobDataId	String	任职记录 ID；用于精确定位同一员工的多条任职记录。
effectDate	String	任职记录生效日期。
operate	Array	任职操作选项列表；每项含 label（显示名称）、value（选项编码）、order（排序）、status（状态）。
operateType	Array	任职操作类型选项列表；每项字段与 operate 相同。
workInfo	Map<String, Object>	任职信息，字段随企业花名册元数据动态返回。
workStatusInfo	Map<String, Object>	任职状态信息，字段随企业花名册元数据动态返回。
quitInfo	Map<String, Object>	离职信息，字段随企业花名册元数据动态返回。

failList对象数据结构

名称	类型	描述
empId	String	按 empIds 查询失败时回显的员工 ID。
jobDataId	String	按 jobDataIds 查询失败时回显的任职记录 ID。与 empId 二选一返回。
reason	String	查询失败原因。

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Body 参数application/json必填

示例

按员工 ID 查询按任职记录 ID 查询

effectDate 仅在按员工 ID 查询时生效。

{
    "corpId": "corp_demo",
    "empIds": [
        "emp_001"
    ],
    "effectDate": "2026-07-30"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

请求已受理；successList 项中同时回显 empId 和 jobDataId。

Bodyapplication/json

示例

一个员工查询到任职信息，另一个员工未命中。

{
    "success": true,
    "errorCode": null,
    "errorMsg": null,
    "data": {
        "total": 2,
        "successCount": 1,
        "failCount": 1,
        "successList": [
            {
                "empId": "emp_001",
                "jobDataId": "history_001",
                "effectDate": "2026-07-30",
                "operate": [],
                "operateType": [],
                "workInfo": {
                    "mainDepartment": "dept_001"
                },
                "workStatusInfo": {},
                "quitInfo": {}
            }
        ],
        "failList": [
            {
                "empId": "emp_002",
                "reason": "未找到指定生效日期的任职信息"
            }
        ]
    }
}

🟠400请求有误

🟠403禁止访问