批量新增员工兼岗记录

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

Scope：ptj:batch:create

body参数

名称	类型	是否必填	描述
corpId	String	是	企业 ID。OAuth 客户端需具备该企业访问权限。
empId	String	是	员工 ID。
partTimeJobDataList	Array of Object	是	待新增的兼岗信息列表，至少 1 条，单次最多 100 条。
└ 兼岗字段 ID	DynamicFieldValue	是	兼岗字段按企业当前启用的兼岗元数据传值，例如 `ptjDepartment`、`ptjJobTitle`、`ptjStartDate`。选项字段传对应选项 ID；日期字段传 `yyyy-MM-dd` 字符串。每条兼岗信息不能为空。

partTimeJobDataList 中传入的 corpId、empId 不生效，服务端始终使用请求顶层的 corpId、empId。

返回参数

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

Object数据结构解释

名称	类型	描述
totalCount	Integer	本批提交的兼岗信息总条数。
successCount	Integer	新增成功条数。
failCount	Integer	新增失败条数。
empId	String	请求中的员工 ID。
successList	Array of String	新增成功的兼岗记录 ID 列表。
failList	Array	新增失败的兼岗信息列表。
└ partTimeJobData	Object	新增失败时的原始兼岗信息。
└ reason	String	失败原因，例如“兼岗职位：职位未关联部门”。

每条兼岗信息独立校验和新增，允许部分成功；员工不存在时，本批所有兼岗信息均返回失败。

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Header 参数

Body 参数application/json必填

示例

{
    "corpId": "corp_001",
    "empId": "emp_001",
    "partTimeJobDataList": [
        {
            "ptjDepartment": "org_001",
            "ptjJobTitle": "job_001",
            "ptjStartDate": "2026-08-01",
            "ptjEndDate": "2026-12-31"
        }
    ]
}

请求示例代码

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": {
        "empId": "emp_001",
        "totalCount": 2,
        "successCount": 1,
        "failCount": 1,
        "successList": [
            "ptj_001"
        ],
        "failList": [
            {
                "partTimeJobData": {
                    "ptjDepartment": "org_invalid"
                },
                "reason": "兼岗部门不存在"
            }
        ]
    }
}

🟠400RequestRejected

批量新增员工兼岗记录

批量新增员工兼岗记录#

body参数#

返回参数#

Object数据结构解释#

请求参数

请求示例代码

返回响应

批量新增员工兼岗记录

body参数

返回参数

Object数据结构解释