# 获取任务列表
# 请求方式
POST
# 请求地址
https://nbd-api.myscrm.cn/open-nbd-qw-job/v1/add-contact-task/get-task-list
# 请求参数说明
参数 | 类型 | 必须 | 说明 |
---|---|---|---|
app_id | string | 是 | 企微中台应用 id |
project_ids | []string | 是 | 关联项目 id |
status | []int32 | 否 | 任务状态 |
begin_time | string | 否 | 任务开始时间 |
end_time | string | 否 | 任务结束时间 |
task_name | string | 否 | 任务名称 |
user_ids | []string | 否 | 用户 id |
template_tag | string | 是 | 模板 tag,manager_task_detail:管理者,member_task_detail:普通成员 |
page | int32 | 否 | 页码,默认为 1 |
page_size | int32 | 否 | 页码,默认为 10 |
# 请求参数示例
{
"app_id": "5a040281-c86c-1298-5042-f9fa69177ed3",
"project_ids": ["39d58a24-f87e-9dd0-ba43-fb175d799595"],
"user_ids": ["89d58a24-f87e-9dd0-ba43-fb175d799595"],
"status": [1, 3],
"template_tag": "member_task_detail",
"page": 1,
"page_size": 10,
"begin_time": "2022-05-20",
"end_time": "2022-05-31"
}
# 返回数据
{
"list": [
{
"task_id": "3a04026a-9a3a-03e3-7dd6-8fe96e3ef8d9",
"task_name": "小老虎",
"type_name": "导入电话加客",
"status": 3,
"begin_time": "2022-05-23 17:30:16",
"end_time": "2022-05-23 17:30:16",
"task_progress": 2.1,
"project_id": "39d58a24-f87e-9dd0-ba43-fb175d799595",
"project_name": "小老虎项目",
"user_id": "49d58a24-f87e-9dd0-ba43-fb175d799598",
"completion_quantity": 1,
"wait_completion_quantity": 1,
"is_finish": 0,
"target_quantity": 1
}
],
"total": 1
}
# 返回参数说明
参数 | 类型 | 必须 | 说明 |
---|---|---|---|
total | int32 | 是 | 总数 |
list.task_id | string | 是 | 任务 id |
list.task_name | string | 是 | 任务名称 |
list.type_name | string | 是 | 任务类型名称 |
list.status | int32 | 是 | 任务状态 :0 未发布, 1 已发布未开始, 2 已发布进行中, 3 已发布已结束 |
list.begin_time | string | 是 | 任务开始时间 ,比如:2022-06-07 13:30:37 |
list.end_time | string | 是 | 任务结束时间 ,比如:2022-06-08 13:30:37 |
list.task_progress | double | 是 | 任务进度 |
list.project_id | string | 是 | 关联的项目 ID |
list.project_name | string | 是 | 项目名称 |
list.user_id | string | 是 | 用户 ID |
list.completion_quantity | int32 | 是 | 已完成人数 |
list.wait_completion_quantity | int32 | 是 | 等待完成人数 |
list.is_finish | int32 | 是 | 员工是否完成 0 是未完成,1 是已完成 |
list.target_quantity | int32 | 是 | 目标完成人数 |
获取任务详情 →