获取组织内已完成的审批任务

说明

调用本接口获取组织内已完成的审批任务。
服务地址：api.dingtalk.com

权限

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

应用类型	是否支持	权限	API Explorer调试
企业内部应用	支持	宜搭任务读权限	API Explorer
第三方企业应用	支持	宜搭任务读权限	API Explorer
第三方个人应用	暂不支持	宜搭任务读权限	暂不支持

错误码

HttpCode	错误码	错误信息	说明
400	invalidParameter.methodInputs.invalidFormat	数据格式错误:%s	数据格式错误
400	invalidParameter.number.exceed	数字超过限制:%s	数字超过限制
400	invalidParameter.methodInputs.invalid	入参校验失败:%s	入参校验失败
400	dataNotExist.form.notExists	表单不存在:%s	表单不存在
500	dataModified.form.formAlreadyModified	实例数据已修改, 请刷新当前页面:%s	实例数据已经修改
500	unclassifiedError	异常:%s	通用异常信息

请求参数

Path 参数

corpId

string

必需

组织的corpId。

userId

string

用户userid。

必需

Query 参数

pageSize

string

分页大小。

可选

language

string

语言，取值：

可选

pageNumber

string

分页页码。

可选

keyword

string

可选

表单中组件数据模糊搜索。

appTypes

string

应用标识列表。

可选

processCodes

string

流程code列表。

可选

createFromTimeGMT

string

创建时间起始值。

可选

createToTimeGMT

string

创建时间终止值。

可选

token

string

必需

验权token。校验方式如下：md5(corpId + userId + code)。md5取32位大写值。
每个企业有自己的唯一code。

Header 参数

x-acs-dingtalk-access-token

string

必需

调用该接口的访问凭证。如何获取不同应用的凭证请参考访问凭证概述。

Body 参数application/json

object {0}

示例

{}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

totalCount

integer

总数量。

可选

pageNumber

integer

当前第几页。

可选

data

array [object {20}]

可选

已完成的审批任务列表。

originatorNickName

string

发起人昵称。

可选

processInstanceId

string

流程实例ID。

可选

originatorName

string

发起人姓名。

可选

finishTimeGMT

string

结束时间。

可选

activeTimeGMT

string

激活时间。

可选

actualActionerId

string

实际执行人ID。

可选

originatorEmail

string

发起人邮箱。

可选

title

string

标题

可选

outResultName

string

结果名称。

可选

outResult

string

审批结果，取值：

可选

originatorPhoto

string

发起人照片。

可选

taskType

string

任务类型。

可选

originatorNickNameInEnglish

string

发起人英文昵称。

可选

createTimeGMT

string

创建时间。

可选

titleInEnglish

string

标题英文。

可选

appType

string

应用ID。

可选

originatorNameInEnglish

string

发起人英文名。

可选

originatorId

string

可选

根据流程发起人工号查询。

taskId

string

任务ID。

可选

status

string

状态。

可选

示例

{
  "totalCount": 0,
  "pageNumber": 0,
  "data": [
    {
      "originatorNickName": "string",
      "processInstanceId": "string",
      "originatorName": "string",
      "finishTimeGMT": "string",
      "activeTimeGMT": "string",
      "actualActionerId": "string",
      "originatorEmail": "string",
      "title": "string",
      "outResultName": "string",
      "outResult": "string",
      "originatorPhoto": "string",
      "taskType": "string",
      "originatorNickNameInEnglish": "string",
      "createTimeGMT": "string",
      "titleInEnglish": "string",
      "appType": "string",
      "originatorNameInEnglish": "string",
      "originatorId": "string",
      "taskId": "string",
      "status": "string"
    }
  ]
}

获取组织内已完成的审批任务

说明#

权限#

错误码#

请求参数

示例代码

返回响应

说明

权限

错误码