创建待办任务

用于通过开发者接口创建待办任务。

请求说明

请求地址	配置域名+/o/woa + /api/v1/task_center/developer/tasks
请求方法	POST
签名方式	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)

请求体（Body）**

名称	参数类型	是否必填	说明
prefix	string	否	前缀（最大长度20）
subject	string	是	标题（最大长度200）
description	string	否	描述（最大长度500）
category	integer	否	分类ID
create_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
executor	integer	是	执行者
creator	integer	否	创建者
priority	integer	是	优先级
notify_config	object	否	通知设置
∟ switch	bool	否	通知开关（默认开）
∟ reminders	[]object	否	提醒设置（最多设置1条提醒）
∟ ∟before_due_time	integer	否	截止前N分钟提醒
extra	string	否	附加信息（最大长度500）
task_id	string	否	自定义待办ID （不传默认使用内部ID）

• 说明：自定义待办ID规则说明： 1、字母：大小写字母（A-Z 和 a-z） 2、数字：0-9 3、下划线：_ 4、短横线：- 5、32个字符长度。

响应体（Response）

名称	类型	说明
taskid	string	待办ID

请求参数示例

{
    "prefix": "【前缀】",
    "subject" : "标题",
    "description" : "描述内容",
    "category": 1,
    "create_time": 1692872880831, // 创建时间
    "due_time" : 1692872880831, // 待办截止时间
    "finish_time" : 1692872880831, // 待办完成时间
    "display_time": 1692872880831, // 预留展示时间
    "link" : {
        "pc_url" : "",
        "app_url" : ""
    },
    "status": 1, // 2：已完成；1：未完成
    "read": 1, // 2：已读；1：未读
    "tags": ["XF", "AS"],
    "executor" : 1, // 执行人
    "creator" : 2, // 创建人（可选）
    "priority" : 20, // 优先级
    "notify_config" : {
        "switch": true, // 推送开关（默认开）
        "reminders":[{
            "before_due_time": 30, // 截止时间前30min提醒
        }]
    }, // 提醒设置（可选，默认开）
    "extra": ""
}

响应体示例

{
    "taskid": "1001"
}