查询积分余额

POST 
/openapi/2026-01/loyalty/members/points

查询指定会员的积分余额

请求

application/json

请求体

请求体必填

search_typestring必填

会员定位方式:member_id 或 email

search_valuestring必填

单个会员定位值

示例

{
  "search_type": "string",
  "search_value": "string"
}

响应

200

OK

application/json

数据结构

数据结构

codestring

错误码

messagestring

错误信息

data object

member_idstring

会员唯一 ID

points_balanceint64

积分总余额 = active_points + frozen_points

active_pointsint64

可用积分,扣减场景下允许为负

frozen_pointsint64

冻结积分

expiring_pointsint64

近 30 天即将过期积分

earned_pointsint64

历史累计获得积分

spent_pointsint64

历史累计消耗积分

expired_pointsint64

历史累计过期积分

示例

{
  "code": "string",
  "message": "string",
  "data": {
    "member_id": "string",
    "points_balance": 0,
    "active_points": 0,
    "frozen_points": 0,
    "expiring_points": 0,
    "earned_points": 0,
    "spent_points": 0,
    "expired_points": 0
  }
}