
# 更新待办任务（新）
#### 功能介绍
用于集成WeLink待办，当电子流的某一个人完成了其审批任务，调用此接口，将待办任务变更到下一个审批人。
#### 接口约束
- **认证方式：** [access_token](https://open.welink.huaweicloud.com/docs/#/990hh0/ka0vzc/q76fsn)
- **权限申请：** 开发者在调用本接口前，需要到[开发者后台](https://open.welink.huaweicloud.com/wecode-site/index.html#/wecode/guide/guide)申请接口权限，申请流程请参考[接口权限申请](https://open.welink.huaweicloud.com/docs/#/990hh0/ka0vzc/r123qy?type=internal)
 
#### 调试
您可以在[API Explorer](https://open.welink.huaweicloud.com/apiexplorer/#/apiexplorer?type=internal&&&method=PUT&path=/todo/v2/updatetask)中调试该接口。
#### 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认证失败 |
   
