根据证件号批量查询 empId

scope: employee:batch:query:empId

body参数

名称	类型	是否必填	描述
corpId	String	是	企业 ID；仅在该企业范围内查询员工身份。
idNumbers	Array	是	证件号码列表，至少 1 项、最多 200 项；每个输入项都会对应 successList 或 failList 中的一项。

返回参数

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

Object数据结构解释

名称	类型	描述
total	Integer	请求中 idNumbers 的总项数，重复输入也会计入。
successCount	Integer	成功命中员工身份的证件号项数。
failCount	Integer	未命中员工身份的证件号项数。
successList	Array	成功项列表，顺序与请求 idNumbers 保持一致。
failList	Array	失败项列表，顺序与请求 idNumbers 保持一致。

successList对象数据结构

名称	类型	描述
idNumber	String	对应请求中的证件号码。
empIds	Array	该证件号命中的全部员工 ID；一个证件号命中多个员工时会全部返回。

failList对象数据结构

名称	类型	描述
idNumber	String	未命中员工身份的请求证件号码。
reason	String	查询失败原因。

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Body 参数application/json必填

示例

一个证件号码可以命中多个员工 ID。

{
    "corpId": "corp_demo",
    "idNumbers": [
        "110101199001011234",
        "110101199002021234"
    ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

请求已受理；data 中给出每个证件号的查询结果。

Bodyapplication/json

示例

一个证件号命中多个员工 ID 时，在同一个 successList 项的 empIds 中全部返回。

{
    "success": true,
    "errorCode": null,
    "errorMsg": null,
    "data": {
        "total": 2,
        "successCount": 1,
        "failCount": 1,
        "successList": [
            {
                "idNumber": "110101199001011234",
                "empIds": [
                    "emp_001",
                    "emp_002"
                ]
            }
        ],
        "failList": [
            {
                "idNumber": "110101199002021234",
                "reason": "未找到匹配员工"
            }
        ]
    }
}

🟠400请求有误

🟠403禁止访问