更新时间:2023-04-07 GMT+08:00
分享

发起审批实例

请求方法

POST /v1.0/workflow/processInstances HTTP/1.1

Host:api.dingtalk.com

x-acs-dingtalk-access-token:String

Content-Type:application/json

{

"originatorUserId" : "String",

"processCode" : "String",

"deptId" : Long,

"microappAgentId" : Long,

"approvers" : [ {

"actionType" : "String",

"userIds" : [ "String" ]

} ],

"ccList" : [ "String" ],

"ccPosition" : "String",

"targetSelectActioners" : [ {

"actionerKey" : "String",

"actionerUserIds" : [ "String" ]

} ],

"formComponentValues" : [ {

"name" : "String",

"value" : "String"

} ],

"RequestId" : "String"

}

Header参数

名称

类型

是否必填

描述

x-acs-dingtalk-access-token

String

调用该接口的访问凭证。

Body参数

名称

类型

是否必填

描述

originatorUserId

String

审批发起人的userId。

processCode

String

审批流的唯一码。

deptId

Long

审批发起人所在的部门ID。

microappAgentId

Long

应用标识AgentId,获取方式请参考基础概念

approvers

Array

不使用审批流模板时,直接指定的审批人列表,最大列表长度:20。

说明

指定审批单的执行流程,会覆盖审批单在OA后台设置的默认流程。

ccList

Array of String

抄送人 userId。

ccPosition

String

抄送时间点,取值:

  • START:开始时抄送
  • FINISH:结束时抄送
  • START_FINISH:开始和结束时都抄送

targetSelectActioners

Array

使用审批流模板时,流程预测结果中节点规则上必填的自选操作人列表,最大列表长度:20。

说明

使用OA后台设置的默认流程,并且流程中有审批人自选节点,该参数必填。

formComponentValues

Array

表单数据内容,控件列表,最大列表长度:150。

返回参数

名称

类型

描述

instanceId

String

审批实例id。

相关文档