获取群打卡活动列表 - 微伴助手OpenAPI

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

错误码	说明
21601	corp_id 错误，找不到对应的企业
21602	mission_status不合法
21603	start_time 不合法
21604	end_time 不合法
21605	order 不合法
21606	limit 不合法
21607	offset 不合法
调用此接口需购买营销席位。

请求参数

Query 参数

name

string

可选

活动名称，支持模糊查询

示例值:

活动6

mission_status

string

可选

活动状态(end表示活动结束

示例值:

ongoing

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 (MissionList) {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_ids

array[string]

可选

使用该活动的员工id列表

status

string

活动状态

必需

tags

array[integer]

标签的id列表

可选

total

integer

活动总数

必需

示例

{
    "errcode": 0,
    "errmsg": "ok",
    "mission_list": [
        {
            "id": 40,
            "name": "老夫的第二个活动",
            "creator": "严志鹏",
            "created_at": 1598967859,
            "status": "end"
        },
        {
            "id": 41,
            "name": "汪健测试用的打卡,不要改啊 ",
            "creator": "严志鹏",
            "created_at": 1599029494,
            "status": "ongoing"
        },
        {
            "id": 44,
            "name": "付英杰的测试",
            "creator": "严志鹏",
            "created_at": 1599048979,
            "status": "end"
        },
        {
            "id": 57,
            "name": "测试最大打卡人数",
            "creator": "严志鹏",
            "created_at": 1599135545,
            "status": "ongoing"
        },
        {
            "id": 58,
            "name": "爱仕达所大所",
            "creator": "严志鹏",
            "created_at": 1599136270,
            "status": "ongoing"
        },
        {
            "id": 59,
            "name": "sadsaf",
            "creator": "严志鹏",
            "created_at": 1599136434,
            "status": "ongoing"
        },
        {
            "id": 60,
            "name": "asdf",
            "creator": "严志鹏",
            "created_at": 1599136478,
            "status": "ongoing"
        },
        {
            "id": 61,
            "name": "zs的活动",
            "creator": "严志鹏",
            "created_at": 1599136690,
            "status": "ongoing"
        },
        {
            "id": 62,
            "name": "dasdas",
            "creator": "严志鹏",
            "created_at": 1599136983,
            "status": "ongoing"
        },
        {
            "id": 63,
            "name": "打撒大撒多",
            "creator": "严志鹏",
            "created_at": 1599137633,
            "status": "end"
        },
        {
            "id": 65,
            "name": "123123",
            "creator": "严志鹏",
            "created_at": 1599141098,
            "status": "ongoing"
        },
        {
            "id": 66,
            "name": "测试修改",
            "creator": "严志鹏",
            "created_at": 1599188360,
            "status": "ongoing"
        },
        {
            "id": 67,
            "name": "fuyingjie",
            "creator": "严志鹏",
            "created_at": 1599195448,
            "status": "ongoing"
        },
        {
            "id": 68,
            "name": "22",
            "creator": "严志鹏",
            "created_at": 1599198305,
            "status": "end"
        },
        {
            "id": 69,
            "name": "1",
            "creator": "严志鹏",
            "created_at": 1599201798,
            "status": "ongoing"
        },
        {
            "id": 70,
            "name": "1",
            "creator": "严志鹏",
            "created_at": 1599202508,
            "status": "end"
        },
        {
            "id": 71,
            "name": "12222",
            "creator": "严志鹏",
            "created_at": 1599203254,
            "status": "ongoing"
        },
        {
            "id": 72,
            "name": "jiejiejie",
            "creator": "严志鹏",
            "created_at": 1599203320,
            "status": "ongoing"
        },
        {
            "id": 73,
            "name": "12",
            "creator": "严志鹏",
            "created_at": 1599203472,
            "status": "ongoing"
        },
        {
            "id": 74,
            "name": "jiejie2",
            "creator": "严志鹏",
            "created_at": 1599203481,
            "status": "ongoing"
        },
        {
            "id": 75,
            "name": "12",
            "creator": "严志鹏",
            "created_at": 1599205636,
            "status": "ongoing"
        },
        {
            "id": 76,
            "name": "12",
            "creator": "严志鹏",
            "created_at": 1599205728,
            "status": "ongoing"
        },
        {
            "id": 77,
            "name": "大海捞针",
            "creator": "严志鹏",
            "created_at": 1599206080,
            "status": "end"
        },
        {
            "id": 78,
            "name": "海底捞针",
            "creator": "严志鹏",
            "created_at": 1599206690,
            "status": "ongoing"
        },
        {
            "id": 79,
            "name": "大海捞针",
            "creator": "严志鹏",
            "created_at": 1599208603,
            "status": "ongoing"
        },
        {
            "id": 80,
            "name": "发1111",
            "creator": "严志鹏",
            "created_at": 1599208818,
            "status": "end"
        },
        {
            "id": 81,
            "name": "Justin",
            "creator": "严志鹏",
            "created_at": 1599212291,
            "status": "end"
        },
        {
            "id": 82,
            "name": "2323",
            "creator": "严志鹏",
            "created_at": 1599212873,
            "status": "ongoing"
        },
        {
            "id": 83,
            "name": "1",
            "creator": "严志鹏",
            "created_at": 1599216542,
            "status": "end"
        },
        {
            "id": 84,
            "name": "1",
            "creator": "严志鹏",
            "created_at": 1599220524,
            "status": "ongoing"
        }
    ],
    "total": 325
}

🟢200正常返回