查询会员权益

GET 
/openapi/2026-01/loyalty/members/:member_id/benefits

查询指定会员当前等级可享有的权益列表

请求

Path参数

member_id string必填

URL 路径中的会员 ID

响应

200

OK

application/json

数据结构

数据结构

codestring

错误码

messagestring

错误信息

data object
member_idstring
会员唯一 ID
current_tier_namestring
当前等级名称
benefits object[]
权益列表
Array [
benefit_idstring
权益唯一 ID
namestring
权益名称
descriptionstring
权益描述
iconstring
图标 URL
benefit_typestring
权益类型:point、coupon、discount_code、free_shipping 或 custom
trigger_typestring
触发方式:join_tier、birthday 或 periodic
execution_schedule object
发放规则(对应 vo.ExecutionScheduleRule),强类型映射
typestring
周期类型:time_range / weekly / monthly / cycle
effective_started_atstring
开始时间,RFC3339,空表示无开始约束
effective_ended_atstring
结束时间,RFC3339,空表示长期有效
monthsstring[]
指定月份,type=monthly 时生效,数值字符串(1-12)
daysstring[]
指定天:weekly 时 0-6 表示周日-周六;monthly 时 1-31 表示月内日期
datestring
指定日期(如 yyyy-MM-dd)
reward_config object[]
奖励配置列表
Array [
reward_typestring
奖励类型:point / discount_code / custom
point_valueuint64
reward_type=point 时的积分数值;其它类型为 0
discount_code_activity object
reward_type=discount_code 时的折扣码活动详情;其它类型为 null
namestring
活动名称
discount_typestring
折扣类型:percentage / fixed_amount / free_shipping / bxgy
discount_valuestring
折扣值;percentage 为百分比数字字符串(如 "10"),fixed_amount 为金额字符串(如 "10.00"),free_shipping / bxgy 留空
prerequisite_typestring
前置条件类型:none / subtotal / quantity
prerequisite_valuestring
前置条件值:subtotal 为金额字符串,quantity 为数量
max_free_shippingstring
免邮上限(免邮码用),-1 表示无上限。用 string 保留小数
applicable_rule object
适用商品规则
applicable_typestring
适用类型:all / include_products / include_collections
applicable_product_idsstring[]
applicable_type=include_products 时的商品 ID 列表
applicable_variant_idsstring[]
applicable_type=include_products 时的 SKU/variant ID 列表
applicable_collection_idsstring[]
applicable_type=include_collections 时的合集 ID 列表
obtain_products object
获取商品规则(BXGY 专用)
applicable_rule object
可获取商品的适用规则
applicable_typestring
适用类型:all / include_products / include_collections
applicable_product_idsstring[]
applicable_type=include_products 时的商品 ID 列表
applicable_variant_idsstring[]
applicable_type=include_products 时的 SKU/variant ID 列表
applicable_collection_idsstring[]
applicable_type=include_collections 时的合集 ID 列表
product_countuint32
获取商品数量
obtain_typestring
获取商品优惠类型:free / percentage / fixed_amount
obtain_valuestring
优惠值;decimal 字符串
use_with_otherboolean
是否允许跟其他折扣叠加
limit_user_discountint32
每人活动使用次数上限,-1 表示无上限
limit_code_user_discountint32
每人单码使用次数上限,-1 表示无上限
limit_order_discountint32
每笔订单使用次数上限,-1 表示无上限
limit_code_max_discountint32
单码最大使用次数,-1 表示无上限
started_atstring
活动开始时间;ISO 8601 UTC
ended_atstring
活动结束时间;ISO 8601 UTC,空串表示长期有效
custom_rewardobject
reward_type=custom 时的自定义奖励;其它类型为 null(结构占位)
]
point_expire_configobject
积分权益过期配置,仅 benefit_type 为 point 时返回
]

示例

{
  "code": "string",
  "message": "string",
  "data": {
    "member_id": "string",
    "current_tier_name": "string",
    "benefits": [
      {
        "benefit_id": "string",
        "name": "string",
        "description": "string",
        "icon": "string",
        "benefit_type": "string",
        "trigger_type": "string",
        "execution_schedule": {
          "type": "string",
          "effective_started_at": "string",
          "effective_ended_at": "string",
          "months": [
            "string"
          ],
          "days": [
            "string"
          ],
          "date": "string"
        },
        "reward_config": [
          {
            "reward_type": "string",
            "point_value": 0,
            "discount_code_activity": {
              "name": "string",
              "discount_type": "string",
              "discount_value": "string",
              "prerequisite_type": "string",
              "prerequisite_value": "string",
              "max_free_shipping": "string",
              "applicable_rule": {
                "applicable_type": "string",
                "applicable_product_ids": [
                  "string"
                ],
                "applicable_variant_ids": [
                  "string"
                ],
                "applicable_collection_ids": [
                  "string"
                ]
              },
              "obtain_products": {
                "applicable_rule": {
                  "applicable_type": "string",
                  "applicable_product_ids": [
                    "string"
                  ],
                  "applicable_variant_ids": [
                    "string"
                  ],
                  "applicable_collection_ids": [
                    "string"
                  ]
                },
                "product_count": 0,
                "obtain_type": "string",
                "obtain_value": "string"
              },
              "use_with_other": true,
              "limit_user_discount": 0,
              "limit_code_user_discount": 0,
              "limit_order_discount": 0,
              "limit_code_max_discount": 0,
              "started_at": "string",
              "ended_at": "string"
            },
            "custom_reward": {}
          }
        ],
        "point_expire_config": {}
      }
    ]
  }
}