开发指南
API
官网
API 2.0
API 2.0 > 2.1 基础数据 > 2.1.1 获取会员列表

2.1.1 获取会员列表

开启令牌和权限后可调用。签名方式请查看开发指南
场景描述：获取企迈云商当前店铺的会员列表
零售 餐饮

请求地址

请求方式 版本信息 请求地址
POST V2 http://openapi.zvcms.com/api/v2

公共参数

参数 参数类型 是否必填 默认值 描述
OpenId string 是 密钥Id
GrantCode string 是 授权code
Token string 是 签名，参考《数字签名sign》
Timestamp string 是 当前时间戳
Nonce string 是 随机正整数
Action string 是 user.user-list 接口方法
Params array 是 业务参数

请求参数

参数 参数类型 是否必填 默认值 描述
nickname string 否 昵称，增加此参数只展示昵称中包含nickname的会员，可用于条件搜索
mobile string 否 手机号，增加此参数只展示手机号码中包含mobile的会员，可用于条件搜索
page int 否 页码，要显示的页码
per_page int 否 每页要现实的条数
card_name string 否 会员卡名称
card_level int 否 会员卡等级
min_order_qty int 否 购买次数最小值
max_order_qty int 否 购买次数最大值
reg_stime DateTime 否 注册的开始时间
reg_etime DateTime 否 注册的结束时间
sort_field string 否 排序字段 card_level, balance, order_total_qty
order_key int 否 排序方式 asc, desc
is_bound_mobile int 否 是否绑定手机号 0表示未绑定 1表示绑定
birthday_stime DateTime 否 生日开始时间
birthday_etime DateTime 否 生日结束时间
max_balance Money(分 否 账户余额最小值
min_balance Money(分 否 账户余额最大值
charge_card_stime DateTime 否 付费会员有效期起始时间
charge_card_etime DateTime 否 付费会员有效期结束时间
is_open_webank Int 否 是否开启微众会员 0表示关闭 1表示开启
from_multi_store_id Int 否 来源的门店id -1表示全部
is_open_charge_card Int 否 是否开启付费会员 0表示未开启 1表示开启

响应参数

参数 参数类型 描述
item_list array
 ├0 array
  ├id int id
  ├nickname string 会员昵称
  ├mobile string 手机号码
  ├avatar string 头像
  ├register_at string 会员注册时间
  ├point string 会员积分
  ├source int 来源，1:pc, 2:wap, 3:app, 4:微信小程序, 5:支付宝小程序, 6:关注商家公众号
  ├is_open_webank Int 是否开启储值卡
  ├birthday DateTime 用户生日
  ├balance Money(分) 账户余额
  ├is_open_charge_card int 是否开启储值卡
  ├card_id string 会员卡id
  ├card_level int 会员卡等级
  ├card_name string 会员卡名称
  ├order_total_qty int 总订单量
  ├order_total_amount Money(元) 总交易额
  ├from_multi_store_id int 来源多门店id
  ├union_id string 用户唯一标识
per_page int 每页显示数据数
current_page int 当前页

请求示例

{
    "OpenId": "6dc05b4ac175cf316d226252b05cf685",
    "GrantCode": "782c281f62",
    "Timestamp": "1547186244",
    "Nonce": "658965",
    "Token": "0%2B%2B3c6hthjwAml4ABAXOYF4Q6UY%3D",
    "Action": "user.user-list",
    "Params": {
        "nickname": "",
        "mobile": "",
        "page": "",
        "per_page": "",
        "card_name": "",
        "card_level": "",
        "min_order_qty": "",
        "max_order_qty": "",
        "reg_stime": "",
        "reg_etime": "",
        "sort_field": "",
        "order_key": "",
        "is_bound_mobile": "",
        "birthday_stime": "",
        "birthday_etime": "",
        "max_balance": "",
        "min_balance": "",
        "charge_card_stime": "",
        "charge_card_etime": "",
        "is_open_webank": "",
        "from_multi_store_id": "",
        "is_open_charge_card": ""
    }
}

响应示例

{
    "status": "true",
    "code": "0",
    "message": "说明",
    "data": {
        "item_list": [
            {
                "id": "1332",
                "nickname": "刘玥（刘燕）",
                "mobile": "18888888888",
                "avatar": "",
                "register_at": "",
                "point": "",
                "source": "4",
                "is_open_webank": "",
                "birthday": "",
                "balance": "",
                "is_open_charge_card": "",
                "card_id": "",
                "card_level": "",
                "card_name": "",
                "order_total_qty": "",
                "order_total_amount": "",
                "from_multi_store_id": "",
                "union_id": ""
            }
        ],
        "per_page": "",
        "current_page": ""
    }
}

异常示例

{
    "status": true,
    "code": "异常编码，根据不同的业务返回编码",
    "message": "异常说明：查询的信息不存在"
}

错误码

{
    "status": false,
    "code": "系统错误编码：详见全局返回编码",
    "message": "系统错误说明"
}

请求地址

请求方式 版本信息 请求地址
POST V2 http://openapi.zvcms.com/api/v2

公共参数

参数 参数类型 是否必填 默认值 描述
OpenId string 是 密钥Id
GrantCode string 是 授权code
Token string 是 签名，参考《数字签名sign》
Timestamp string 是 当前时间戳
Nonce string 是 随机正整数
Action string 是 user.user-list 接口方法
Params array 是 业务参数

请求参数

参数 参数类型 是否必填 默认值 描述
nickname string 否 昵称，增加此参数只展示昵称中包含nickname的会员，可用于条件搜索
mobile string 否 手机号，增加此参数只展示手机号码中包含mobile的会员，可用于条件搜索
page int 否 页码，要显示的页码
per_page int 否 每页要现实的条数
card_name string 否 会员卡名称
card_level int 否 会员卡等级
min_order_qty int 否 购买次数最小值
max_order_qty int 否 购买次数最大值
reg_stime DateTime 否 注册的开始时间
reg_etime DateTime 否 注册的结束时间
sort_field string 否 排序字段 card_level, balance, order_total_qty
order_key int 否 排序方式 asc, desc
is_bound_mobile int 否 是否绑定手机号 0表示未绑定 1表示绑定
birthday_stime DateTime 否 生日开始时间
birthday_etime DateTime 否 生日结束时间
max_balance Money(分 否 账户余额最小值
min_balance Money(分 否 账户余额最大值
charge_card_stime DateTime 否 付费会员有效期起始时间
charge_card_etime DateTime 否 付费会员有效期结束时间
is_open_webank Int 否 是否开启微众会员 0表示关闭 1表示开启
from_multi_store_id Int 否 来源的门店id -1表示全部
is_open_charge_card Int 否 是否开启付费会员 0表示未开启 1表示开启

响应参数

参数 参数类型 描述
item_list array
 ├0 array
  ├id int id
  ├nickname string 会员昵称
  ├mobile string 手机号码
  ├avatar string 头像
  ├register_at string 会员注册时间
  ├point string 会员积分
  ├source int 来源，1:pc, 2:wap, 3:app, 4:微信小程序, 5:支付宝小程序, 6:关注商家公众号
  ├is_open_webank Int 是否开启储值卡
  ├birthday DateTime 用户生日
  ├balance Money(分) 账户余额
  ├is_open_charge_card int 是否开启储值卡
  ├card_id string 会员卡id
  ├card_level int 会员卡等级
  ├card_name string 会员卡名称
  ├order_total_qty int 总订单量
  ├order_total_amount Money(元) 总交易额
  ├from_multi_store_id int 来源多门店id
  ├union_id string 用户唯一标识
per_page int 每页显示数据数
current_page int 当前页

请求示例

{
    "OpenId": "6dc05b4ac175cf316d226252b05cf685",
    "GrantCode": "782c281f62",
    "Timestamp": "1547186244",
    "Nonce": "658965",
    "Token": "0%2B%2B3c6hthjwAml4ABAXOYF4Q6UY%3D",
    "Action": "user.user-list",
    "Params": {
        "nickname": "",
        "mobile": "",
        "page": "",
        "per_page": "",
        "card_name": "",
        "card_level": "",
        "min_order_qty": "",
        "max_order_qty": "",
        "reg_stime": "",
        "reg_etime": "",
        "sort_field": "",
        "order_key": "",
        "is_bound_mobile": "",
        "birthday_stime": "",
        "birthday_etime": "",
        "max_balance": "",
        "min_balance": "",
        "charge_card_stime": "",
        "charge_card_etime": "",
        "is_open_webank": "",
        "from_multi_store_id": "",
        "is_open_charge_card": ""
    }
}

响应示例

{
    "status": "true",
    "code": "0",
    "message": "说明",
    "data": {
        "item_list": [
            {
                "id": "1332",
                "nickname": "刘玥（刘燕）",
                "mobile": "18888888888",
                "avatar": "",
                "register_at": "",
                "point": "",
                "source": "4",
                "is_open_webank": "",
                "birthday": "",
                "balance": "",
                "is_open_charge_card": "",
                "card_id": "",
                "card_level": "",
                "card_name": "",
                "order_total_qty": "",
                "order_total_amount": "",
                "from_multi_store_id": "",
                "union_id": ""
            }
        ],
        "per_page": "",
        "current_page": ""
    }
}

异常示例

{
    "status": true,
    "code": "异常编码，根据不同的业务返回编码",
    "message": "异常说明：查询的信息不存在"
}

错误码

{
    "status": false,
    "code": "系统错误编码：详见全局返回编码",
    "message": "系统错误说明"
}

免费升级

营销功能、插件持续每月更新开发升级

免费专业培训

每月建站、微信营销、电商等互联网增值培训

7×24小时服务支持

400电话、QQ、微信、在线等多渠道售后支持

 

安徽智迈科技股份有限公司 版权所有 Copyright 2009-2018 皖公网安备 34019202000074号 增值电信业务经营许可证：皖B2-20170075