查询弹窗列表

GET 
/openapi/2025-06/popups

返回店铺可用的弹窗列表。

请求

Query参数

cursor string

分页游标

page_size int32

每页返回的弹窗数量，默认 8

响应

200

OK

application/json

数据结构

数据结构

codestring

错误码

messagestring

错误信息

data object

popups object[]

弹窗列表

Array [

abrogation_condition object

撤销条件

trigger_numint32

触发次数

closedint32

是否已关闭

participatedint32

是否已参与

auto_close_numint32

自动关闭次数

activity_idstring

活动 ID

activity_typestring

活动类型

app_typestring

应用类型

cart_amount object

购物车金额

limitint32

上限数量

minfloat

最小值

maxfloat

最大值

cart_num object

购物车商品数量

limitint32

上限数量

minint32

最小值

maxint32

最大值

config object

配置信息

global object

全局

sections object

区块列表

modalstring[]

弹窗模态框

contentstring[]

内容

activitystring[]

活动信息

activity_urlstring[]

活动 URL

globalstring[]

全局

overlay object

遮罩层

typestring

类型

style object

样式

background_colorstring

背景颜色

setting object

设置

typestring

类型

value object

值

device_typestring

设备类型

positionstring

位置或排序

fixedstring

固定的

prerequisite_typestring

前提条件类型

modal_size object

弹窗尺寸

typestring

类型

style object

样式

widthstring

宽度尺寸

link object

链接

typestring

类型

valuestring

值

basic_setting object

基础设置

sections object

区块列表

modalstring[]

弹窗模态框

contentstring[]

内容

activitystring[]

活动信息

activity_urlstring[]

活动 URL

globalstring[]

全局

select_activity object

选择活动

typestring

类型

activity_namestring

活动名称

prerequisite_array object[]

前提条件数组

Array [

greater_than_or_equal_tostring

大于或等于的值

valuestring

值

value_percentagestring

百分比值

value_event_typestring

值事件类型

value_conditionstring

值条件

target_typestring

目标类型

target_datastring[]

目标数据

]

activity_url object

活动 URL

typestring

类型

valuestring

值

advanced_setting object

高级设置

sections object

区块列表

modalstring[]

弹窗模态框

contentstring[]

内容

activitystring[]

活动信息

activity_urlstring[]

活动 URL

globalstring[]

全局

modal object

弹窗模态框

typestring

类型

style object

样式

imagestring

图片

backgroundstring

背景

background1string

背景（主要）

background2string

背景（次要）

background_image_templatestring

背景图片模板

widthint32

宽度尺寸

title object

标题

typestring

类型

valuestring

值

style object

样式

background_colorstring

背景颜色

coupon_content object

优惠券内容

typestring

类型

title_namestring

标题名称

single object

是否单一

amount_percentage object

金额百分比折扣

valuestring

值

style object

样式

background_colorstring

背景颜色

item_fixed_amount object

项目固定折扣金额

valuestring

值

style object

样式

background_colorstring

背景颜色

fixed_amount object

固定金额

valuestring

值

style object

样式

background_colorstring

背景颜色

percentage object

百分比

across object

跨度

valuestring

值

each object

每个

valuestring

值

style object

样式

background_colorstring

背景颜色

coupon object

优惠券信息

typestring

类型

style object

样式

colorstring

颜色

background_colorstring

背景颜色

title_namestring

标题名称

declaration object

申报信息

typestring

类型

title_namestring

标题名称

valuestring

值

style object

样式

background_colorstring

背景颜色

main_button object

主按钮

typestring

类型

valuestring

值

style object

样式

background_colorstring

背景颜色

border_colorstring

边框颜色

close_button object

关闭按钮

typestring

类型

modifierstring

修改者

tool_show_close_btnboolean

是否显示工具关闭按钮

show_close_btnboolean

是否显示关闭按钮

style object

样式

colorstring

颜色

first_page object

第一页

sections object

区块列表

modalstring[]

弹窗模态框

contentstring[]

内容

activitystring[]

活动信息

activity_urlstring[]

活动 URL

globalstring[]

全局

modal object

弹窗模态框

typestring

类型

style object

样式

imagestring

图片

backgroundstring

背景

background1string

背景（主要）

background2string

背景（次要）

background_image_templatestring

背景图片模板

widthint32

宽度尺寸

title object

标题

typestring

类型

valuestring

值

style object

样式

background_colorstring

背景颜色

description object

描述

typestring

类型

valuestring

值

input object

输入

typestring

类型

style object

样式

background_colorstring

背景颜色

border_colorstring

边框颜色

colorstring

颜色

button1 object

按钮1

typestring

类型

modifierstring

样式修饰符

url object

链接配置

typestring

类型

valuestring

值

valuestring

值

style object

样式

background_colorstring

背景颜色

border_colorstring

边框颜色

url_strstring

URL 字符串

button2 object

按钮2

typestring

类型

modifierstring

样式修饰符

url object

链接配置

typestring

类型

valuestring

值

valuestring

值

style object

样式

background_colorstring

背景颜色

border_colorstring

边框颜色

url_strstring

URL 字符串

rebate object

返利信息

typestring

类型

rebate_idstring

返利 ID

rebate_namestring

返利名称

rebate_not_match_textstring

返利不匹配文本

rebate_match_textstring

返利匹配文本

shipping object

配送信息

typestring

类型

shipping_idstring

配送 ID

shipping_namestring

配送方式名称

shipping_not_match_textstring

运费不匹配文本

shipping_match_textstring

运费匹配文本

second_page object

第二页

sections object

区块列表

modalstring[]

弹窗模态框

contentstring[]

内容

activitystring[]

活动信息

activity_urlstring[]

活动 URL

globalstring[]

全局

modal object

弹窗模态框

typestring

类型

style object

样式

imagestring

图片

backgroundstring

背景

background1string

背景（主要）

background2string

背景（次要）

background_image_templatestring

背景图片模板

widthint32

宽度尺寸

title object

标题

typestring

类型

valuestring

值

style object

样式

background_colorstring

背景颜色

description object

描述

typestring

类型

valuestring

值

coupon object

优惠券信息

typestring

类型

style object

样式

colorstring

颜色

background_colorstring

背景颜色

title_namestring

标题名称

button1 object

按钮1

typestring

类型

modifierstring

样式修饰符

url object

链接配置

typestring

类型

valuestring

值

valuestring

值

style object

样式

background_colorstring

背景颜色

border_colorstring

边框颜色

url_strstring

URL 字符串

conversion_ratestring

转化率

coupon_codestring

优惠券码

create_typestring

创建类型

discount_typestring

折扣类型

ends_atstring

结束时间

exposurestring

曝光次数

frequency_numstring

频率数值

frequency_typestring

频率类型

idstring

弹窗 ID

namestring

名称

opportunitystring

机会数

order_amount object

订单金额

limitint32

上限数量

minfloat

最小值

maxfloat

最大值

order_num object

订单数量

limitint32

上限数量

minint32

最小值

maxint32

最大值

p_created_atstring

商品创建时间

p_updated_atstring

商品更新时间

pa_updated_atstring

商品属性更新时间

pages_typestring

页面类型

progressstring

进度

resource_idstring

资源 ID

starts_atstring

开始时间

statusstring

状态

subscribestring

订阅

target_userstring

目标用户

themestring

主题

typestring

类型

user_loginstring

用户登录

user_subscribestring

用户订阅

wait_secondsstring

等待秒数

activity_detail object

活动详情

idstring

活动详情 ID

titlestring

标题

price_rule_idstring

价格规则 ID

discount_typestring

折扣类型

starts_atstring

开始时间

ends_atstring

结束时间

statusstring

状态

popups_settingstring

弹窗设置

global_show_textstring

全局显示文本

popups_idstring

弹窗 ID

discount_channel_list object[]

折扣渠道列表

Array [

channel_typestring

渠道类型

channel_statusint32

渠道状态

location_idsstring[]

位置 ID 列表

]

prerequisite_subtotal_range object[]

小计前提条件范围

Array [

greater_than_or_equal_tostring

大于或等于的值

valuestring

值

value_percentagestring

百分比值

value_event_typestring

值事件类型

value_conditionstring

值条件

target_typestring

目标类型

target_datastring[]

目标数据

]

prerequisite_quantity_range object[]

数量前提条件范围

Array [

greater_than_or_equal_tostring

大于或等于的值

valuestring

值

value_percentagestring

百分比值

value_event_typestring

值事件类型

value_conditionstring

值条件

target_typestring

目标类型

target_datastring[]

目标数据

]

allocation_methodstring

分配方式

]

cursorstring

下一页游标

has_moreboolean

是否有更多数据

示例

{
  "code": "string",
  "message": "string",
  "data": {
    "popups": [
      {
        "abrogation_condition": {
          "trigger_num": 0,
          "closed": 0,
          "participated": 0,
          "auto_close_num": 0
        },
        "activity_id": "string",
        "activity_type": "string",
        "app_type": "string",
        "cart_amount": {
          "limit": 0,
          "min": 0,
          "max": 0
        },
        "cart_num": {
          "limit": 0,
          "min": 0,
          "max": 0
        },
        "config": {
          "global": {
            "sections": {
              "modal": [
                "string"
              ],
              "content": [
                "string"
              ],
              "activity": [
                "string"
              ],
              "activity_url": [
                "string"
              ],
              "global": [
                "string"
              ]
            },
            "overlay": {
              "type": "string",
              "style": {
                "background_color": "string"
              }
            },
            "setting": {
              "type": "string",
              "value": {
                "device_type": "string",
                "position": "string",
                "fixed": "string",
                "prerequisite_type": "string"
              }
            },
            "modal_size": {
              "type": "string",
              "style": {
                "width": "string"
              }
            },
            "link": {
              "type": "string",
              "value": "string"
            }
          },
          "basic_setting": {
            "sections": {
              "modal": [
                "string"
              ],
              "content": [
                "string"
              ],
              "activity": [
                "string"
              ],
              "activity_url": [
                "string"
              ],
              "global": [
                "string"
              ]
            },
            "select_activity": {
              "type": "string",
              "activity_name": "string",
              "prerequisite_array": [
                {
                  "greater_than_or_equal_to": "string",
                  "value": "string",
                  "value_percentage": "string",
                  "value_event_type": "string",
                  "value_condition": "string",
                  "target_type": "string",
                  "target_data": [
                    "string"
                  ]
                }
              ]
            },
            "activity_url": {
              "type": "string",
              "value": "string"
            }
          },
          "advanced_setting": {
            "sections": {
              "modal": [
                "string"
              ],
              "content": [
                "string"
              ],
              "activity": [
                "string"
              ],
              "activity_url": [
                "string"
              ],
              "global": [
                "string"
              ]
            },
            "modal": {
              "type": "string",
              "style": {
                "image": "string",
                "background": "string",
                "background1": "string",
                "background2": "string",
                "background_image_template": "string",
                "width": 0
              }
            },
            "title": {
              "type": "string",
              "value": "string",
              "style": {
                "background_color": "string"
              }
            },
            "coupon_content": {
              "type": "string",
              "title_name": "string",
              "single": {
                "amount_percentage": {
                  "value": "string",
                  "style": {
                    "background_color": "string"
                  }
                },
                "item_fixed_amount": {
                  "value": "string",
                  "style": {
                    "background_color": "string"
                  }
                },
                "fixed_amount": {
                  "value": "string",
                  "style": {
                    "background_color": "string"
                  }
                },
                "percentage": {
                  "across": {
                    "value": "string"
                  },
                  "each": {
                    "value": "string"
                  },
                  "style": {
                    "background_color": "string"
                  }
                }
              }
            },
            "coupon": {
              "type": "string",
              "style": {
                "color": "string",
                "background_color": "string"
              },
              "title_name": "string"
            },
            "declaration": {
              "type": "string",
              "title_name": "string",
              "value": "string",
              "style": {
                "background_color": "string"
              }
            },
            "main_button": {
              "type": "string",
              "value": "string",
              "style": {
                "background_color": "string",
                "border_color": "string"
              }
            },
            "close_button": {
              "type": "string",
              "modifier": "string",
              "tool_show_close_btn": true,
              "show_close_btn": true,
              "style": {
                "color": "string"
              }
            }
          },
          "first_page": {
            "sections": {
              "modal": [
                "string"
              ],
              "content": [
                "string"
              ],
              "activity": [
                "string"
              ],
              "activity_url": [
                "string"
              ],
              "global": [
                "string"
              ]
            },
            "modal": {
              "type": "string",
              "style": {
                "image": "string",
                "background": "string",
                "background1": "string",
                "background2": "string",
                "background_image_template": "string",
                "width": 0
              }
            },
            "title": {
              "type": "string",
              "value": "string",
              "style": {
                "background_color": "string"
              }
            },
            "description": {
              "type": "string",
              "value": "string"
            },
            "input": {
              "type": "string",
              "style": {
                "background_color": "string",
                "border_color": "string",
                "color": "string"
              }
            },
            "button1": {
              "type": "string",
              "modifier": "string",
              "url": {
                "type": "string",
                "value": "string"
              },
              "value": "string",
              "style": {
                "background_color": "string",
                "border_color": "string"
              },
              "url_str": "string"
            },
            "button2": {
              "type": "string",
              "modifier": "string",
              "url": {
                "type": "string",
                "value": "string"
              },
              "value": "string",
              "style": {
                "background_color": "string",
                "border_color": "string"
              },
              "url_str": "string"
            },
            "rebate": {
              "type": "string",
              "rebate_id": "string",
              "rebate_name": "string",
              "rebate_not_match_text": "string",
              "rebate_match_text": "string"
            },
            "shipping": {
              "type": "string",
              "shipping_id": "string",
              "shipping_name": "string",
              "shipping_not_match_text": "string",
              "shipping_match_text": "string"
            }
          },
          "second_page": {
            "sections": {
              "modal": [
                "string"
              ],
              "content": [
                "string"
              ],
              "activity": [
                "string"
              ],
              "activity_url": [
                "string"
              ],
              "global": [
                "string"
              ]
            },
            "modal": {
              "type": "string",
              "style": {
                "image": "string",
                "background": "string",
                "background1": "string",
                "background2": "string",
                "background_image_template": "string",
                "width": 0
              }
            },
            "title": {
              "type": "string",
              "value": "string",
              "style": {
                "background_color": "string"
              }
            },
            "description": {
              "type": "string",
              "value": "string"
            },
            "coupon": {
              "type": "string",
              "style": {
                "color": "string",
                "background_color": "string"
              },
              "title_name": "string"
            },
            "button1": {
              "type": "string",
              "modifier": "string",
              "url": {
                "type": "string",
                "value": "string"
              },
              "value": "string",
              "style": {
                "background_color": "string",
                "border_color": "string"
              },
              "url_str": "string"
            }
          }
        },
        "conversion_rate": "string",
        "coupon_code": "string",
        "create_type": "string",
        "discount_type": "string",
        "ends_at": "string",
        "exposure": "string",
        "frequency_num": "string",
        "frequency_type": "string",
        "id": "string",
        "name": "string",
        "opportunity": "string",
        "order_amount": {
          "limit": 0,
          "min": 0,
          "max": 0
        },
        "order_num": {
          "limit": 0,
          "min": 0,
          "max": 0
        },
        "p_created_at": "string",
        "p_updated_at": "string",
        "pa_updated_at": "string",
        "pages_type": "string",
        "progress": "string",
        "resource_id": "string",
        "starts_at": "string",
        "status": "string",
        "subscribe": "string",
        "target_user": "string",
        "theme": "string",
        "type": "string",
        "user_login": "string",
        "user_subscribe": "string",
        "wait_seconds": "string",
        "activity_detail": {
          "id": "string",
          "title": "string",
          "price_rule_id": "string",
          "discount_type": "string",
          "starts_at": "string",
          "ends_at": "string",
          "status": "string",
          "popups_setting": "string",
          "global_show_text": "string",
          "popups_id": "string",
          "discount_channel_list": [
            {
              "channel_type": "string",
              "channel_status": 0,
              "location_ids": [
                "string"
              ]
            }
          ],
          "prerequisite_subtotal_range": [
            {
              "greater_than_or_equal_to": "string",
              "value": "string",
              "value_percentage": "string",
              "value_event_type": "string",
              "value_condition": "string",
              "target_type": "string",
              "target_data": [
                "string"
              ]
            }
          ],
          "prerequisite_quantity_range": [
            {
              "greater_than_or_equal_to": "string",
              "value": "string",
              "value_percentage": "string",
              "value_event_type": "string",
              "value_condition": "string",
              "target_type": "string",
              "target_data": [
                "string"
              ]
            }
          ],
          "allocation_method": "string"
        }
      }
    ],
    "cursor": "string",
    "has_more": true
  }
}