查询满减活动列表

GET 
/openapi/2025-06/discount_rebates

返回店铺可用的满减活动列表。

请求

Query参数

cursor string

分页游标，使用上次响应中的游标获取下一页

page_size int32

返回对象数量限制，范围 1-250，默认 10

need_detail_url boolean

若为 true，则在响应中返回详情 URL

响应

200

OK

application/json

数据结构

数据结构

codestring

错误码

messagestring

错误信息

data object

rebates object[]

返利列表

Array [

allocation_limitint32

分配上限

allocation_limit_amountfloat

分配上限金额

allocation_methodstring

分配方式

customer_selectionstring

顾客筛选条件

detail_urlstring

详情页 URL

discount_typestring

折扣类型

ends_atstring

结束时间

entitled_filter_idsstring[]

授权过滤 ID 列表

entitled_filter_liststring[]

授权过滤列表

entitled_product_idsstring[]

授权商品 ID 列表

global_show_textstring

全局显示文本

idstring

折扣 ID

once_per_customerint32

是否每位顾客只能使用一次

popups_idstring

弹窗 ID

popups_settingstring

弹窗设置

prerequisiteint32

前提条件

prerequisite_customer_idsstring[]

前提条件顾客 ID 列表

prerequisite_customer_rangestring

顾客前提条件范围

prerequisite_customer_segment_idsstring[]

顾客分组前提条件 ID 列表

prerequisite_quantity_range object[]

数量前提条件范围

Array [

greater_than_or_equal_tostring

大于或等于的值

valuestring

值

value_percentagestring

百分比值

value_event_typestring

值事件类型

value_conditionstring

值条件

target_typestring

目标类型

target_datastring[]

目标数据

]

prerequisite_subtotal_range object[]

小计前提条件范围

Array [

greater_than_or_equal_tostring

大于或等于的值

valuestring

值

value_percentagestring

百分比值

value_event_typestring

值事件类型

value_conditionstring

值条件

target_typestring

目标类型

target_datastring[]

目标数据

]

prerequisite_threshold_quantity_rangestring

阈值数量范围

prerequisite_threshold_subtotal_rangestring

阈值小计范围

product_numint32

商品数量

progressstring

进度

sortstring

排序配置

starts_atstring

开始时间

target_price_typestring

目标价格类型

target_selectionstring

目标选择

target_typestring

目标类型

times_usedint32

已使用次数

titlestring

标题

usage_limitint32

使用次数上限，-1 表示无限制

valuefloat

值

value_typestring

值类型

variant_product_idsstring[]

规格所属商品 ID 列表

discount_channel_list object[]

折扣渠道列表

Array [

channel_typestring

渠道类型

channel_statusint32

渠道状态

location_idsstring[]

位置 ID 列表

]

entitled_area_list object[]

授权地区列表

Array [

country_codestring

国家代码（如 CN）

province_codesstring[]

省份代码列表

]

entitled_collection_idsstring[]

授权集合 ID 列表

entitled_variant_idsstring[]

授权规格 ID 列表

statusstring

状态

entitled_extra_list object[]

额外授权项目列表

Array [

idstring

ID

sortint32

排序配置

]

]

cursorstring

分页游标

has_moreboolean

是否有更多记录

示例

{
  "code": "string",
  "message": "string",
  "data": {
    "rebates": [
      {
        "allocation_limit": 0,
        "allocation_limit_amount": 0,
        "allocation_method": "string",
        "customer_selection": "string",
        "detail_url": "string",
        "discount_type": "string",
        "ends_at": "string",
        "entitled_filter_ids": [
          "string"
        ],
        "entitled_filter_list": [
          "string"
        ],
        "entitled_product_ids": [
          "string"
        ],
        "global_show_text": "string",
        "id": "string",
        "once_per_customer": 0,
        "popups_id": "string",
        "popups_setting": "string",
        "prerequisite": 0,
        "prerequisite_customer_ids": [
          "string"
        ],
        "prerequisite_customer_range": "string",
        "prerequisite_customer_segment_ids": [
          "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"
            ]
          }
        ],
        "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_threshold_quantity_range": "string",
        "prerequisite_threshold_subtotal_range": "string",
        "product_num": 0,
        "progress": "string",
        "sort": "string",
        "starts_at": "string",
        "target_price_type": "string",
        "target_selection": "string",
        "target_type": "string",
        "times_used": 0,
        "title": "string",
        "usage_limit": 0,
        "value": 0,
        "value_type": "string",
        "variant_product_ids": [
          "string"
        ],
        "discount_channel_list": [
          {
            "channel_type": "string",
            "channel_status": 0,
            "location_ids": [
              "string"
            ]
          }
        ],
        "entitled_area_list": [
          {
            "country_code": "string",
            "province_codes": [
              "string"
            ]
          }
        ],
        "entitled_collection_ids": [
          "string"
        ],
        "entitled_variant_ids": [
          "string"
        ],
        "status": "string",
        "entitled_extra_list": [
          {
            "id": "string",
            "sort": 0
          }
        ]
      }
    ],
    "cursor": "string",
    "has_more": true
  }
}