企迈云-开放平台

API 2.0

API 2.0 > 5.2 会员查询 > 5.2.10 用户优惠券日志记录

5.2.10 用户优惠券日志记录

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

场景描述：获取优惠券日志

零售

请求地址

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

公共参数

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

请求参数

参数	参数类型	是否必填	描述
user_id	int	否	用户id
start_time	DateTime	否	开始时间
end_time	DateTime	否	结束时间（开始时间填了结束时间必填）
coupon_status	coupon_status	否	优惠券适用状态 0表示未使用 1表示已使用 2表示已核销 3表示优惠券退回
page	int	否	当前页
page_size	int	否	每页显示数据数

响应参数

参数	参数类型	描述
status	bool	成功或失败
code	int	成功/错误编码
message	string	成功/错误描述
data	array
├current_page	int	当前页
├per_page	int	每页显示数
├last_page	int	最后一页
├total	int	总条数
├reta_list	array
├0	array
├id	int	日志主键id
├user_coupon_id	int	用户领取优惠券id
├user_id	int	用户id
├multi_store_id	int	多门店id
├coupon_name	string	优惠券名称
├user_coupon_status	int	优惠券适用状态 0表示未使用 1表示已使用 2表示已核销 3表示优惠券退回',
├user_coupon_verify_barcode	string	优惠券核销码
├user_coupon_verify_name	string	优惠券核销人
├user_coupon_order_number	string	使用优惠券订单号
├created_at	DateTime	创建时间
├updated_at	DateTime	更新时间
├start_at	DateTime	优惠券有效期开始时间
├end_at	DateTime	优惠券有效期结束时间

请求示例

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

响应示例

{
    "status": "true",
    "code": "0",
    "message": "说明",
    "data": {
        "current_page": "1",
        "per_page": "10",
        "last_page": "",
        "total": "",
        "reta_list": [
            {
                "id": "",
                "user_coupon_id": "",
                "user_id": "",
                "multi_store_id": "",
                "coupon_name": "",
                "user_coupon_status": "",
                "user_coupon_verify_barcode": "",
                "user_coupon_verify_name": "",
                "user_coupon_order_number": "",
                "created_at": "",
                "updated_at": "",
                "start_at": "2019-10-15 00:00:00",
                "end_at": "2019-10-15 00:00:00"
            }
        ]
    }
}

异常示例

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

错误码

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