礼包.md 4.08 KB

#礼包接口

接口列表

接口名称 接口描述
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" : "银卡升级礼包",
            "desc" : "多张优惠券只能使用一张", -- 礼包描述
            "dateTitle" : "领取有效期", -- 有效期描述
            "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" : "生日礼包",
            "desc" : "多张优惠券只能使用一张", -- 礼包描述
            "dateTitle" : "领取有效期", -- 有效期描述
            "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
    }
}