查询礼物活动详情 | 微信开放文档

# 查询礼物活动详情

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

# 接口调用请求说明

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

# 请求参数说明

参数	类型	是否必填	描述
shop_appid	string	是	小店appid
activity_id	string	是	小店活动id

# 请求参数示例

{
    "shop_appid": "wxxxxxxxxxxxxxxxxx",
    "activity_id": "111"
}

# 返回参数说明

参数	类型	描述
errcode	number	错误码
errmsg	string	错误信息
activity.activity_id	string	活动id
activity.info.basic_info	BasicInfo	活动基础信息
activity.info.prize_info.product_info_list	array	活动礼物商品信息
activity.status	number	活动状态：1 未开始，2 进行中，4 已开奖，5 失效

# 返回参数示例

{
    "errcode": 0,
    "errmsg": "ok",
    "activity": {
        "activity_id": "111",
        "info": {
            "basic_info": {
                "activity_start_time": "1745856000",
                "activity_end_time": "1746028800",
                "shop_info": {
                    "nickname": "小店昵称",
                    "appid": "wxxxxxxxxxxxxxxxxx"
                }
            },
            "prize_info": { 
                "product_info_list": [
                    {
                        "product_id": "111111111111111",
                        "sku_id": "2222222222",
                        "product_img_url": "https://res.wx.qq.com/op_res/1UTAKQSOJopJ5uMwT8EKEWPgJ1RjiMm8XC93FVwJ6GZlPmfXBjqkwVz8QvO985FR-IWAdYj1sMsaVYdl4jEwUA",
                        "product_name": "商品名称",
                        "sku_name": "商品sku名称",
                        "price": "10",
                        "stock_num": "10",
                        "can_use_stock_num": "10"
                    }
                ]
            }
        },
        "status": 1
    }
}

# 结构体说明

# BasicInfo（活动基础信息）

参数	类型	描述
activity_start_time	string	活动开始时间，单位为秒
activity_end_time	string	活动结束时间，单位为秒
shop_info.nickname	string	小店昵称
shop_info.appid	string	小店appid

# ProductInfo（活动礼物商品信息）

参数	类型	描述
product_id	string	商品spuid
sku_id	string	商品skuid
product_img_url	string	商品图片url
product_name	string	商品名称
sku_name	string	商品sku名称
price	string	售卖单价，单位为分
stock_num	string	活动sku总库存
can_use_stock_num	string	活动sku剩余库存

# 错误码

错误码	错误描述
详见通用错误码	-
40097	参数错误
10028003	活动id不存在