加签审批任务

给单个流程中的节点或审批任务加签，加签方式有前加签、并加签、后加签三种。

请求

项目	值
HTTP URL	https://open.feishu.cn/open-apis/corehr/v2/processes/:process_id/extra
HTTP Method	PUT
接口频率限制	20 次/分钟
支持的应用类型	custom,isv
权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用	corehr:process.instance:write 通过/拒绝审批任务
字段权限要求	> Tip: 该接口返回体中存在下列敏感字段，仅当开启对应的权限后才会返回；如果无需获取这些字段，则不建议申请 contact:user.employee_id:readonly 获取用户 user ID

请求头

名称	类型	必填	描述
Authorization	string	是	tenant_access_token 值格式："Bearer access_token" 示例值："Bearer t-7f1bcd13fc57d46bac21793a18e560" 了解更多：如何选择与获取 access token
Content-Type	string	是	固定值："application/json; charset=utf-8"

路径参数

名称	类型	描述
process_id	string	流程实例id，是一个流程的唯一标识。 可通过查询流程实例列表接口返回的 process_ids 字段获取 示例值："7410664363763172908"

查询参数

名称	类型	必填	描述
user_id_type	string	否	用户 ID 类型 示例值：open_id 可选值有： - open_id: 标识一个用户在某个应用中的身份。同一个用户在不同应用中的 Open ID 不同。了解更多：如何获取 Open ID - union_id: 标识一个用户在某个应用开发商下的身份。同一用户在同一开发商下的应用中的 Union ID 是相同的，在不同开发商下的应用中的 Union ID 是不同的。通过 Union ID，应用开发商可以把同个用户在多个应用中的身份关联起来。了解更多：如何获取 Union ID？ - user_id: 标识一个用户在某个租户内的身份。同一个用户在租户 A 和租户 B 内的 User ID 是不同的。在同一个租户内，一个用户的 User ID 在所有应用（包括商店应用）中都保持一致。User ID 主要用于在不同的应用间打通用户数据。了解更多：如何获取 User ID？ - people_corehr_id: 以飞书人事的 ID 来识别用户 默认值：open_id 当值为 user_id，字段权限要求： contact:user.employee_id:readonly 获取用户 user ID

请求体

名称	类型	必填	描述
operator	string	否	操作人，按user_id_type类型传递；如果system_user为true，则此字段可以不填 示例值："7184703091806602796"
node_id	string	否	流程节点id，与approver_id二选一传入，都传以node_id为准 示例值："7414045453433439788"
approver_id	string	否	标识流程中一个审批节点的一个审批人的审批任务。 同一个审批节点如果有多个审批人，不同审批人的 approver_id 不同。 可通过 获取单个流程详情接口获取流程中各审批任务的 approver_id。 与node_id二选一传入，都传以node_id为准 示例值："7424452160928106028"
extra_type	int	是	加签方式 示例值：1 可选值有： - 0: 前加签 - 1: 并加签 - 2: 后加签
approval_type	int	否	多人加签时的审批方式，需要注意当extra_type为并加签时，此处只能选择会签 示例值：1 可选值有： - 0: 或签 - 1: 会签
extra_user_ids	string\[\]	是	加签人员id列表 示例值：["7184703091806602796"] 数据校验规则： - 长度范围：1 ～ 20
remark	string	否	备注 示例值："备注"
system_user	boolean	否	是否以系统身份操作，如果为false，则operator必填 示例值：true 默认值：false

请求体示例

{
    "operator": "7184703091806602796",
    "node_id": "7414045453433439788",
    "approver_id": "7424452160928106028",
    "extra_type": 1,
    "approval_type": 1,
    "extra_user_ids": [
        "7184703091806602796"
    ],
    "remark": "备注",
    "system_user": true
}

响应

响应体

名称	类型	描述
code	int	错误码，非 0 表示失败
msg	string	错误描述
data	\-	-

响应体示例

{
    "code": 0,
    "msg": "success",
    "data": {}
}

错误码

HTTP状态码	错误码	描述	排查建议
500	1160500	系统异常	请咨询技术支持协助排查。
400	1160101	参数非法	参数错误，请操作接口字段说明自查
400	1160015	所有审批已经结束	不存在进行中的审批任务，无法加签
400	1161103	任务处理中	任务正在处理中，可稍后重试
400	1161003	无权限	请确认是否已申请权限
400	1160256	节点不支持加签	当前节点不支持加签，请检查流程节点配置
400	1160001	未能获取到租户Id和用户Id	请检查请求参数是否正确
400	1160115	不支持审批类型为或签的申请	老流程或签不支持加签
400	1160016	审批节点已经结束	节点状态已经结束，无法再加签
400	1160129	已经完成审批无法加签	审批已完成，无法再加签
400	1160114	审批人重复	加签人在当前节点上已经存在