查询会员等级

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

查询指定会员的当前等级及升级进度

请求

Path参数

member_id string必填

URL 路径中的会员 ID

响应

200

OK

application/json

数据结构

数据结构

codestring

错误码

messagestring

错误信息

data object

member_idstring

会员唯一 ID

current_tier_namestring

当前等级名称

accumulated_amountstring

累计消费金额,decimal 字符串

tier_requirements object[]

等级升级要求列表,按等级顺序返回

Array [

tier_namestring

等级名称

threshold_amountstring

升级到该等级所需累计消费金额,decimal 字符串

]

next_tier object

下一级信息;已达最高等级或店铺仅一个等级时为空

tier_namestring

等级名称

threshold_amountstring

升级到该等级所需累计消费金额,decimal 字符串

示例

{
  "code": "string",
  "message": "string",
  "data": {
    "member_id": "string",
    "current_tier_name": "string",
    "accumulated_amount": "string",
    "tier_requirements": [
      {
        "tier_name": "string",
        "threshold_amount": "string"
      }
    ],
    "next_tier": {
      "tier_name": "string",
      "threshold_amount": "string"
    }
  }
}