[[TOC]]

= 礼品 =


== 自设定礼品 ==

> /app/trial/cache/setupGift.do

**说明**

> 由编辑在后台设置并设定展示位置

**提交方式**

> GET

**参数**

||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||
||pageNo||页数||int||1||是||
||pageSize||页面大小||int||10||是||
||type||礼品类型  1 表示精选优惠券   0 表示查找所有||int||0||否||
||for||1  首页   2  广场||int||1||否||
   
**返回**

{{{#!java
result: {
    status: 1,
    pageNo： 1,
    pageSize： 1,
    total: 1,
    pageTotal: 1,
    msg: '请求成功',
    data: [$setupGift]
}
}}}

[http://trac.pc.com.cn/pc_best/wiki/app2.0/object_properties#设定礼品 $setupGift]

----------

== 礼品列表 ==

> /app/gift/cache/listGift.do

**说明**

> 分页获取礼品列表，传入type为礼品的类型进行查找

**提交方式**

> GET

**参数**

||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||
||pageNo||页数||int||1||是||
||pageSize||页面大小||int||10||是||
||type||礼品类型： 1 礼品卡   2 实物礼品  3 优惠券||int||1||否||
||mallId||电商id，0表示查找所有||int||0||否||

**返回**

{{{#!java
result {
	status: 1
	pageNo： 1
	pageSize： 20,
	total: 100,
	pageTotal: 5,
	msg: '请求成功',
	data: [$gift]
}
}}}

[http://trac.pc.com.cn/pc_best/wiki/app2.0/object_properties#礼品 $gift]

----------

== 我的优惠券列表 ==

> /app/my/gift/listMyGiftExchange.do

**说明**

> 获取我的礼品列表，type=3的时候表示优惠券，包括未失效和已失效的

**提交方式**

> GET

**参数**

||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||
||pageNo||页数||int||1||是||
||pageSize||页面大小||int||10||是||
||type||1 礼品卡  2 实物礼品   3 优惠券||int||3||是||
||status||状态：0 已过期，1 未过期||String||""||是||
||common_session_id||-||String||""||是||

**返回**

{{{#!java
result {
	status: 1
	pageNo： 1
	pageSize： 20,
	total: 100,
	pageTotal: 5,
	msg: '请求成功',
	data: [$giftExchange]
}
}}}

[http://trac.pc.com.cn/pc_best/wiki/app2.0/object_properties#优惠券 $giftCoupon]

----------

== 优惠券信息 ==

> /app/gift/getGiftInfo.do

**说明**

> 返回渲染成wap页面

**提交方式**

> GET

**参数**

||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||
||giftId||礼品id||int||0||是||
||fontSize||wap页面字号||int||14||是||

**返回**

{{{#!java
result: {
	status: 1
	msg: '请求成功',
	data: {
            gift: $gift,
            giftDesc: $giftDesc,
            fontSize: 14
        }
}}}

[http://trac.pc.com.cn/pc_best/wiki/app2.0/object_properties#礼品 $gift]

[http://trac.pc.com.cn/pc_best/wiki/app2.0/object_properties#礼物描述 $giftDesc]

----------

== 领取优惠券接口 ==

> /app/my/gift/exchangeCoupon.do

**说明**

> 兑换优惠券接口，是否登录，是否已领完，是否已失效，金币，积分是否不足

**提交方式**

> POST

**参数**

||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||
||giftId||礼品Id，注意这里传入礼品的giftId而不是优惠券的couponId||int||0||是||
||common_session_id||-||String||""||是||

**返回**

{{{#!java
resul {
	status: 1,
	msg: '请求成功',
        data: {
            status:1,  // 1 兑换成功  -1  请刷新页面重试  -2 该优惠券无效   -3 该优惠券已过期  -4 兑换出错，请稍后再试。 -5 优惠券领取次数超过限制!  -6 金币或积分不足!  -7 该优惠券无效或已全部被兑换!  -8 兑换失败！
            cardNum: 123,
            giftStatus: 1,
            cardPassword: 123456,
            mallUrl: http://a.b.c,
            gold:1,
            score: 2
        }
}
}}}

----------

== 热门优惠券列表 ==

> /app/gift/cache/listHotCoupon.do

**说明**

> 获取热门优惠券

**提交方式**

> GET

**参数**

||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||
||giftId||需要过滤的优惠券，不传表示不进行过滤||int||0||否||
||limit||获取条数||int||10||否||

**返回**

{{{#!java
result: {
	status: 1,
	msg: '请求成功',
	limit: 10,
	data: [$gift]    
}
}}}

[http://trac.pc.com.cn/pc_best/wiki/app2.0/object_properties#优惠券 $giftCoupon]