预览审批流程

POST

/approval/v4/instances/preview

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

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Query 参数

Body 参数application/json

示例

返回响应

🟢200成功

application/json

Body

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://open.feishu.cn/open-apis/approval/v4/instances/preview?user_id_type=open_id' \
--header 'Authorization: Bearer <token>' \
--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": ""
            }
        ]
    }
}

修改于 2025-10-21 07:10:31

抄送审批实例

批量获取审批实例ID