创建任务

用于对工作流任务进行创建

注意事项:

• 任务的创建人、执行人、参与人均需要有该工作流业务内的创建权限，否则将会创建失败
• 路径参数user_id和查询参数user_id_type需要匹配，否则提示“用户不存在”

请求

基本
HTTP URL	https://hi-qa.weizhipin.com/open-apis/workflow/v1/task/create/:user_id
HTTP Method	POST
支持的应用类型	自建应用
权限要求开启任一权限即可	[工作流]-[创建/编辑/查询任务]

请求头

名称	类型	必填	描述
Authorization	string	是	tenant_access_token 值格式："Bearer access_token" 示例值："Bearer t-7f1bcd13fc57d46bac21793a18e560"
Content-Type	string	是	固定值："application/json; charset=utf-8"

路径参数（url中冒号标识的参数,如":xxxx"请连同:整体替换成对应值）

名称	类型	描述
user_id	string	任务创建人id 示例值："CFBEWHDYGYGSL"

查询参数（url后?&拼接的参数）

名称	类型	描述
user_id_type	string	请求参数内用户 ID 类型示例值："open_id" 可选值有： open_id：用户的 open id union_id：用户的 union id user_id：用户的 user id 默认值：open_id 当值为 user_id时，存在字段权限要求，未开通则会调用失败： 请参见[应用权限管理]-[通讯录]- [获取用户ID]

请求体

名称	类型	必填	描述
uuid	string	是	由开发者生成的唯一字符串序列，用于发送消息请求去重；持有相同uuid的请求1小时内至多成功执行一次，示例值："a0d69e201dd1-458b-k525-dfeca4015204" 数据校验规则： 最大长度：50 字符
workflow_id	string	否	工作流id 若不填视为在用户「我的任务」中创建无工作流的任务
workflow_group_id	string	否	工作流任务分组id 需要同时传工作流id，否则视为在用户「我的任务」中创建无工作流的任务
task_title	string	是	任务标题 至多1000字
task_description	string	否	任务描述 至多1000字
task_tag	array	否	任务标签 若标签不存在则会被创建
executor	string	否	任务执行人用户id，需要与查询参数中的user_id_type类型保持一致
begin_date	string	否	任务开始日期 示例值 2023-06-01 11:22，可以不带时分传入
end_date	string	否	任务截止日期 示例值 2023-06-01 11:22，可以不带时分传入
participant	array	否	参与人用户id列表 数组，可传入多个参与人，需要与查询参数中的user_id_type类型保持一致
img_key	array	否	图片附件，数组，至多可传入9个图片
file_url	array	否	文件附件，数组，至多可传入9个文件
custom_fields_json	string	否	自定义字段json json格式字符串，按照key_value的规范进行传入，若有必填的自定义字段字段未填写时，会创建失败

响应

响应体

{
  "code": "0",
  "traceId": "",
  "data": {
    "task_id": "qwerasdfzxcv",//示例值
    "task_show_id": "123456"//示例值
  },
  "msg": "操作成功"
}

data对象结构

名称	类型	描述
task_id	string	任务标准id 用于开放平台接口请求的唯一id
task_show_id	string	任务展示id 仅用于一些业务方展示使用，无法进行任何接口调用使用

如果响应非成功状态，请对照 错误码文档