[[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/listMyCoupon.do

**说明**

> 获取我的优惠券，包括未失效和已失效的

**提交方式**

> GET

**参数**

||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||
||pageNo||页数||int||1||是||
||pageSize||页面大小||int||10||是||
||common_session_id||-||String||""||是||

**返回**

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

[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
}
}}}

[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

**参数**

||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||
||couponId||优惠券id||int||0||是||
||common_session_id||-||String||""||是||

**返回**

{{{#!java
resul {
	status: 1
	msg: '兑换成功'
}
}}}

----------

== 热门优惠券列表 ==

> /app/gift/cache/listHotCoupon.do

**说明**

> 获取热门优惠券

**提交方式**

> GET

**参数**

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

**返回**

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

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