文档首页/华为云SparkPack解决方案/最佳实践/华为云成长型企业数字化转型包企业ERP和钉钉集成/依赖接口清单描述/钉钉OA接口/发起审批实例
更新时间：2025-12-12 GMT+08:00
查看PDF
分享

发起审批实例

请求方法

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。

父主题：钉钉OA接口

相关文档