更新待办任务
用于通过开发者接口更新待办任务。
请求说明
| 请求地址 | 配置域名+/o/woa + /api/v1/task_center/developer/tasks/ |
|---|---|
| 请求方法 | PUT |
| 签名方式 | wps-4 |
| 支持应用类型 | 企业自建应用、第三方企业应用 |
| 权限要求 | 更新待办信息(kso.task.write) |
请求头
| 名称 | 是否必填 | 说明 |
|---|---|---|
| Content-Type | 是 | 固定为: application/json |
| Wps-Docs-Date | 是 | 取当前时间, 示例: Wed, 23 Jan 2013 06:43:08 GMT |
| Wps-Docs-Authorization | 是 | 计算方法参考签名说明 |
| Authorization | 是 | access_token(企业授权获取的token) |
路径参数(Path)
| 名称 | 参数类型 | 是否必填 | 说明 |
|---|---|---|---|
| taskid | integer | 是 | 待办ID |
请求体(Body)
| 名称 | 参数类型 | 是否必填 | 说明 |
|---|---|---|---|
| prefix | string | 否 | 前缀(最大长度20) |
| subject | string | 否 | 标题(最大长度200) |
| description | string | 否 | 描述(最大长度500) |
| category | integer | 否 | 分类ID |
| due_time | integer | 否 | 截止时间(毫秒) |
| finish_time | integer | 否 | 完成时间(毫秒) |
| display_time | integer | 否 | 展示时间(毫秒) |
| link | object | 否 | 跳转链接 |
| ∟ pc_url | string | 否 | PC跳转链接 |
| ∟ app_url | string | 否 | APP跳转链接 |
| status | integer | 否 | 状态1:未完成2:已完成 |
| read | integer | 否 | 已读状态1:未读2:已读 |
| tags | []string | 否 | 标签KEY |
| priority | integer | 否 | 优先级 |
| notify_config | object | 否 | 通知设置 |
| ∟ switch | bool | 否 | 通知开关(默认开) |
| ∟ reminders | []object | 否 | 提醒设置(最多设置1条提醒) |
| ∟ ∟before_due_time | integer | 否 | 截止前N分钟提醒 |
| extra | string | 否 | 附加信息(最大长度500) |
响应体(Response)
| 名称 | 类型 | 说明 |
|---|---|---|
| result | string | 更新结果ok: 成功 |
请求参数示例
{
"prefix": "【前缀】",
"subject" : "待办test",
"description" : "描述内容",
"category": 1,
"status": 2, // 2:已完成;1:未完成
"read": 2, // 2:已读;1:未读
"due_time" : 1692872880831, // 待办截止时间
"finish_time" : 1692872880831, // 待办完成时间
"display_time": 1692872880831, // 预留展示时间
"link" : {
"pc_url" : "",
"app_url" : ""
},
"tags": ["10", "11"], // 对应后台filter_key
"priority" : 20, // 优先级
"notify_config" : {}, // 提醒设置
"extra": ""
}响应体示例
{
"result": "ok"
}