发起审批实例
POST
/topapi/processinstance/create最后修改时间:: 2 年前
责任人: 未设置
说明
调用本接口发起一个审批。
服务地址: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"
}
示例代码
返回响应
成功(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
errcode
number
返回码。
errmsg
string
返回码描述。
request_id
string
请求ID。
process_instance_id
string
审批实例ID。
示例
{
"errcode": 0,
"errmsg": "string",
"request_id": "string",
"process_instance_id": "string"
}
最后修改时间: 2 年前