获取群裂变活动列表 - 微伴助手OpenAPI

获取活动列表。可以通过调整 query 参数满足不同维度的筛选需求。列表按照任务id从小到大进行排序。列表可根据任务创建时间进行筛选。

错误码	说明
21501	corp_id 错误，找不到对应的企业
21502	mission_status不合法
21503	start_time 不合法
21504	end_time 不合法
21505	order 不合法
21506	limit 不合法
21507	offset 不合法
调用此接口需购买营销席位。

请求参数

Query 参数

name

string

可选

活动名称，支持模糊查询

示例值:

活动1

mission_status

string

可选

活动状态(end表示活动结束,ongoing表示活动进行中)

示例值:

end

start_time

string

可选

更新时间筛选开始时间

示例值:

1592576435

end_time

string

可选

更新时间筛选结束时间

示例值:

1592576420

order

string

可选

排序按照微伴系统收录活动时间升序或降序增加排序参数 order，可选值是 asc(升序) 和 desc(降序)，默认值是 asc

示例值:

asc

limit

string

可选

列表返回长度。默认值为30，最大值为100

示例值:

offset

string

可选

表偏移。用于迭代获取所有数据，默认值为0

示例值:

access_token

string

调用接口凭证

必需

默认值:

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

errcode

integer

必需

状态码，0为正常，非0代表错误。

errmsg

string

必需

错误信息，成功时为'ok'，错误时会以中文方式显示错误原因

mission_list

array [object {11}]

活动列表

必需

af_type

string

可选

qywx企业微信，mp企业微信+公众号

created_at

integer

必需

活动创建时间（微伴系统内时间）

integer

活动id

必需

invited_count

integer

扫码添加人数

可选

name

string

活动名称

必需

new_user_count

integer

新用户数

可选

outflow_count

integer

用户流失数

可选

prize_rule

array[object (PrizeRule) {4}]

领奖规则列表

可选

staff_ext_ids

array[string]

可选

使用该活动的员工id列表

status

string

活动状态

必需

tags

array[integer]

标签的id列表

可选

total

integer

活动总数

必需

示例

{
  "errcode": 0,
  "errmsg": "ok",
  "mission_list": [
    {
      "created_at": 1614928752,
      "id": 90,
      "name": "测试完成活动",
      "staff_ext_ids": [
        "HanXianZhao"
      ],
      "status": "end"
    },
    {
      "created_at": 1614929198,
      "id": 91,
      "name": "测试活动",
      "staff_ext_ids": [
        "HanXianZhao"
      ],
      "status": "end"
    },
    {
      "created_at": 1614936365,
      "id": 99,
      "name": "21312",
      "staff_ext_ids": [],
      "status": "end"
    },
    {
      "created_at": 1614937644,
      "id": 100,
      "name": "差不多的拉群",
      "staff_ext_ids": [],
      "status": "end"
    },
    {
      "created_at": 1614942763,
      "id": 101,
      "name": "随便建一个",
      "staff_ext_ids": [],
      "status": "end"
    },
    {
      "created_at": 1614943423,
      "id": 102,
      "name": "哈哈哈哈",
      "staff_ext_ids": [],
      "status": "end"
    },
    {
      "created_at": 1614943468,
      "id": 103,
      "name": "1212",
      "staff_ext_ids": [],
      "status": "end"
    },
    {
      "created_at": 1614943643,
      "id": 105,
      "name": "12313",
      "staff_ext_ids": [],
      "status": "end"
    },
    {
      "created_at": 1614943885,
      "id": 107,
      "name": "裂变的嘛",
      "staff_ext_ids": [],
      "status": "end"
    },
    {
      "created_at": 1614953793,
      "id": 108,
      "name": "你挑的嘛",
      "staff_ext_ids": [],
      "status": "end"
    },
    {
      "created_at": 1614999460,
      "id": 112,
      "name": "1222",
      "staff_ext_ids": [],
      "status": "end"
    },
    {
      "created_at": 1615002310,
      "id": 113,
      "name": "怎么说呢",
      "staff_ext_ids": [],
      "status": "end"
    },
    {
      "created_at": 1615014490,
      "id": 115,
      "name": "12312312",
      "staff_ext_ids": [],
      "status": "end"
    },
    {
      "created_at": 1615015299,
      "id": 117,
      "name": "随便一个活动",
      "staff_ext_ids": [],
      "status": "end"
    },
    {
      "created_at": 1615016609,
      "id": 118,
      "name": "甘桑的专属活动",
      "staff_ext_ids": [],
      "status": "end"
    },
    {
      "created_at": 1615029458,
      "id": 122,
      "name": "新活动的嘛",
      "staff_ext_ids": [],
      "status": "end"
    },
    {
      "created_at": 1615030280,
      "id": 123,
      "name": "新的有问题吧",
      "staff_ext_ids": [],
      "status": "end"
    },
    {
      "created_at": 1615031191,
      "id": 124,
      "name": "11111",
      "staff_ext_ids": [
        "FaJieZhongSheng",
        "YangFan"
      ],
      "status": "end"
    },
    {
      "created_at": 1615031609,
      "id": 125,
      "name": "回归活动",
      "staff_ext_ids": [],
      "status": "end"
    },
    {
      "created_at": 1615031951,
      "id": 126,
      "name": "11111????",
      "staff_ext_ids": [
        "FaJieZhongSheng",
        "YangFan"
      ],
      "status": "end"
    },
    {
      "created_at": 1615032830,
      "id": 128,
      "name": "记得记得",
      "staff_ext_ids": [],
      "status": "end"
    },
    {
      "created_at": 1615085636,
      "id": 129,
      "name": "12314125",
      "staff_ext_ids": [],
      "status": "end"
    },
    {
      "created_at": 1615089357,
      "id": 130,
      "name": "记得记得的",
      "staff_ext_ids": [],
      "status": "end"
    },
    {
      "created_at": 1615098633,
      "id": 131,
      "name": "活动结束的啦",
      "staff_ext_ids": [],
      "status": "end"
    },
    {
      "created_at": 1615099151,
      "id": 132,
      "name": "2121",
      "staff_ext_ids": [],
      "status": "end"
    },
    {
      "created_at": 1615099595,
      "id": 133,
      "name": "重复的呢",
      "staff_ext_ids": [],
      "status": "end"
    },
    {
      "created_at": 1615099644,
      "id": 134,
      "name": "我顶我顶",
      "staff_ext_ids": [],
      "status": "end"
    },
    {
      "created_at": 1615101659,
      "id": 135,
      "name": "测试客服",
      "staff_ext_ids": [
        "chengyong"
      ],
      "status": "end"
    },
    {
      "created_at": 1615106843,
      "id": 136,
      "name": "SJISJI",
      "staff_ext_ids": [
        "chengyong",
        "ok",
        "YangFan"
      ],
      "status": "end"
    },
    {
      "created_at": 1615110594,
      "id": 137,
      "name": "上灰测",
      "staff_ext_ids": [
        "chengyong"
      ],
      "status": "end"
    }
  ],
  "total": 296
}

🟢200正常返回