列出个人待办列表
用于待办中心管理个人待办
请求说明
| 请求地址 | 配置域名 + /o/woa + /api/v1/task_center/developer/tasks/list |
|---|---|
| 请求方法 | POST |
| 签名方式 | wps-4 |
| 支持应用类型 | 企业自建应用、第三方企业应用 |
| 权限要求 | 查询企业内用户待办(kso.task.admin) |
请求头
| Header名称 | 是否必填 | 说明 |
|---|---|---|
| Content-Type | 是 | 目前固定为:"application/json" |
| Wps-Docs-Date | 是 | 取当前时间, 示例: Wed, 23 Jan 2013 06:43:08 GMT |
| Wps-Docs-Authorization | 是 | 计算方法参考签名说明 |
| Authorization | 是 | access_token(企业授权获取的token) |
请求体(Body)
| 参数 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| user_id | int64 | 是 | 需要查询的用户id |
| count | int | 否 | 一次返回的最少数量 |
| offset | string | 否 | 滚动翻页的偏移量 |
响应体
| 名称 | 参数类型 | 说明 |
|---|---|---|
| total | integer | 待办任务的总数 |
| next_offset | string | 滚动翻页的偏移量 |
| list | []Object | 错误信息 |
| ∟ taskid | string | 待办ID |
| ∟ prefix | string | 前缀 |
| ∟ subject | string | 标题 |
| ∟ description | string | 描述 |
| ∟ category | integer | 分类ID |
| ∟ start_time | integer | 开始时间(毫秒) |
| ∟ 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 | 提醒设置 |
| ∟ before_due_time | integer | 截止前N分钟提醒 |
| ∟ extra | string | 附加信息 |
| ∟ created_time | integer | 创建时间 |
| ∟ modified_time | integer | 修改时间 |
| ∟ executor | integer | 执行人 |
| ∟ creator | integer | 创建人 |
请求地址示例
http
[POST] 配置域名+/o/woa//api/v1/task_center/developer/tasks/list请求体示例
json
{
"user_id": 1,
"count": 1,
"offset": "1715677200000,1715676029000,331342"
}响应体示例
json
{
"total": 203,
"list": [
{
"taskid": "331350",
"corpid": 1,
"creator": 1,
"creator_name": "admin",
"executor": 1,
"executor_name": "admin",
"appid": "woa-task-center",
"app_name": "待办中心",
"avatar": "",
"app_info_id": 0,
"category": 0,
"category_name": "",
"prefix": "",
"subject": "333",
"description": "",
"status": 2,
"read": 1,
"priority": 1,
"priority_name": "",
"tags": [],
"start_time": 0,
"due_time": 1715680800000,
"finish_time": 1716543869349,
"display_time": 0,
"link": {
"pc_url": "ksoxz://xz.wps.cn/todo-detail?taskId=48162&teamId=1",
"app_url": "ksoxz://xz.wps.cn/todo-detail?taskId=48162&teamId=1"
},
"notify_config": {
"switch": true,
"reminders": [
{
"before_due_time": 15
}
]
},
"extra": "{\"taskId\":48162}",
"created_time": 1715658080000,
"modified_time": 1716538800312
}
],
"next_offset": "1715680800000,1715658080000,331350"
}