批量修改员工兼岗记录

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

Scope：ptj:batch:update

body参数

名称	类型	是否必填	描述
corpId	String	是	企业 ID。OAuth 客户端需具备该企业访问权限。
empId	String	是	兼岗记录所属员工 ID。
partTimeJobs	Array of Object	是	待修改的兼岗记录列表，至少 1 条，单次最多 100 条。
└ partTimeJobId	String	是	待修改的兼岗记录 ID，可通过 `POST /open/api/v1/ptj/batch/ids` 获取。
└ data	Object	是	待更新的兼岗字段，至少传入 1 个字段。
└└ 兼岗字段 ID	DynamicFieldValue	否	待修改字段，按企业当前启用的兼岗元数据传值。未传入的字段保持原值；传入字段且值为 `null` 时清空该字段。选项字段传对应选项 ID；日期字段传 `yyyy-MM-dd` 字符串。

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

返回参数

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

Object数据结构解释

名称	类型	描述
empId	String	请求中的员工 ID。
totalCount	Integer	本批提交的兼岗记录总条数。
successCount	Integer	修改成功条数。
failCount	Integer	修改失败条数。
successList	Array of String	修改成功的兼岗记录 ID 列表。
failList	Array	修改失败的兼岗记录列表。
└ partTimeJobId	String	修改失败的兼岗记录 ID。
└ reason	String	失败原因，例如“该兼岗记录不存在”“该兼岗记录不属于该员工”。

同一次请求中重复传入同一 partTimeJobId 时，该 ID 对应的所有请求项均修改失败，不写入数据。

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Header 参数

Body 参数application/json必填

示例

{
    "corpId": "corp_001",
    "empId": "emp_001",
    "partTimeJobs": [
        {
            "partTimeJobId": "ptj_001",
            "data": {
                "ptjDepartment": "org_002",
                "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": [
            {
                "partTimeJobId": "ptj_002",
                "reason": "该兼岗记录不存在"
            }
        ]
    }
}

🟠400RequestRejected

批量修改员工兼岗记录

批量修改员工兼岗记录#

body参数#

返回参数#

Object数据结构解释#

请求参数

请求示例代码

返回响应

批量修改员工兼岗记录

body参数

返回参数

Object数据结构解释