发起审批实例

说明

调用本接口发起一个审批。
服务地址：https://oapi.dingtalk.com

权限

服务端API是以应用维度授权的，在调用接口前，确保已经为应用添加了接口权限。详情请参考权限申请。

应用类型	是否支持调用	权限申请方式	API Explorer调试
企业内部应用	是	开发者后台申请	调试
第三方企业应用	是	开发者后台申请	调试
第三方个人应用	否	—	—

请求参数

Query 参数

access_token

string

必需

调用服务端API的应用凭证。企业内部应用可通过获取企业内部应用的access_token接口获取。第三方企业应用可通过获取第三方企业应用的access_token接口获取。

示例值:

6d1bxxxx

Body 参数application/json

agent_id

number

可选

应用标识。可在开发者后台的应用详情页获取。如果是第三方企业应用必须指定该参数。

process_code

string

必需

审批流的唯一码。process_code在审批模板编辑页面的URL中获取。

originator_user_id

string

必需

审批实例发起人的userid。

dept_id

number

必需

发起人所在的部门，如果发起人属于根部门，传-1。

approvers

string

可选

审批人userid列表，最大列表长度20。多个审批人用逗号分隔，按传入的顺序依次审批。

approvers_v2

array [object {2}]

可选

审批人列表。支持会签/或签，优先级高于approvers变量。

task_action_type

string

可选

审批类型：会签：AND或签：OR单人：NONE

user_ids

array[string]

可选

审批人userid列表：会签/或签列表长度必须大于1非会签/或签列表长度只能为1

cc_list

string

可选

抄送人userid列表。该参数需要与approvers或approvers_v2参数一起传，抄送人才会生效。

cc_position

string

可选

在什么节点抄送给抄送人：STARTFINISHSTART_FINISH

form_component_values

array [object {3}]

必需

审批流表单参数，最大列表长度20。仅支持下表列举的表单控件。

name

string

表单每一栏的名称。

必需

value

string

表单每一栏的值。

必需

ext_value

string

扩展值。

可选

示例

{
    "form_component_values": [
        {
            "name": "单行输入框",
            "value": "测试单行输入框"
        },
        {
            "name": "多行输入框",
            "value": "测试多行输入框"
        },
        {
            "name": "金额（元）大写",
            "value": "1"
        },
        {
            "name": "数字输入框",
            "value": "100"
        },
        {
            "name": "单选框",
            "value": "a"
        },
        {
            "name": "多选框",
            "value": "[\"a\",\"b\"]"
        }, 
        {
            "name": "日期",
            "value": "2021-08-17"
        },
        {
            "name": "[\"开始时间\",\"结束时间\"]",
            "value": "[\"2019-02-19\",\"2019-02-25\"]"
        },
        {
            "name": "图片",
            "value": ["http://url1","http://url2","http://url3"]
        },
        {
            "name": "附件",
            "value": [{"spaceId": "163xxxx658", "fileName": "2644.JPG", "fileSize": "333", "fileType": "jpg", "fileId": "643xxxx140"}]
        },
        {
            "name": "联系人",
            "value": "[\"4525xxxxxxxx77041\"]"
        },
        {
            "name":"关联审批单",
            "value":[
                "fa2aa864-xxxx-xxxx-xxxx-75572c0e2cdf",
                "7125778e-xxxx-xxxx-xxxx-faa987478a9b"
                
            ]
        },
        {
            "name": "明细",
            "value": [
                [
                    {
                        "name":"单行输入框",
                        "value":"明细单行输入框"
                    },
                    {
                        "name":"数字输入框",
                        "value":"100"
                    }
                    
                ]
            ]
        }
        
        
    ],
    "agent_id": 115xxxx211,
    "process_code": "PROC-37801FB3-xxxx-xxxx-xxxx-6C6ADB87CD9A",
    "cc_position": "FINISH",
    // "approvers": "4525xxxxxxxx77041,2643xxxxxxx69379",
    "cc_list": "4525xxxxxxxx77041",
    "dept_id": 70041378,
    "approvers_v2": [      //设置审批人，会签、或签设置的审批人必须大于等于2个人
         {
            "task_action_type": "AND",
            "user_ids": [
                "4525xxxxxxxx77041",
                "2643xxxxxxx69379"
            ]
        },
        {
            "task_action_type": "OR",
            "user_ids": [
                "4525xxxxxxxx77041",
                "2643xxxxxxx69379"
            ]
        }
       
    ],
    "originator_user_id": "4525xxxxxxxx77041"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'http://127.0.0.1/topapi/processinstance/create?access_token=6d1bxxxx' \
--header 'Content-Type: application/json' \
--data-raw '{
    "form_component_values": [
        {
            "name": "单行输入框",
            "value": "测试单行输入框"
        },
        {
            "name": "多行输入框",
            "value": "测试多行输入框"
        },
        {
            "name": "金额（元）大写",
            "value": "1"
        },
        {
            "name": "数字输入框",
            "value": "100"
        },
        {
            "name": "单选框",
            "value": "a"
        },
        {
            "name": "多选框",
            "value": "[\"a\",\"b\"]"
        }, 
        {
            "name": "日期",
            "value": "2021-08-17"
        },
        {
            "name": "[\"开始时间\",\"结束时间\"]",
            "value": "[\"2019-02-19\",\"2019-02-25\"]"
        },
        {
            "name": "图片",
            "value": ["http://url1","http://url2","http://url3"]
        },
        {
            "name": "附件",
            "value": [{"spaceId": "163xxxx658", "fileName": "2644.JPG", "fileSize": "333", "fileType": "jpg", "fileId": "643xxxx140"}]
        },
        {
            "name": "联系人",
            "value": "[\"4525xxxxxxxx77041\"]"
        },
        {
            "name":"关联审批单",
            "value":[
                "fa2aa864-xxxx-xxxx-xxxx-75572c0e2cdf",
                "7125778e-xxxx-xxxx-xxxx-faa987478a9b"
                
            ]
        },
        {
            "name": "明细",
            "value": [
                [
                    {
                        "name":"单行输入框",
                        "value":"明细单行输入框"
                    },
                    {
                        "name":"数字输入框",
                        "value":"100"
                    }
                    
                ]
            ]
        }
        
        
    ],
    "agent_id": 115xxxx211,
    "process_code": "PROC-37801FB3-xxxx-xxxx-xxxx-6C6ADB87CD9A",
    "cc_position": "FINISH",
    // "approvers": "4525xxxxxxxx77041,2643xxxxxxx69379",
    "cc_list": "4525xxxxxxxx77041",
    "dept_id": 70041378,
    "approvers_v2": [      //设置审批人，会签、或签设置的审批人必须大于等于2个人
         {
            "task_action_type": "AND",
            "user_ids": [
                "4525xxxxxxxx77041",
                "2643xxxxxxx69379"
            ]
        },
        {
            "task_action_type": "OR",
            "user_ids": [
                "4525xxxxxxxx77041",
                "2643xxxxxxx69379"
            ]
        }
       
    ],
    "originator_user_id": "4525xxxxxxxx77041"
}'

返回响应

🟢200成功

application/json

Body

errcode

number

返回码。

可选

errmsg

string

返回码描述。

可选

request_id

string

请求ID。

可选

process_instance_id

string

审批实例ID。

可选

示例

{
  "errcode": 0,
  "errmsg": "string",
  "request_id": "string",
  "process_instance_id": "string"
}

说明#

权限#

请求参数

示例代码

返回响应

说明

权限