查询赚积分活动

GET 
/openapi/2026-01/loyalty/earn-campaigns

查询会员可参与的赚取积分活动列表

请求

Query参数

status string

活动状态:active 或 inactive;不传返回全部

cursor string

翻页游标

limit int32

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

member_id string

按会员 ID 筛选;不传返回全部活动

响应

200

OK

application/json

数据结构

数据结构

codestring

错误码

messagestring

错误信息

data object

items object[]

活动列表

Array [

campaign_idstring

活动唯一 ID

namestring

活动名称

event_typestring

活动类型:become_member、successful_order、enter_birthday、enter_phone_number 或 share_link

activeboolean

活动是否开启

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)

member_condition object

适用会员范围;强类型,与 RedemptionCampaign 同口径

typestring

类型:scope 或 expression

scopeobject

type 为 scope 时的范围参数

expressionobject

type 为 expression 时的表达式参数

reward_pointsint64

完成活动后获得的奖励积分数

point_expire_config object

本活动发放积分的有效期配置;未配置时为 null

is_expiredboolean

积分是否过期

expired_methodstring

过期方式:after_x_months / on_specific_date / ...

dayint32

过期规则的天

monthint32

过期规则的月

protect_enabledboolean

是否开启过期保护

protect_daysint32

保护天数

use_global_configboolean

是否使用店铺全局配置

campaign_ruleobject

完整活动规则透传(对应 vo.CampaignRule);Struct 透传

execution_priorityint32

执行优先级:0=可叠加,>0=不可叠加。optional 保证零值也返回

is_cumulativeboolean

是否可叠加(execution_priority==0)。optional 保证 false 也返回

created_atstring

创建时间,RFC3339 字符串

]

next_cursorstring

下一页游标

has_moreboolean

是否还有下一页

limitint32

本次返回的每页条数

示例

{
  "code": "string",
  "message": "string",
  "data": {
    "items": [
      {
        "campaign_id": "string",
        "name": "string",
        "event_type": "string",
        "active": true,
        "execution_schedule": {
          "type": "string",
          "effective_started_at": "string",
          "effective_ended_at": "string",
          "months": [
            "string"
          ],
          "days": [
            "string"
          ],
          "date": "string"
        },
        "member_condition": {
          "type": "string",
          "scope": {},
          "expression": {}
        },
        "reward_points": 0,
        "point_expire_config": {
          "is_expired": true,
          "expired_method": "string",
          "day": 0,
          "month": 0,
          "protect_enabled": true,
          "protect_days": 0,
          "use_global_config": true
        },
        "campaign_rule": {},
        "execution_priority": 0,
        "is_cumulative": true,
        "created_at": "string"
      }
    ],
    "next_cursor": "string",
    "has_more": true,
    "limit": 0
  }
}