转交OA审批任务

**
接口调用量说明**钉钉标准版接口累计可调用次数为1万次/月，当前接口会消耗调用次数。若该调用量无法满足需求，你可升级钉钉专业版(Open API调用量50万次/月)或钉钉专属版(Open API调用量500万次/月)扩容调用次数。

调用本接口，转交OA审批任务。

接口功能介绍

调用本接口，当前审批人可以将审批单转交给另一个人处理。接口调用成功后，与下图操作实现的效果一致。

接口调用说明

添加审批附件需将文件上传至审批钉盘空间，可以获取到接口参数spaceId，fileType，fileName，fileId，fileSize。获取方式如下：

1.调用获取审批钉盘空间信息接口，获取钉盘空间的上传权限，并获取审批钉盘空间spaceId。

2.根据审批钉盘空间spaceId，调用H5微应用上传附件到钉盘/从钉盘选择文件或者小程序上传附件到钉盘/从钉盘选择文件后获取钉盘附件file的信息。

说明

本接口仅支持通过官方审批发起的或原生审批流程任务，不支持自有审批创建的实例任务。

权限

要调用此API，需要以下权限之一。

应用类型	是否支持	权限	API Explorer调试
企业内部应用	支持	工作流实例写权限	API Explorer
第三方企业应用	支持	工作流实例写权限	API Explorer
第三方个人应用	暂不支持	工作流实例写权限	暂不支持

错误码

HttpCode	错误码	错误信息	说明
400	param.blank	%s参数不能为空	toUserId参数不能为空
400	param.illegal	不合法的参数%s	不合法的参数taskId
400	task.status.error	当前任务状态不是运行中不支持转交操作	当前任务状态不是运行中不支持转交操作
400	instance.status.error	当前流程实例状态不是运行中不支持转交操作	当前流程实例状态不是运行中不支持转交操作
400	param.illegal.operator	不合法的参数operateUserId	不合法的参数operateUserId
400	internalError	%s	系统内部异常
500	system.error	系统错误	系统错误

请求参数

Header 参数

Body 参数application/json

示例

{
  "taskId" : Long,
  "toUserId" : "String",
  "remark" : "String",
  "operateUserId" : "String",
  "actionName" : "String",
  "file" : {
    "photos" : [ "String" ],
    "attachments" : [ {
      "spaceId" : "String",
      "fileSize" : "String",
      "fileId" : "String",
      "fileName" : "String",
      "fileType" : "String"
    } ]
  }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

接口功能介绍#

接口调用说明#

权限#

错误码#

请求参数

请求示例代码

返回响应

接口功能介绍

接口调用说明

权限

错误码