查询价格规则列表

GET 
/openapi/2025-06/price_rules

返回可应用于客户订单的价格规则列表。

请求

Query参数

cursor string

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

page_size int32

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

starts_at_min string

过滤此时间之后开始的价格规则（Unix 时间）

starts_at_max string

过滤此时间之前开始的价格规则（Unix 时间）

ends_at_min string

过滤此时间之后结束的价格规则（Unix 时间）

ends_at_max string

过滤此时间之前结束的价格规则（Unix 时间）

times_used int32

按使用次数过滤价格规则

响应

200

OK

application/json

数据结构

数据结构

codestring

错误码

messagestring

错误信息

data object

price_rules object[]

价格规则列表

Array [

idstring

价格规则 ID

titlestring

标题

valuefloat

值

value_typestring

值类型

usage_limitint32

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

times_usedint32

已使用次数

allocation_methodstring

分配方式

allocation_limitint32

分配上限

allocation_limit_amountfloat

分配上限金额

once_per_customerint32

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

prerequisiteint32

前提条件

customer_selectionstring

顾客筛选条件

target_selectionstring

目标选择

target_typestring

目标类型

target_price_typestring

目标价格类型

created_atstring

创建时间，ISO-8601 格式

updated_atstring

最后更新时间，ISO-8601 格式

starts_atstring

开始时间

ends_atstring

结束时间

prerequisite_customer_idsstring[]

前提条件顾客 ID 列表

prerequisite_customer_segment_idsstring[]

顾客分组前提条件 ID 列表

entitled_product_idsstring[]

授权商品 ID 列表

entitled_variant_idsstring[]

授权规格 ID 列表

entitled_filter_idsstring[]

授权过滤 ID 列表

entitled_filter_liststring[]

授权过滤列表

variant_product_idsstring[]

规格所属商品 ID 列表

entitled_collection_idsstring[]

授权集合 ID 列表

entitled_area_list object[]

授权地区列表

Array [

country_codestring

国家代码（如 CN）

province_codesstring[]

省份代码列表

]

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[]

目标数据

]

]

cursorstring

分页游标

has_moreboolean

是否有更多记录

示例

{
  "code": "string",
  "message": "string",
  "data": {
    "price_rules": [
      {
        "id": "string",
        "title": "string",
        "value": 0,
        "value_type": "string",
        "usage_limit": 0,
        "times_used": 0,
        "allocation_method": "string",
        "allocation_limit": 0,
        "allocation_limit_amount": 0,
        "once_per_customer": 0,
        "prerequisite": 0,
        "customer_selection": "string",
        "target_selection": "string",
        "target_type": "string",
        "target_price_type": "string",
        "created_at": "string",
        "updated_at": "string",
        "starts_at": "string",
        "ends_at": "string",
        "prerequisite_customer_ids": [
          "string"
        ],
        "prerequisite_customer_segment_ids": [
          "string"
        ],
        "entitled_product_ids": [
          "string"
        ],
        "entitled_variant_ids": [
          "string"
        ],
        "entitled_filter_ids": [
          "string"
        ],
        "entitled_filter_list": [
          "string"
        ],
        "variant_product_ids": [
          "string"
        ],
        "entitled_collection_ids": [
          "string"
        ],
        "entitled_area_list": [
          {
            "country_code": "string",
            "province_codes": [
              "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"
            ]
          }
        ]
      }
    ],
    "cursor": "string",
    "has_more": true
  }
}