企迈云-开放平台

API 2.0

API 2.0 > 2.1 基础数据 > 2.1.6 获取会员卡相关信息

2.1.6 获取会员卡相关信息

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

场景描述：根据企迈云商会员ID，查询当前会员会员卡基本信息

零售餐饮

请求地址

请求方式	版本信息	请求地址
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-cards	接口方法
Params	array	是		业务参数

请求参数

参数	参数类型	是否必填	默认值	描述
user_id	int	是		用户id

响应参数

参数	参数类型	描述
user_id	int	用户id
title	string	会员卡名称
lev	int	会员卡等级
lev_id	int	会员卡等级设置id
user_lev_id	int	用户会员等级
discount	int	会员卡折扣

请求示例

{
    "OpenId": "6dc05b4ac175cf316d226252b05cf685",
    "GrantCode": "782c281f62",
    "Timestamp": "1547186244",
    "Nonce": "658965",
    "Token": "0%2B%2B3c6hthjwAml4ABAXOYF4Q6UY%3D",
    "Action": "user.user-cards",
    "Params": {
        "user_id": ""
    }
}

响应示例

{
    "status": "true",
    "code": "0",
    "message": "说明",
    "data": {
        "user_id": "",
        "title": "",
        "lev": "",
        "lev_id": "",
        "user_lev_id": "",
        "discount": ""
    }
}

异常示例

{
    "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-cards	接口方法
Params	array	是		业务参数

请求参数

参数	参数类型	是否必填	默认值	描述
user_id	int	是		用户id

响应参数

参数	参数类型	描述
status	bool	成功或失败
code	int	成功/错误编码
message	string	成功/错误描述
data	array
├card	array
├id	int	自增长id
├user_id	int	用户id
├store_cards_id	int	店铺会员卡id
├cards_no	int	会员卡号
├is_default	int	是否当前使用的卡
├is_weixin_card_syn	int	是否领取
├is_weixin_card	int	是否同步到微信卡券 1是 0否
├user_card_code	string	验证码
├more	string	其他信息
├created_at	TimeStamp	创建时间
├grade_id	int	等级ID
├discount	Money(分)	会员卡折扣
├level_name	string	等级名称

请求示例

{
    "OpenId": "6dc05b4ac175cf316d226252b05cf685",
    "GrantCode": "782c281f62",
    "Timestamp": "1547186244",
    "Nonce": "658965",
    "Token": "0%2B%2B3c6hthjwAml4ABAXOYF4Q6UY%3D",
    "Action": "user.user-cards",
    "Params": {
        "user_id": ""
    }
}

响应示例

{
    "status": "true",
    "code": "0",
    "message": "说明",
    "data": {
        "card": {
            "id": "",
            "user_id": "",
            "store_cards_id": "",
            "cards_no": "",
            "is_default": "",
            "is_weixin_card_syn": "",
            "is_weixin_card": "",
            "user_card_code": "",
            "more": "",
            "created_at": "",
            "grade_id": "",
            "discount": ""
        },
        "level_name": ""
    }
}

异常示例

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

错误码

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