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