Skip to content

列出个人待办列表

用于待办中心管理个人待办

请求说明

请求地址配置域名 + /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计算方法参考签名说明
Authorizationaccess_token(企业授权获取的token)

请求体(Body)

参数类型是否必填说明
user_idint64需要查询的用户id
countint一次返回的最少数量
offsetstring滚动翻页的偏移量

响应体

名称参数类型说明
totalinteger待办任务的总数
next_offsetstring滚动翻页的偏移量
list[]Object错误信息
 ∟ taskidstring待办ID
 ∟ prefixstring前缀
 ∟ subjectstring标题
 ∟ descriptionstring描述
 ∟ categoryinteger分类ID
 ∟ start_timeinteger开始时间(毫秒)
 ∟ due_timeinteger截止时间(毫秒)
 ∟ finish_timeinteger完成时间(毫秒)
 ∟ display_timeinteger展示时间(毫秒)
 ∟ linkobject跳转链接
   ∟ pc_urlstringPC跳转链接
   ∟ app_urlstringAPP跳转链接
 ∟ statusinteger状态1:未完成2:已完成
 ∟ readinteger已读状态1:未读2:已读
 ∟ tags[]string标签KEY
 ∟ priorityinteger优先级
 ∟ notify_configobject通知设置
   ∟ switchbool通知开关
   ∟ reminders[]object提醒设置
     ∟ before_due_timeinteger截止前N分钟提醒
 ∟ extrastring附加信息
 ∟ created_timeinteger创建时间
 ∟ modified_timeinteger修改时间
 ∟ executorinteger执行人
 ∟ creatorinteger创建人

请求地址示例

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"
}