更新待办任务(新)
功能介绍
用于集成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认证失败 |

