Skip to content

查询待办任务

用于通过开发者接口查询待办任务。

请求说明

请求地址配置域名+/o/woa + /api/v1/task_center/developer/tasks/
请求方法GET
签名方式wps-4
支持应用类型企业自建应用、第三方企业应用
权限要求查询待办信息(kso.task.read)

请求头

名称是否必填说明
Content-Type固定为: application/json
Wps-Docs-Date取当前时间, 示例: Wed, 23 Jan 2013 06:43:08 GMT
Wps-Docs-Authorization计算方法参考签名说明
Authorizationaccess_token(企业授权获取的token)

路径参数(Path)

名称参数类型是否必填说明
taskidinteger待办ID

响应体(Response)

名称参数类型说明
taskidstring待办ID
prefixstring前缀
subjectstring标题
descriptionstring描述
categoryinteger分类ID
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附加信息

响应体示例

{
    "taskid": "10051",
    "prefix": "【前缀】",
    "subject": "待办",
    "description": "描述",
    "category": 2,
    "start_time": 0,
    "due_time": 1694742300000,
    "finish_time": 0,
    "display_time": 0,
    "status": 1,
    "link": {
        "pc_url": "https://www.baidu.com",
        "app_url": "https://www.baidu.com"
    },
    "tags": [
        "OPJKm514K9bL"
    ],
    "created_time": 1694742060258,
    "modified_time": 1694742060258,
    "executor": 1,
    "creator": 100000010016,
    "priority": 1,
    "notify_config": {
        "switch": true,
        "reminders": [
            {
                "before_due_time": 1
            }
        ]
    },
    "extra": ""
}