分页获取群发任务列表接口
最后更新:2023/6/15企业可通过该接口分页获取群发任务列表结果
请求方式: POST(HTTPS)
请求地址: https://open.wshoto.com/openapi/mass_send/corp/get_mass_task_info_list_page?access_token=x
Query参数:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
access_token | string | 是 | 调用接口凭证 |
Body参数:
{
"types": [
10
],
"start_time": 1679220074,
"end_time": 1681898475,
"create_start_time": 1679220074,
"create_end_time": 1681898475,
"user_ids": [
"fake_data"
],
"task_status": [
1
],
"task_name": "fake_data",
"current_index": 1,
"page_size": 50
}
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
types | array | 是 | 群发任务类型集合,群发任务类型为int. 10:企业群发客户,11.企业群发客户群;12.企业群发朋友圈;13.个人群发客户;14.个人群发客户群;15.个人群发朋友圈; |
start_time | long | 否 | 发送开始时间,类型:时间戳,精度:秒.开始时间和结束时间同时为空或同时不为空,且间隔不能超过3个月 |
end_time | long | 否 | 发送结束时间,类型:时间戳,精度:秒.开始时间和结束时间同时为空或同时不为空,且间隔不能超过3个月 |
create_start_time | long | 否 | 创建开始时间,类型:时间戳,精度:秒.开始时间和结束时间同时为空或同时不为空,且间隔不能超过3个月 |
create_end_time | long | 否 | 创建结束时间,类型:时间戳,精度:秒.开始时间和结束时间同时为空或同时不为空,且间隔不能超过3个月 |
user_ids | array | 否 | 员工ID集合,员工ID类型为string |
task_status | array | 否 | 任务状态集合,任务状态类型为int. 0.未开始;1.创建中;2.进行中;3.已结束;4.已失效;-1.创建失败; |
task_name | string | 否 | 任务名称模糊检索 |
current_index | int | 否 | 当前页,最小为1,默认为1 |
page_size | int | 否 | 每页大小,最小为1,最大为100,默认为20 |
返回值:
{
"code": 0,
"msg": "请求成功",
"data": {
"total": 100,
"records": [
{
"task_id": 15,
"task_name": "fake_data",
"type": 67,
"task_status": 12,
"complete_rate": 5,
"create_time": 176434334534,
"start_time": 176434334534,
"end_time": 176434334534,
"user_id": "fake_data",
"plan_staff_qty": 8,
"success_staff_qty": 6,
"content": "content"
}
]
}
}
返回说明:
参数 | 类型 | 说明 |
---|---|---|
code | int | 出错返回码,为0表示成功,非0表示调用失败 |
msg | string | 返回码描述 |
data | page | 分页对象 |
total | int | 总条数 |
records | object[] | 数据列表 |
task_id | long | 群发任务id |
task_name | string | 群发任务名称 |
type | int | 群发类型 10:企业群发客户,11.企业群发客户群;12.企业群发朋友圈;13.个人群发客户;14.个人群发客户群;15.个人群发朋友圈; |
task_status | int | 任务状态 0.未开始;1.创建中;2.进行中;3.已结束;4.已失效;-1.创建失败; |
complete_rate | int | 完成率,范围0~100 |
create_time | long | 创建时间,类型:时间戳,精度:秒. |
start_time | long | 开始时间,类型:时间戳,精度:秒. |
end_time | long | 结束时间,类型:时间戳,精度:秒. |
user_id | string | 员工ID |
plan_staff_qty | int | 预计执行员工数 |
success_staff_qty | int | 成功下发员工任务数 |
content | string | 发送文本内容 |