企迈云-开放平台

API 2.0

API 2.0 > 5.2 会员查询 > 5.2.1 会员识别

5.2.1 会员识别

开启令牌和权限后可调用。签名方式请查看开发指南

场景描述：根据手机号码、实体卡、用户标识查询，openid，unionid等，获取会员详情

零售

请求地址

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

公共参数

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

请求参数

参数	参数类型	是否必填	描述
type	int	是	通过哪种方式进行会员识别 1表示账号 2表示卡号 3表示会员识别码 4表示通过user_id 进行会员识别
card_number	string	否	当type为2时，实体卡卡号必填
card_password	string	否	当type为2时，实体卡内部卡号必填
user_code	string	否	当type为3时，用户识别码必填
mobile	string	否	当type为1时，手机号必填
password	string	否	当type为1时，手机登录密码必填
multi_store_sn	string	否	多门店标识码
point_rules	int	否	是否获取积分规则，和店铺是否开启积分抵扣订单金额
user_id	int	否	当type为4时，用户id必填

响应参数

参数	参数类型	描述
status	bool	请求成功或者失败
code	int	成功/错误编码
message	string	成功/错误描述
data	array
├user_info	array
├id	int	用户id
├nickname	string	用户昵称
├username	string	用户名
├mobile	string	用户手机号
├status	int	用户账号的状态 0表示冻结 1表示正常
├user_points	int	用户积分
├user_coupons	array
├0	array
├coupon_id	int	优惠券id
├start_at	string	优惠券开始时间
├end_at	string	优惠券结束时间
├status	int	优惠券状态 0-未使用 1-已使用
├verify_code	string	核销码
├is_lock	int	是否锁定 1-正常 2-锁定
├date_time	string	状态有限期字段
├title	string	优惠券名称
├coupon_type	int	优惠券类型优惠形式 0-指定金额 1-折扣券
├min_amount_use	int	最低使用金额， 0 -不限制，单位分
├desc	string	描述
├amount	float	优惠券金额/折扣
├user_wealth_info	array
├gift_amount	int	用户赠余额，单位分
├recharge_amount	int	用户充值余额，单位分
├total_amount	int	用户总的余额，单位分
├multi_store_id	int	多门店的id （0表示店铺）
├is_open_points_pay	int	true表示开启积分抵扣订单金额
├pay_rule	array
├points_num_type	int	积分抵扣金额方式 1代表 1积分等于多少元 2代表一元消耗多少积分
├points_num	float	对应pay_rule[points_num_type]中的数值（1积分等于xx元/一元消耗xx积分中的值）
├exchange_astrict	int	最高抵消比例，例如订单需要支付100元，限制积分抵消比例为20%，那么能使用积分抵扣的金额为20元。（入exchange_astrict=20，表示抵消订单金额的20%）

请求示例

{
    "OpenId": "6dc05b4ac175cf316d226252b05cf685",
    "GrantCode": "782c281f62",
    "Timestamp": "1547186244",
    "Nonce": "658965",
    "Token": "0%2B%2B3c6hthjwAml4ABAXOYF4Q6UY%3D",
    "Action": "communal.user.identity",
    "Params": {
        "type": "",
        "card_number": "",
        "card_password": "",
        "user_code": "",
        "mobile": "",
        "password": "",
        "multi_store_sn": "",
        "point_rules": "",
        "user_id": ""
    }
}

响应示例

{
    "status": "true",
    "code": "0",
    "message": "说明",
    "data": {
        "user_info": {
            "id": "",
            "nickname": "",
            "username": "",
            "mobile": "",
            "status": "",
            "user_points": "",
            "user_coupons": [
                {
                    "coupon_id": "",
                    "start_at": "",
                    "end_at": "",
                    "status": "",
                    "verify_code": "",
                    "is_lock": "",
                    "date_time": "",
                    "title": "",
                    "coupon_type": "",
                    "min_amount_use": "",
                    "desc": "",
                    "amount": ""
                }
            ],
            "user_wealth_info": {
                "gift_amount": "",
                "recharge_amount": "",
                "total_amount": ""
            },
            "multi_store_id": "",
            "is_open_points_pay": "",
            "pay_rule": {
                "points_num_type": "",
                "points_num": "",
                "exchange_astrict": ""
            }
        }
    }
}

异常示例

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

错误码

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