查询会员列表 - 尘锋SCRM开放平台

POST https://qw-openapi-tx.dustess.com/open-integration-api/mall/v1/member/details/query?accessToken=

接口限制

每分钟请求600次。

请求header

字段	值
Content-Type	application/json

Params:

字段	类型	描述	是否必须
accessToken	`String`	accessToken	true

请求参数

参数	类型	描述	是否必须
unionIds	`String[]`	用户unionId数组，数组最大500	否
memberIds	`String[]`	会员id数组，数组最大500	否
phoneList	`String[]`	手机号码数组，数组最大500	否
page	`Int`	页码	是
pageSize	`Int`	每页记录数，最大500	是

请求示例

{
  "unionIds": [],
  "memberIds": [],
  "phoneList": [],
  "page": 1,
  "pageSize": 20
}

响应结果

参数	类型	描述
success	`Bool`	是否成功
code	`Int`	状态码
msg	`String`	状态信息
data	`Object`	响应内容
data.page	`Int`	页码
data.pageSize	`Int`	单页数量
data.total	`Int`	记录总数
data.list	`Object[]`	会员列表
data.list.becomeMemberTime	`String`	成为会员时间：yyyy-MM-dd HH:mm:ss
data.list.currentGrowthValue	`Int`	当前成长值
data.list.levelName	`String`	等级名称
data.list.memberLevel	`Int`	会员等级
data.list.memberName	`String`	会员名称
data.list.telephone	`String`	会员手机号
data.list.unionId	`String`	会员unionId
data.list.memberId	`String`	会员Id
data.list.isntegralInfo	`Object`	积分信息
data.list.isntegralInfo.allowUsePoint	`Int`	可使用积分数
data.list.isntegralInfo.expirePoint	`Int`	快过期积分
data.list.isntegralInfo.expiredPoint	`Int`	已过期积分
data.list.isntegralInfo.grandObtainPoint	`Int`	累计获取总积分
data.list.isntegralInfo.grandUsePoint	`Int`	累计消耗总积分
data.list.isntegralInfo.protectPoint	`Int`	受保护积分
trace_id	`String`	跟踪id

成功响应结果

{
    "code": 0,
    "data": {
        "list": [
            {
                "becomeMemberTime": "2024-10-23 09:23:35",
                "currentGrowthValue": 300,
                "customerId": "6ca83280-90dd-xxxxxxxxxxxxxx",
                "isntegralInfo": {
                    "allowUsePoint": 321,
                    "expirePoint": 0,
                    "expiredPoint": 0,
                    "grandObtainPoint": 321,
                    "grandUsePoint": 0,
                    "protectPoint": 0
                },
                "levelName": "等级5",
                "memberId": "3300000000000000",
                "memberLevel": 5,
                "memberName": "silence2-byOpenApi",
                "telephone": "18200000000",
                "unionId": ""
            }
        ],
        "page": 1,
        "pageSize": 500,
        "total": 1
    },
    "msg": "成功",
    "success": true,
    "trace_id": "ad466266-ae60-9b93-9d52-543632e2eaf2"
}

失败响应结果

 {
    "success": false,
    "code": 10001,
    "msg": "system unknown error",
    "data": null
}