黄敬囿 / API-Interfaces · Files

#礼包接口

接口列表

接口名称	接口描述
app.giftBag.getCouponsBagList	查询礼包列表信息
app.giftBag.drawCouponsBag	用户领取礼包
app.giftBag.getCouponsBagCnt	可以领取的礼包数量

接口描述

1、查询礼包的列表信息(app.giftBag.getCouponsBagList)

请求参数

Param Name	Param Type	Required	Param Value	Desc
method	String	true	app.giftBag.getCouponsBagList	请求方法
uid	int	true	7893817	用户ID
page	int	true	1	页码
limit	int	true	10	单页条数

响应内容

{
    "alg": "SALT_MD5",
    "code": 200,
    "data": [
        {
            "id" : 2,
            "name" : "银卡升级礼包",
            "startTime": "2018-04-10 12:00:00", -- 领取开始时间
            "endTime": "2018-04-17 23:59:59", -- 领取截止时间
            "status": 1, -- 是否已领取 未领取：0，已领取：1；
            "notExpired": true -- 未过期：true，过期：false；
        },
        {
            "id" : 4,
            "name" : "生日礼包",
            "startTime": "2018-04-10 12:00:00", -- 领取开始时间
            "endTime": "2018-04-17 23:59:59", -- 领取截止时间
            "status": 1, -- 是否已领取 未领取：0，已领取：1；
            "notExpired": true -- 未过期：true，过期：false；
        }
    ]
}

2、领取礼包(app.giftBag.drawCouponsBag)

请求参数

Param Name	Param Type	Required	Param Value	Desc
method	String	true	app.giftBag.drawCouponsBag	请求方法
uid	int	true	7893817	用户ID
couponsBagId	int	true	23121	礼包id

响应内容

{
    "alg": "SALT_MD5",
    "code": 200,
    "data": [
        {
            "couponAmount": 50,
            "couponCode": "",
            "couponName": "4月生日券-满199减50",
            "endTime": "2017-04-30 09:45:40",
            "id": 2030,
            "startTime": "2013-04-01 00:00:00",
            "status": 1,
            "useLimit": "199",
            "useLimitType": "2"
        },
        {
            "couponAmount": 300,
            "couponCode": "",
            "couponName": "12月生日券-满799减300",
            "endTime": "2017-01-31 09:45:40",
            "id": 2033,
            "startTime": "2013-12-01 00:00:00",
            "status": 1,
            "useLimit": "799",
            "useLimitType": "2"
        },
        {
            "couponAmount": 50,
            "couponCode": "",
            "couponName": "1月生日券-满199减50",
            "endTime": "2017-01-31 09:45:40",
            "id": 2035,
            "startTime": "2014-01-01 00:00:00",
            "status": 1,
            "useLimit": "199",
            "useLimitType": "2"
        },
        {
            "couponAmount": 300,
            "couponCode": "",
            "couponName": "1月生日券-满799减300",
            "endTime": "2017-01-31 09:45:40",
            "id": 2038,
            "startTime": "2014-01-01 00:00:00",
            "status": 1,
            "useLimit": "799",
            "useLimitType": "2"
        }
    ],
    "md5": "c957283765172838f577de4228d45a42",
    "message": "请求成功"
}

3、可以领取的礼包数量(app.giftBag.getCouponsBagCnt)

请求参数

Param Name	Param Type	Required	Param Value	Desc
method	String	true	app.giftBag.getCouponsBagCnt	请求方法
uid	int	true	7893817	用户ID

响应内容

{
    "alg": "SALT_MD5",
    "code": 200,
    "data": 
    {
        "total": 4
    }
}