查询小店礼物活动列表 | 微信开放文档

# 查询小店礼物活动列表

通过该接口查询小店授权送礼活动列表。

# 接口调用请求说明

POST https://api.weixin.qq.com/channels/ec/b2c/activity/list/promoter/get?access_token=ACCESS_TOKEN

# 请求参数说明

参数	类型	是否必填	描述
offset	number	是	偏移量
limit	number	是	单次请求个数，最大为100
shop_appid	string	否	小店appid
status	number	否	活动状态：1 未开始，2 进行中，4 已开奖，5 失效

# 请求参数示例

{
    "offset": 0,
    "limit": 100
}

# 返回参数说明

参数	类型	描述
errcode	number	错误码
errmsg	string	错误信息
list[].shop_appid	string	小店appid
list[].shop_nickname	string	小店昵称
list[].activity_id	string	小店活动id
list[].status	number	活动状态
total_num	string	总数

# 返回参数示例

{
    "errcode": 0,
    "errmsg": "ok",
    "list": [
        {
            "shop_appid": "wxxxxxxxxxxxxxxxxx",
            "shop_nickname": "小店昵称",
            "activity_id": "111"
        },
        {
            "shop_appid": "wxxxxxxxxxxxxxxxxx",
            "shop_nickname": "小店昵称",
            "activity_id": "222"
        }
    ],
    "total_num": 2
}

# 错误码

错误码	错误描述
详见通用错误码	-
40097	参数错误
10020002	非法的limit参数，应该小于等于100
10028004	推广者账号送礼被封禁