获取组织内某人提交的任务

说明

调用本接口获取组织内某人提交的任务。
服务地址：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 参数

userId

string

用户userid。

必需

Query 参数

corpId

string

必需

组织的corpId。

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 {26}]

任务列表。

可选

actionerName

array[string]

执行人姓名。

可选

processInstanceId

string

流程实例ID。

可选

modifiedTimeGMT

string

修改时间。

可选

finishTimeGMT

string

结束时间。

可选

formUuid

string

表单ID。

可选

processInstanceStatus

string

流程实例状态。

可选

originatorDisplayName

string

发起人展示名称。

可选

dataType

string

数据类型。

可选

originatorAvatar

string

发起人头像。

可选

processInstanceStatusText

string

流程状态展示文案。

可选

actioner

array [object {18}]

任务执行者信息。

可选

processApprovedResultText

string

可选

流程审批结果文字表示。

formInstanceId

string

可选

要查询的实例的实例ID。

title

string

标题。

可选

version

integer

版本。

可选

instanceValue

string

实例数据。

可选

processApprovedResult

string

流程审批结果。

可选

createTimeGMT

string

创建时间。

可选

processId

integer

流程ID。

可选

processName

string

流程名称。

可选

processCode

string

流程编码。

可选

appType

string

应用ID。

可选

actionerId

array[string]

可选

操作者的userid。

dataMap

object

任务数据。

可选

currentActivityInstances

array [object {5}]

当前流程节点实例。

可选

originatorId

string

可选

发起人userid。

示例

{
  "totalCount": 0,
  "pageNumber": 0,
  "data": [
    {
      "actionerName": [
        "string"
      ],
      "processInstanceId": "string",
      "modifiedTimeGMT": "string",
      "finishTimeGMT": "string",
      "formUuid": "string",
      "processInstanceStatus": "string",
      "originatorDisplayName": "string",
      "dataType": "string",
      "originatorAvatar": "string",
      "processInstanceStatusText": "string",
      "actioner": [
        {
          "employeeTypeInformation": "string",
          "employeeType": "string",
          "level": "string",
          "nickName": "string",
          "orderNumber": "string",
          "pinyinNickName": "string",
          "superUserId": "string",
          "userId": "string",
          "buName": "string",
          "tbWang": "string",
          "humanResourceGroupWorkNumber": "string",
          "pinyinNameAll": "string",
          "name": "string",
          "state": "string",
          "personalPhotoUrl": "string",
          "isSystemAdmin": true,
          "email": "string",
          "personalPhoto": "string"
        }
      ],
      "processApprovedResultText": "string",
      "formInstanceId": "string",
      "title": "string",
      "version": 0,
      "instanceValue": "string",
      "processApprovedResult": "string",
      "createTimeGMT": "string",
      "processId": 0,
      "processName": "string",
      "processCode": "string",
      "appType": "string",
      "actionerId": [
        "string"
      ],
      "dataMap": {},
      "currentActivityInstances": [
        {
          "activityName": "string",
          "activityNameEn": "string",
          "activityId": "string",
          "id": 0,
          "activityInstanceStatus": "string"
        }
      ],
      "originatorId": "string"
    }
  ]
}

获取组织内某人提交的任务

说明#

权限#

错误码#

请求参数

示例代码

返回响应

说明

权限

错误码