跳到主要内容
版本：v2.0

获取会员列表

分页查询会员列表，支持按手机号/姓名/员工/营员/时间/消费金额/场景值等筛选。可与 会员变更通知 配合同步。

POST/api/memberlist

请求参数​

名称类型描述是否必填默认值备注
tokenString身份校验令牌必填-由 获取访问令牌 获得
pageNumNumber分页页码非必填1-
pageSizeNumber每页条数非必填10最大不超过 100
userinfoString会员名、手机号或会员编号非必填--
staff_nameString员工名称非必填--
studentnameString营员名称非必填--
login_last_start_timeString最后一次进入系统开始时间非必填-如 2023-12-14 11:00:12
login_last_end_timeString最后一次进入系统结束时间非必填-如 2023-12-14 11:00:12
create_starttimeString首次进入系统开始时间非必填-如 2023-12-14 11:00:12
create_endtimeString首次进入系统结束时间非必填-如 2023-12-14 11:00:12
register_starttimeString注册开始时间非必填-如 2023-12-14 11:00:12
register_endtimeString注册结束时间非必填-如 2023-12-14 11:00:12
s_moneyNumber消费金额起始值非必填--
e_moneyNumber消费金额结束值非必填--
pay_starttimeString消费时间起始非必填-如 2023-12-14 11:00:12
pay_endtimeString消费时间结束非必填-如 2023-12-14 11:00:12
sceneNumber场景值非必填-见 获取来源场景值
register_statusNumber手机号认证状态非必填11 已认证，2 未认证，3 全部
openidString会员 openid非必填--

CURL​

curl --location --request POST 'https://open.xinduobang.cn/api/memberlist' \
--header 'Content-Type: application/json' \
--data-raw '{
    "token": "YOUR_TOKEN",
    "pageNum": 1,
    "pageSize": 10
}'

成功响应​

{
    "code": 0,
    "data": {
        "count": "2",
        "data": [
            {
                "uid": "10001",
                "phone": "18810416068",
                "unionid": "oXXXX_unionid_example",
                "staffid": "881",
                "staff_name": "王雪娇",
                "level": "2",
                "is_vip": 0,
                "comment_num": "0",
                "moneycard_num": "2",
                "moneycard_list": [
                    {
                        "cardno": "CZ27751991",
                        "name": "999999999退",
                        "price": "100.00"
                    },
                    {
                        "cardno": "CZ71253117",
                        "name": "999999999退",
                        "price": "1001.00"
                    }
                ],
                "card_num": 4,
                "card_list": [
                    {
                        "id": "1076065",
                        "name": "评价评价336666",
                        "money_desc": "0.03元"
                    },
                    {
                        "id": "1075700",
                        "name": "增值1",
                        "money_desc": "100.00元"
                    },
                    {
                        "id": "1075698",
                        "name": "了不起",
                        "money_desc": "300.00元"
                    },
                    {
                        "id": "1071677",
                        "name": "六一",
                        "money_desc": "5.0折"
                    }
                ],
                "last_pname": "批量批量退换【复制】",
                "last_period": "2023/12/13-2023/12/15",
                "wx_name": "新-",
                "username": "realname",
                "membertags": [
                    {
                        "name": "客单价大于0元修改",
                        "type": "2"
                    },
                    {
                        "name": "已消费1次以上",
                        "type": "2"
                    },
                    {
                        "name": "1次以上",
                        "type": "2"
                    },
                    {
                        "name": "最近一次消费",
                        "type": "2"
                    },
                    {
                        "name": "3333333",
                        "type": "2"
                    },
                    {
                        "name": "满减优惠1000",
                        "type": "2"
                    },
                    {
                        "name": "33",
                        "type": "2"
                    },
                    {
                        "name": "暑假回马枪",
                        "type": "2"
                    }
                ],
                "coin_num": "0",
                "scene": "前往小程序体验版的入口页",
                "subscribe_str": "已关注",
                "year_num": "5",
                "year_list": [
                    {
                        "card_no": "000000009013",
                        "card_num": 6,
                        "yearcard_name": "一月一露"
                    },
                    {
                        "card_no": "4342323545",
                        "card_num": 0,
                        "yearcard_name": "一月一露"
                    },
                    {
                        "card_no": "866868768687",
                        "card_num": 79,
                        "yearcard_name": "测试44"
                    }
                ],
                "money": "400.40",
                "descs": "会员备注",
                "collection_num": "0",
                "buy_count": 11,
                "last_in_time": "2023-12-14 11:22:50",
                "delay_num": 0,
                "invite_num": 4,
                "be_invite_num": 1,
                "createtime": "2023-09-11 13:29:04",
                "register_time": "2023-09-12 11:43:39",
                "student_number": 4,
                "student_list": [
                    {
                        "sid": "3180",
                        "studentname": "好的",
                        "idcard": "411526199011295131"
                    },
                    {
                        "sid": "3181",
                        "studentname": "陈建新",
                        "idcard": "411526199011295131"
                    },
                    {
                        "sid": "3979",
                        "studentname": "陈建新",
                        "idcard": "15426151616"
                    },
                    {
                        "sid": "4087",
                        "studentname": "ccccc",
                        "idcard": "41152619901129511"
                    }
                ],
                "first_inviter": "",
                "first_inviter_uid": 0,
                "user_browse_time": "2小时50分14秒"
            }
        ]
    }
}
字段类型说明
countString符合条件的会员总数
uidString会员编号
phoneString会员手机号
unionidString开放平台 unionid
staffidString员工编号
staff_nameString员工姓名
levelString会员等级
is_vipNumber是否会员：1 是，0 否
comment_numString评价数量
moneycard_numString储值卡数量
moneycard_listArray储值卡列表，元素含 cardno（编号）、name（名称）、price（剩余金额）
card_numNumber优惠券数量
card_listArray优惠券列表，元素含 id（编号）、name（名称）、money_desc（金额/折扣描述）
last_pnameString最近一次消费的营种名称
last_periodString最近一次消费的营期时间段
wx_nameString微信昵称
usernameString会员名
membertagsArray会员标签列表，元素含 name（标签名称）、type（1 手动标签，2 系统自动标签）
coin_numString积分数量
sceneString场景值
subscribe_strString关注状态
year_numString年卡数量
year_listArray年卡列表，元素含 card_no（编号）、card_num（剩余次数）、yearcard_name（名称）
moneyString消费金额
descsString会员备注
collection_numString收藏数量
buy_countNumber购买数量
last_in_timeString最后一次进入系统时间
delay_numNumber延期订单次数
invite_numNumber邀请人数
be_invite_numNumber被邀请次数
createtimeString进入系统时间
register_timeString注册时间
student_numberNumber绑定营员数量
student_listArray绑定营员列表，元素含 sid（营员编号）、studentname（姓名）、idcard（身份证号）
first_inviterString首次邀请人
first_inviter_uidNumber首次邀请人 uid
user_browse_timeString会员浏览时间

失败响应​

HTTP状态码错误码描述排查建议
200非 0业务错误请检查 token 与筛选参数

相关接口​