# 待办中心接口
- 简要描述: 所有接口均通过加签 SDK 的方式调用 url:完整的请求路径: http://platform.assetcloud.org.cn/dev-api/ +请求路径;
# 1、新建待办任务
接口名:blade-system/api/acttodo/addacttodo 请求类型:post 请求参数:
参数 | 是否必填 | 参数名称 |
---|---|---|
todotitle | 是 | 代办标题 |
todocontent | 否 | 代办内容 |
todotype | 是 | 待办类型(1、待办;2、已办) |
pcformlink | 是 | PC 审批表单链接 |
mobileformlink | 是 | 移动端审批表单链接 |
todoperson | 是 | 待办人员 ID |
tododepartment | 否 | 待办部门 ID |
todounit | 否 | 待办单位 ID |
procid | 是 | 流程实例 ID |
ifread | 否 | 是否已阅(0、未阅;1、已阅) |
todoSendPerson | 是 | 待办发起人员 ID |
请求示例
{
"todotitle":"待办标题666",
"todocontent":"待办内容",
"todotype":1,
"pcformlink":"http://www.jd.com",
"mobileformlink":"http://m.jd.com",
"todoperson":1265453478112972802,
"tododepartment":666,
"todounit":888,
"ifread":0,
"procid":3,
"todoappid":1,
"todoappname":"待办应用名称"
}
响应结果
{
"code": 200,
"msg": "操作成功",
"success": true
}
# 2、删除 proc 所有待办任务
接口名:blade-system/api/acttodo/deleteallacttodo/{procid} 请求类型:delete 请求参数
参数 | 是否必填 | 参数名称 |
---|---|---|
procid | 是 | 流程实例 ID |
请求示例
url: blade - system / api / acttodo / deleteallacttodo / 1;
响应结果:
{
"code": 200,
"msg": "操作成功",
"success": true
}
# 3、删除该用户的 procid 的待办任务
接口名:blade-system/api/acttodo/deleteacttodo/{procid} 请求类型:delete 请求参数
参数 | 是否必填 | 参数名称 |
---|---|---|
procid | 是 | 流程实例 ID |
请求示例
url: blade - system / api / acttodo / deleteallacttodo / 1;
响应结果:
{
"code": 200,
"msg": "操作成功",
"success": true
}
# 4、修改待办任务
接口名:blade-system/api/acttodo/updateacttodo 请求类型:post 请求参数
参数 | 是否必填 | 参数名称 |
---|---|---|
todotitle | 是 | 代办标题 |
todocontent | 否 | 代办内容 |
todotype | 是 | 待办类型(1、待办;2、已办) |
pcformlink | 是 | PC 审批表单链接 |
mobileformlink | 是 | 移动端审批表单链接 |
todoperson | 是 | 待办人员 |
tododepartment | 否 | 待办部门 |
todounit | 否 | 待办单位 |
procid | 是 | 流程实例 ID |
ifread | 否 | 是否已阅(0、未阅;1、已阅) |
{
"todotitle":"待办标题666",
"todocontent":"待办内容",
"todotype":2,
"pcformlink":"http://www.jd.com",
"mobileformlink":"http://m.jd.com",
"todoperson":1265453478112972802,
"tododepartment":666,
"todounit":888,
"ifread":0,
"procid":3,
"todoappid":1,
"todoappname":"待办应用名称"
}
响应结果:
{
"code": 200,
"msg": "操作成功",
"success": true
}
# 5、查询待办任务
接口名:blade-system/api/acttodo/getallacttodo 请求方式:get 请求参数
参数 | 是否必填 | 参数名称 |
---|---|---|
current | 否 | 起始页 |
size | 否 | 每页条数 |
响应结果:
{
"code": 200,
"data": {
"current": "1",
"pages": "1",
"records": [
{
"ifread": 0,
"mobileformlink": "http://m.jd.com",
"pcformlink": "http://www.jd.com",
"procid": "3",
"recid": "718131203470790656",
"todoappid": "400",
"todoappname": "ABC",
"todocontent": "待办内容",
"tododepartment": "666",
"todoperson": "1265453478112972802",
"todotime": "2020-15-04 15:57:04",
"todotitle": "待办标题666",
"todotype": 1,
"todounit": "888"
}
],
"searchCount": true,
"size": "10",
"total": "1"
},
"msg": "操作成功",
"success": true
}
# 6、查询已办任务
接口名:blade-system/api/acttodo/getallfinishacttodo 请求方式:get 请求参数
参数 | 是否必填 | 参数名称 |
---|---|---|
current | 否 | 起始页 |
size | 否 | 每页条数 |
响应结果:
{
"code": 200,
"data": {
"current": "1",
"pages": "0",
"records": [],
"searchCount": true,
"size": "10",
"total": "0"
},
"msg": "操作成功",
"success": true
}
# 7、查询已完成任务
接口名:blade-system/api/acttodo/getallhistoryacttodo 请求方式:get 请求参数
参数 | 是否必填 | 参数名称 |
---|---|---|
current | 否 | 起始页 |
size | 否 | 每页条数 |
响应结果:
{
"code": 200,
"data": {
"current": "1",
"pages": "1",
"records": [
{
"finishtime": "2020-16-04 16:14:15",
"ifread": 0,
"mobileformlink": "http://m.jd.com",
"pcformlink": "http://www.jd.com",
"procid": "3",
"recid": "718131203470790656",
"todocontent": "待办内容",
"todotitle": "待办标题666"
}
],
"searchCount": true,
"size": "10",
"total": "1"
},
"msg": "操作成功",
"success": true
}
# 8、流程结束行为
接口名:blade-system/api/acttodo/finishproc 请求方式:get 请求参数
参数 | 是否必填 | 参数名称 |
---|---|---|
procid | 是 | 流程实例 ID |
请求示例
url: blade-system/api/acttodo/finishproc?procid=3
响应结果:
{
"code": 200,
"msg": "操作成功",
"success": true
}
# 9、新建已完成任务
接口名:blade-system/api/acttodo/addacthistory 请求方式:post 请求参数
参数 | 是否必填 | 参数名称 |
---|---|---|
todotitle | 是 | 代办标题 |
todocontent | 否 | 代办内容 |
pcformlink | 是 | PC 审批表单链接 |
mobileformlink | 是 | 移动端审批表单链接 |
starttime | 是 | 待办开始时间 |
finishtime | 是 | 待办完成时间 |
launshperson | 是 | 待办人 |
launshdepartment | 否 | 待办部门 |
launshunit | 否 | 待办单位 |
procid | 是 | 流程实例 ID |
ifread | 否 | 是否已阅(0、未阅;1、已阅) |
请求示例
{
"todotitle":"待办标题-新增已完成",
"todocontent":"待办内容",
"pcformlink":"",
"mobileformlink":"",
"starttime":"",
"finishtime":"",
"launshperson":123,
"launshdepartment":666,
"launshunit":888,
"launshappid":111,
"launshappname":"测试应用",
"ifread":0,
"procid":1,
"launshappid":1,
"launshappname":"待办应用名称"
}
响应结果:
{
"code": 200,
"msg": "操作成功",
"success": true
}
# 10、审批通过、不通过行为
接口名:blade-system/api/acttodo/approvelist 请求方式:get 请求参数
参数 | 是否必填 | 参数名称 |
---|---|---|
procid | 是 | 流程实例 ID |
pushuserid | 是 | 下一个流转节点审批人 id |
userId | 是 | 当前审批人用户 Id |
请求示例
url: blade-system/api/acttodo/approvelist?procid=1&pushuserid=111&userId=123
响应结果:
{
"code": 200,
"msg": "操作成功",
"success": true
}