批量获取员工详情 - 睿人事OpenAPI

scope: employee:batch:detail

body参数

名称	类型	是否必填	描述
corpId	String	是	企业 ID；同一请求只能查询一个企业的数据。
empIds	Array	是	员工 ID 列表，至少 1 项、最多 200 项；每个输入项都会对应 successList 或 failList 中的一项。
effectDate	String	否	查询生效日期，格式 `yyyy-MM-dd`；不传时取当前日期。

返回参数

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

Object数据结构解释

名称	类型	描述
total	Integer	请求中 empIds 的总项数，重复输入也会计入。
successCount	Integer	成功查询到详情的项数。
failCount	Integer	未查询到详情的项数。
successList	Array	成功项列表，顺序与请求 empIds 保持一致。
failList	Array	失败项列表，顺序与请求 empIds 保持一致。

successList对象数据结构

名称	类型	描述
empId	String	对应请求中的员工 ID。
detail	Map<String, Object>	员工详情；字段随企业花名册元数据动态返回，字段含义请结合花名册元数据接口识别。

failList对象数据结构

名称	类型	描述
empId	String	未查询到的请求员工 ID。
reason	String	查询失败原因。

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Body 参数application/json必填

示例

查询两个员工在指定生效日期的花名册详情。

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

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

请求已受理；data 中给出逐员工结果。

Bodyapplication/json

示例

一个员工查询成功，一个员工未命中；请求成功受理后，逐项结果通过 successList 和 failList 返回。

{
    "success": true,
    "errorCode": null,
    "errorMsg": null,
    "data": {
        "total": 2,
        "successCount": 1,
        "failCount": 1,
        "successList": [
            {
                "empId": "emp_001",
                "detail": {
                    "name": "张三"
                }
            }
        ],
        "failList": [
            {
                "empId": "emp_002",
                "reason": "未找到匹配员工"
            }
        ]
    }
}

🟠400请求有误

🟠403禁止访问