查询微信小店活动详情

所属权限 ads_management
请求地址 wechat_shop_activity/get
请求方法 GET

全局参数

全局参数是指每一个接口都需要使用到的参数。详情参考,代码案例参考

参数名称 参数类型
access_token 授权令牌,完成 OAuth 2.0 授权后获得,参考授权认证章节
timestamp

当前的时间戳,单位为秒,允许客户端请求最大时间误差为 300 秒。

MarketingAPI 所使用的时间戳,若无特殊说明,均为秒级时间戳

MarketingAPI 所使用的时区为 GMT+8,例如当时间戳为 1494840119 时,表示 2017-05-15 17:21:59

nonce 随机字串标识,不超过 32 个字符,由调用方自行生成,需保证全局唯一性

请求参数

标有*的参数为必填项

名称 类型 描述
account_id*
integer 账户 id,有操作权限的帐号 id,不支持代理商 id
wechat_shop_id*
string 微信小店 id
字段长度最小 1 字节,长度最大 128 字节
activity_id*
string 微信小店活动 id
字段长度最小 1 字节,长度最大 100 字节

请求示例


curl -v -G 'https://api.e.qq.com/v3.0/wechat_shop_activity/get?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
-d 'account_id=<ACCOUNT_ID>' 
					

应答字段

名称 类型 描述
activity_type
enum 小店活动类型,[枚举详情]
activity_id
string 微信小店活动 id
main_products
struct[] 主商品列表
product_id
string 微信小店商品 id
sku_list
struct[] SKU 列表
sku_id
string SKU id
bulkbuy_price
string 一起买价格,单位为分
product_price
string 商品原价,单位为分
discount_num
string SKU 折扣数,只能是整数,85 折扣填 8500
quota_id
string 限购 id
discount_info
struct 凑单活动优惠信息
discount_threshold
string 满减门槛,单位为分
discount_num
string 折扣数,只能是整数,85 折扣填 8500,后续废弃
min_discount_num
string 商品最低折扣
max_discount_num
string 商品最高折扣
product_threshold
string 商品件数门槛
threshold_type
string 门槛类型,0:金额 1:件数 2:人数
people_threshold
string 人数门槛
limit_info
struct 凑单活动商品限购信息
is_limit
integer 是否限购,0:不限购 1:限购
product_limit_num
integer 限购次数
begin_time
integer 活动开始时间,Unix 时间戳
end_time
integer 活动结束时间,Unix 时间戳
title
string 活动名称
threshold
string 活动门槛
create_time
integer 创建时间,Unix 时间戳
update_time
integer 更新时间,Unix 时间戳
version
integer 版本号
del_flag
integer 删除标记
status
enum 活动状态,[枚举详情]

应答示例

{
    "code": 0,
    "message": "",
    "message_cn": "",
    "data": {
        "main_products": [
            {
                "sku_list": []
            }
        ],
        "discount_info": [],
        "limit_info": []
    }
}

可视化调试工具