获取流程定义
GET
/v1.0/yida/processes/definitions/{processInstanceId}最后修改时间:: 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 | 通用异常信息 |
请求参数
Path 参数
processInstanceId
string
流程实例ID。
Query 参数
corpId
string
可选
组织的corpId。
groupId
string
组ID。
appType
string
应用ID。
orderNumber
string
订单号。
systemType
string
应用的秘钥。
systemToken
string
可选
应用秘钥,在应用数据中获取。
nameSpace
string
名称空间。
language
string
语言,取值:
userId
string
可选
用户的userid。
Header 参数
x-acs-dingtalk-access-token
string
必需
调用该接口的访问凭证。如何获取不同应用的凭证请参考访问凭证概述。
Body 参数application/json
object {0}
示例
{}
示例代码
返回响应
成功(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
outResult
string
审批结果,取值;
processInstanceId
string
流程实例ID。
variables
object
变量。
formUuid
string
表单ID。
processId
string
流程ID。
owners
array [object {10}]
所有者。
userInfo
string
用户信息。
tbWang
string
淘宝旺。
orderNumber
string
订单号。
departmentDescription
string
部门描述。
displayName
string
展示名称。
masterDataDepartments
array [object {8}]
主数据部门。
displayEnName
string
英文名称。
userId
string
用户userid。
personalPhoto
string
个人照片。
status
string
状态。
originator
object
创建者。
userInfo
string
用户信息。
tbWang
string
淘宝旺。
orderNumber
string
订单号。
departmentDescription
string
部门描述。
displayName
string
展示名称。
masterDataDepartments
array [object {8}]
主数据部门。
displayEnName
string
英文名称。
userId
string
可选
评论人钉钉的userId;
personalPhoto
string
个人照片。
status
string
状态。
title
string
标题。
tasks
array [object {4}]
任务列表。
actionerId
string
执行人。
activity
object
流程信息。
taskId
integer
任务ID。
status
string
任务状态。
status
string
流程实例状态。
示例
{
"outResult": "string",
"processInstanceId": "string",
"variables": {},
"formUuid": "string",
"processId": "string",
"owners": [
{
"userInfo": "string",
"tbWang": "string",
"orderNumber": "string",
"departmentDescription": "string",
"displayName": "string",
"masterDataDepartments": [
{
"humanSourceGroupOrderNumber": "string",
"deptPath": "string",
"deptName": "string",
"deptNameInEnglish": "string",
"humanSourceGroupWorkNo": "string",
"id": 0,
"masterWorkNo": "string",
"deptNo": "string"
}
],
"displayEnName": "string",
"userId": "string",
"personalPhoto": "string",
"status": "string"
}
],
"originator": {
"userInfo": "string",
"tbWang": "string",
"orderNumber": "string",
"departmentDescription": "string",
"displayName": "string",
"masterDataDepartments": [
{
"humanSourceGroupOrderNumber": "string",
"deptPath": "string",
"deptName": "string",
"deptNameInEnglish": "string",
"humanSourceGroupWorkNo": "string",
"id": 0,
"masterWorkNo": "string",
"deptNo": "string"
}
],
"displayEnName": "string",
"userId": "string",
"personalPhoto": "string",
"status": "string"
},
"title": "string",
"tasks": [
{
"actionerId": "string",
"activity": {
"activityName": "string",
"activityNameInEnglish": "string",
"activityId": "string",
"id": 0,
"activityInstanceStatus": "string"
},
"taskId": 0,
"status": "string"
}
],
"status": "string"
}
最后修改时间: 2 年前