获取任务列表(组织维度)
GET
/v1.0/yida/corpTasks最后修改时间:: 2 年前
责任人: 未设置
说明
调用本接口获取组织维度任务列表。
服务地址: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 | 通用异常信息 |
请求参数
Query 参数
corpId
string
组织corpId。
pageSize
string
分页大小。
language
string
语言,取值:
pageNumber
string
分页页码。
keyword
string
可选
表单中组件数据模糊搜索。
appTypes
string
应用标识列表。
processCodes
string
流程code列表。
createFromTimeGMT
string
创建时间起始值。
createToTimeGMT
string
创建时间终止值。
userId
string
必需
用户的userid。
token
string
必需
验权token。校验方式如下:md5(corpId + userId + code)。md5取32位大写值。
每个企业有自己的唯一code。
Header 参数
x-acs-dingtalk-access-token
string
必需
调用该接口的访问凭证。如何获取不同应用的凭证请参考访问凭证概述。
Body 参数application/json
object {0}
示例
{}
示例代码
返回响应
成功(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
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
任务类型。
originatorNickNameEn
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",
"originatorNickNameEn": "string",
"createTimeGMT": "string",
"titleInEnglish": "string",
"appType": "string",
"originatorNameInEnglish": "string",
"originatorId": "string",
"taskId": "string",
"status": "string"
}
]
}
最后修改时间: 2 年前