批量删除员工兼岗记录

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

Scope：ptj:batch:delete

body参数

名称	类型	是否必填	描述
corpId	String	是	企业 ID。OAuth 客户端需具备该企业访问权限。
empId	String	是	待删除兼岗记录所属的员工 ID。
partTimeJobIds	Array of String	是	待删除的兼岗记录 ID 列表，至少 1 条，单次最多 100 条。列表元素不能为空。兼岗记录 ID 可通过 `POST /open/api/v1/ptj/batch/ids` 获取。

返回参数

名称	类型	描述
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",
    "partTimeJobIds": [
        "ptj_001",
        "ptj_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": {
        "empId": "emp_001",
        "totalCount": 2,
        "successCount": 1,
        "failCount": 1,
        "successList": [
            "ptj_001"
        ],
        "failList": [
            {
                "partTimeJobId": "ptj_002",
                "reason": "该兼岗记录不存在"
            }
        ]
    }
}

🟠400RequestRejected

批量删除员工兼岗记录

批量删除员工兼岗记录#

body参数#

返回参数#

Object数据结构解释#

请求参数

请求示例代码

返回响应

批量删除员工兼岗记录

body参数

返回参数

Object数据结构解释