查询会员折扣码

GET 
/openapi/2026-01/loyalty/members/:member_id/discount-codes

查询指定会员已获得的折扣码列表

请求

Path参数

member_id string必填

URL 路径中的会员 ID

Query参数

cursor string

翻页游标

limit int32

每页条数,默认 50,最大 200

响应

200

OK

application/json

数据结构

数据结构

codestring

错误码

messagestring

错误信息

data object

items object[]

折扣码资产列表

Array [

discount_codestring

折扣码字符串

used_timesint64

已使用次数。optional 保证零值也返回

available_timesint64

剩余可用次数

source_typestring

发放来源类型:points_redeem、birthday_reward、benefit_package 或 member_active_reward

source_idstring

来源 ID;source_type 为 points_redeem 时为活动 ID

discount_code_activity object

折扣码活动信息

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,空串表示长期有效

]

next_cursorstring

下一页游标

has_moreboolean

是否还有下一页

limitint32

本次返回的每页条数

示例

{
  "code": "string",
  "message": "string",
  "data": {
    "items": [
      {
        "discount_code": "string",
        "used_times": 0,
        "available_times": 0,
        "source_type": "string",
        "source_id": "string",
        "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"
        }
      }
    ],
    "next_cursor": "string",
    "has_more": true,
    "limit": 0
  }
}