更新待办任务(新)
功能介绍
用于集成WeLink待办,当电子流的某一个人完成了其审批任务,调用此接口,将待办任务变更到下一个审批人。
接口约束
- 认证方式: access_token
- 权限申请: 开发者在调用本接口前,需要到开发者后台申请接口权限,申请流程请参考接口权限申请
调试
您可以在API Explorer中调试该接口。
URL
PUT https://open.welink.huaweicloud.com/api/todo/v2/updatetask
请求消息
请求头部见表1
表1请求头部
参数 |
是否必选 |
参数类型 |
描述(值) |
---|---|---|---|
x-wlk-Authorization |
是 |
String |
access_token |
请求参数见表2
表2请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
taskId |
是 |
String |
租户应用任务id |
userId |
是 |
String |
任务的当前处理人账号 |
userNameCn |
是 |
String |
待办任务的当前处理人中文名字 |
userNameEn |
是 |
String |
待办任务的当前处理人英文名字 |
响应消息
{ "code": "0", "message": "更新待办任务成功!", "data": { "taskId": "5", "uuid": "374731891993001984", "taskTitle": "周五上午请假", "taskDesc": "周五上午请假", "userTaskCompleteUuid": 0, "userId": "zhangsan@dd", "detailsUrl": "https://welink.example.cn/todo/v1/appList", "appName": "请假申请", "lastModifyTime": "2019-12-01 18:00:00", "createTime": "2019-12-01 18:00:00", "tenantId": "8C109D2A76604639BAAA582C75779WDS", "applicantUserId": "lisi@dd", "applicantUserNameCn": "李四", "applicantUserNameEn": "lisi", "isMsg":1, "isShowApplicantUserName":true, "applicantId":"test11111", "userNameCn":"张三", "userNameEn":"zhangsan" } }
请求示例
- 请求URL示例
curl -X PUT 'https://open.welink.huaweicloud.com/api/todo/v2/updatetask?taskId=5&userId=zhangsan@dd&userNameCn=张三&userNameEn=zhangsan' -H 'Content-Type: application/json' -H 'x-wlk-Authorization: access_token'
返回值
返回参数说明:
参数 |
必选 |
参数类型 |
说明 |
---|---|---|---|
code |
是 |
String |
数据正常返回“0”,如果发生错误,会返回对应的错误码 |
message |
是 |
String |
返回信息,包括接口请求发生错误时的详细信息 |
data |
是 |
Object |
调用成功时表示调用结果,详见data数据结构。 |
data 数据结构
参数 |
必选 |
参数类型 |
说明 |
---|---|---|---|
taskId |
是 |
String |
租户应用任务id |
uuid |
是 |
String |
待办唯一主键 |
taskTitle |
是 |
String |
审批任务标题。 |
userId |
是 |
String |
任务的当前处理人的账号id |
userNameCn |
是 |
String |
任务的当前处理人的中文名字 |
userNameEn |
是 |
String |
任务的当前处理人的英文名字 |
appName |
是 |
String |
应用名称 |
detailsUrl |
是 |
String |
待办详情查看路径 |
applicantUserId |
是 |
String |
申请人账号id |
applicantUserNameCn |
是 |
String |
申请人中文名字 |
applicantUserNameEn |
是 |
String |
申请人英文名称 |
tenantId |
是 |
String |
租户ID |
isShowApplicantUserName |
否 |
Boolean |
申请人显示标识 |
isMsg |
否 |
Int |
发送消息通知标识 |
applicantId |
是 |
String |
申请ID,同一条申请,推送多人,该值相同 |
createTime |
是 |
String |
待办创建时间 |
lastModifyTime |
是 |
String |
待办更新时间 |
userTaskCompleteUuid |
否 |
String |
任务状态 |
taskDesc |
否 |
String |
任务描述 |
错误码
错误码 |
说明 |
---|---|
0 |
成功 |
55002 |
没有操作权限 |
55008 |
待办ID不存在 |
55012 |
认证服务异常 |
55014 |
token认证失败 |