预览审批流程

提交审批前，预览审批流程。或者发起审批后，在某一审批节点预览后续流程
请求参数和"创建审批实例"接口类似（没有uuid字段）。如果用户还未发起审批实例，则类似创建审批实例接口的传值，比如user_id、表单form、审批定义approval_code等数据。如果已经发起了，此时流程是已经固定的，只需要user_id和instance_code、task_id。

curl --location --request POST 'https://www.feishu.cn/open-apis/approval/v4/instances/preview?user_id_type=open_id' \ --header 'Authorization;' \ --header 'Content-Type: application/json' \ --data-raw '发起审批之前 { "approval_code":"C2CAAA90-70D9-3214-906B-B6FFF947F00D", "user_id":"f7cb567e", "department_id":"", "form":"[{\"id\":\"widget16256287451710001\", \"type\": \"number\", \"value\":\"43\"}]" } 发起审批之后 { "instance_code":"12345CA6-97AC-32BB-8231-47C33FFFCCFD", "user_id":"f7cb567e", "task_id": "6982332863116876308" }'

{ "code": 0, "msg": "success", "data": { "preview_nodes": [ { "user_id_list": [ "ffffffff" ], "end_cc_id_list": [], "node_id": "b078ffd28db767c502ac367053f6e0ac", "node_name": "发起", "node_type": "", "comments": [], "custom_node_id": "" }, { "user_id_list": [ "ffffffff" ], "end_cc_id_list": [], "node_id": "e6ce10282a3cc3bf4a408feffd678dcf", "node_name": "审批", "node_type": "AND", "comments": [], "custom_node_id": "", "is_empty_logic": false, "is_approver_type_free": false, "has_cc_type_free": false }, { "user_id_list": [], "end_cc_id_list": [], "node_id": "b1a326c06d88bf042f73d70f50197905", "node_name": "结束", "node_type": "", "comments": [], "custom_node_id": "" } ] } }

请求参数

Query 参数

user_id_type

string

可选

用户 ID 类型示例值："open_id" 可选值有： open_id：用户的 open id union_id：用户的 union id user_id：用户的 user id 默认值：open_id 当值为 user_id，字段权限要求：获取用户 user ID

示例值:

open_id

Header 参数

Authorization

string

必需

tenant_access_token 或 user_access_token 值格式："Bearer access_token" 示例值："Bearer u-7f1bcd13fc57d46bac21793a18e560"

默认值:

Bearer {{access_token}}

Content-Type

string

必需

固定值："application/json; charset=utf-8"

默认值:

application/json; charset=utf-8

Body 参数application/json

approval_code

string

审批定义 Code

必需

user_id

string

必需

发起审批用户，employeid或者openid

department_id

string

必需

发起审批用户部门，如果用户只属于一个部门，可以不填，如果属于多个部门，必须填其中一个部门

form

string

必需

JSON字符串，控件值。提交审批之前，查看预览流程时，该字段必填

instance_code

string

审批实例code

必需

task_id

string

必需

若审批实例已存在，则传递当前审批任务对应的task_id, 并且user_id需要传task的指派人

示例

application/json

Body

code

integer

必需

错误码，非0表示失败

msg

string

返回码的描述

必需

data

object

返回业务信息

必需

preview_nodes

array [object {10}]

预览节点信息

必需

请求参数

返回响应