企迈云-开放平台

API 2.0

API 2.0 > 2.2 积分 > 2.2.1 获取会员积分明细列表

2.2.1 获取会员积分明细列表

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

场景描述：根据企迈云商用户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-points-records	接口方法
Params	array	是		业务参数

请求参数

参数	参数类型	是否必填	默认值	描述
user_id	int	是		用户 ID
page_size	int	否	10	每页多少条数据
page	int	否	1	页码

响应参数

参数	参数类型	描述
status	bool	请求成功或者失败
code	int	成功/错误编码
message	string	成功/错误描述
data	array
├current_page	int	当前页码
├per_page	int	每页显示多少条
├last_page	int	共有多少页
├total	int	共有多少条数据
├item_list	array
├0	array
├previous_point	int	积分变更前的积分数
├type	int	类型: 1 ：奖励积分 2 ：消耗积分
├sub_type	int	type=2时的消耗类型，1：兑换优惠券，2：订单购买力
├sub_name	string	type=2时，优惠券名称、购买商品名称
├points	int	积分数
├desc	string	备注
├created_at	DateTime	创建时间
├change_text	string	变更明细

请求示例

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

响应示例

{
    "status": "true",
    "code": "0",
    "message": "说明",
    "data": {
        "current_page": "",
        "per_page": "",
        "last_page": "",
        "total": "",
        "item_list": [
            {
                "previous_point": "",
                "type": "",
                "sub_type": "",
                "sub_name": "",
                "points": "",
                "desc": "",
                "created_at": "",
                "change_text": ""
            }
        ]
    }
}

异常示例

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

请求参数

参数	参数类型	是否必填	默认值	描述
user_id	int	是		用户 ID
page_size	int	否	10	每页多少条数据
page	int	否	1	页码
type	string	否		筛选: all 全部; in 收入; out 支出

响应参数

参数	参数类型	描述
data	array
├item_list	array
├0	array
├type	int	类型: 1 ：奖励积分 2 ：消耗积分
├created_at	DateTime	创建时间
├points	int	奖励或消耗的积分
├source_desc	string	积分描述

请求示例

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

响应示例

{
    "status": "true",
    "code": "0",
    "message": "说明",
    "data": {
        "data": {
            "item_list": [
                {
                    "type": "",
                    "created_at": "",
                    "points": "",
                    "source_desc": ""
                }
            ]
        }
    }
}

异常示例

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

错误码

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