会员列表

POST 
/openapi/2026-01/loyalty/members

根据会员 ID 或邮箱查询会员信息，单次最多 200 个

请求

application/json

请求体

请求体必填

search_typestring必填

会员定位方式:member_id 或 email

search_valuesstring[]必填

待查询的会员定位值列表,单次最多 200 个

示例

{
  "search_type": "string",
  "search_values": [
    "string"
  ]
}

响应

200

OK

application/json

数据结构

数据结构

codestring

错误码

messagestring

错误信息

data object
members object[]
匹配到的会员列表
Array [
member_idstring
会员唯一 ID
emailstring
会员邮箱
phonestring
会员手机号
first_namestring
会员名
last_namestring
会员姓
current_tier_namestring
当前等级名称
created_atstring
注册时间,ISO-8601
transactions_amountstring
累计消费金额,decimal 字符串
birthdaystring
会员生日,未设置时为空字符串
statusstring
会员状态:active / inactive / ...
tagsstring[]
会员标签
activated_atstring
会员激活时间,ISO-8601;未激活时为空
first_order_atstring
首单时间,ISO-8601;无单时为空
]

示例

{
  "code": "string",
  "message": "string",
  "data": {
    "members": [
      {
        "member_id": "string",
        "email": "string",
        "phone": "string",
        "first_name": "string",
        "last_name": "string",
        "current_tier_name": "string",
        "created_at": "string",
        "transactions_amount": "string",
        "birthday": "string",
        "status": "string",
        "tags": [
          "string"
        ],
        "activated_at": "string",
        "first_order_at": "string"
      }
    ]
  }
}