Skip to content

三方审批任务概述

审批业务提供了获取三方审批任务状态的开放能力,用于查询指定审批实例、指定用户或指定状态下的审批任务数据。

字段说明

名称类型描述
approval_codesstring\[\]三方审批定义 Code,用于指定只获取这些定义下的数据。获取方式:
- 调用创建三方审批定义时,会返回审批定义 Code。 - 登录审批管理后台,在指定审批定义的 URL 中获取,具体操作参见什么是 Approval Code
示例值:["E78F1022-A166-447C-8320-E151DA90D70F"]
数据校验规则
- 最大长度:20
instance_idsstring\[\]三方审批实例 ID,用于指定只获取这些实例下的数据,最多支持 20 个。
说明:三方审批实例 ID 是调用同步三方审批实例校验三方审批实例时自定义的实例 ID(instance_id)。
示例值:["oa_159160304"]
user_idsstring\[\]审批人 user_id,用于指定只获取这些用户的数据。获取方式参见如何获取用户的 User ID
示例值:["112321"]
statusstring审批任务状态,用于指定获取该状态下的数据。
示例值:"PENDING"
可选值有
- PENDING: 审批中 - APPROVED: 审批流程结束,结果为同意 - REJECTED: 审批流程结束,结果为拒绝 - TRANSFERRED: 任务转交 - DONE: 任务通过但审批人未操作。审批人看不到该任务时,如需查看可抄送至该审批人。

数据示例

json
{
    "approval_codes": [
        "E78F1022-A166-447C-8320-E151DA90D70F"
    ],
    "instance_ids": [
        "oa_159160304"
    ],
    "user_ids": [
        "112321"
    ],
    "status": "PENDING"
}

内容来源:飞书开放平台 · 自动爬取整理