批量查询员工兼岗信息

接口地址：POST /open/api/v1/ptj/batch/info

Scope：ptj:batch:info

body参数

名称	类型	是否必填	描述
corpId	String	是	企业 ID。OAuth 客户端需具备该企业访问权限。
empIds	Array of String	是	员工 ID 列表，至少 1 个，单次最多 300 个。列表元素不能为空。

返回参数

名称	类型	描述
success	Boolean	接口是否正常受理。`true` 不代表每个员工都查询成功。
errorCode	String	接口受理结果编码；正常受理为 `200`。鉴权、参数格式、员工数量超限等整批异常时返回对应错误码。
errorMsg	String	接口受理结果说明。
data	Object	批量查询结果。
rid	String	请求链路 ID。

Object数据结构解释

名称	类型	描述
totalCount	Integer	本批请求员工总数，按传入 `empIds` 原始列表计数，重复员工会重复计数。
successCount	Integer	查询成功的员工数。员工存在但没有兼岗记录也算成功。
failCount	Integer	查询失败的员工数。
successList	Array	查询成功的员工列表，按传入顺序返回。
└ empId	String	对应传入的员工 ID。
└ partTimeJobs	Array	该员工名下未删除的兼岗记录列表；无兼岗记录时返回空数组。
└└ partTimeJobId	String	兼岗记录 ID。
└└ data	Object	兼岗信息。Key 为企业兼岗元数据字段 ID，Value 为该字段的前端展示值。
failList	Array	查询失败的员工列表，按传入顺序返回。
└ empId	String	对应传入的员工 ID。
└ reason	String	失败原因，例如“该员工不存在”。

同一 empId 重复传入时，不去重，按输入顺序返回多条对应结果。
同一员工的兼岗记录按兼岗开始日期倒序返回；开始日期相同时，按兼岗记录 ID 升序返回。

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Header 参数

Body 参数application/json必填

示例

{
    "corpId": "corp_001",
    "empIds": [
        "emp_001",
        "emp_002"
    ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200

application/json

接口已受理；业务失败在 data.failList 中逐条返回。

Bodyapplication/json

示例

{
    "success": true,
    "errorCode": "200",
    "errorMsg": "成功",
    "data": {
        "totalCount": 2,
        "successCount": 1,
        "failCount": 1,
        "successList": [
            {
                "empId": "emp_001",
                "partTimeJobs": [
                    {
                        "partTimeJobId": "ptj_001",
                        "data": {
                            "ptjStartDate": "2026-01-01",
                            "ptjDepartment": [
                                {
                                    "label": "研发部",
                                    "value": "org_001",
                                    "order": 1,
                                    "status": "normal"
                                }
                            ]
                        }
                    }
                ]
            }
        ],
        "failList": [
            {
                "empId": "emp_002",
                "reason": "该员工不存在"
            }
        ]
    }
}

🟠400RequestRejected

批量查询员工兼岗信息

批量查询员工兼岗信息#

body参数#

返回参数#

Object数据结构解释#

请求参数

请求示例代码

返回响应

批量查询员工兼岗信息

body参数

返回参数

Object数据结构解释