V1/user/my coupon list

功能说明

获取用户优惠券列表 本接口是全平台通用的，即发送请求后，可根据请求中传入的平台参数返回发送状态。

URL

正式环境
http://api.fumubang.com/v1/user/my_coupon_list
测试环境
http://api.fumubang.net/v1/user/my_coupon_list

格式

json

HTTP请求方式

POST

输入参数说明

参数名称	是否必须	类型	描述
uid	是	int	用户UID
type	否	int	类型 1能用的 0不能用的
page	否	int	第几页
page_size	否	int	每页几条
version	否	int	1.6版本以下默认不传版本号，1.6版本以上需要传版本号
activity_id	是	string	1.确认订单页选择优惠券时传入活动id,多个以半角逗号分隔.服务器端将活动id不为0,但活动id又不在该参数值范围内的数据过滤掉 2.进入"我的优惠券"列表该值写0
filter_info	是	string	{"activity":[{"aid":"100493","money":"0.02"},{"aid":"100495","money":"90"}],"app_sub_money":"2.00"}数据类似 服务器优惠券筛选条件

请求示例

http://api.fumubang.com/v1/user/my_coupon_list

参数用POST方式提交

返回方式说明

xml或json

正确返回说明

<?xml version="1.0" encoding="utf-8"?>

 <page> 分页信息
<page>1</page>
<page_size>5</page_size>
<count>53</count>
</page>
<list>
<item>
<use_status>2</use_status>使用状态 0为未使用 1为使用中 2为已使用 3是已冻结
<coupon_type>1</coupon_type>
<activity_id>9209</activity_id>活动专享优惠券的活动ID，默认为0
<coupon_sn>1ekd2kj423</coupon_sn>代金券id
<use_limit>0</use_limit>  优惠券使用范围 0为无限制
<coupon_money>30</coupon_money> 优惠券金额
<min_amount>30.01</min_amount>  优惠券使用的最小订单金额
<coupon_start_time>2014-07-01 00:00:00</coupon_start_time> 代金券使用开始时间
<coupon_end_time>2014-07-31 00:00:00</coupon_end_time> 优惠券使用截至时间
<order_sn>20140714173658753265</order_sn>  代金券使用时绑定的订单
<use_time>2014-07-14 17:36:58</use_time>  代金券使用时间
<use_time_stamp>1405330618</use_time_stamp>
<coupon_type_cn>代金券</coupon_type_cn>  代金券类型名字
<coupon_status_cn>已使用</coupon_status_cn> 代金券状态
<start_time>2014-07-01</start_time> 代金券使用开始时间
<end_time>2014-07-31</end_time> 优惠券使用截至时间
<activity_title>测试B</activity_title>活动标题：如果此优惠券为活动专享券，则返回活动标题，否则返回空字符串
<cate_name>限亲子活动、家庭旅行使用</cate_name>限品类名称
<plat>限APP使用</plat>限平台名称
<min_amount>满1.01可用</min_amount>满多少钱使用
<coupon_tag>购买100645</coupon_tag>代金券标签
<is_use_status>1</is_use_status>当前订单是否可用：0否1可用（2.6增加）
<date_limit>1</date_limit>因为使用日期限制导致优惠券不能使用：1是  0否（3.04增加）
<is_kdq>1</is_kdq>过期状态：0正常，1快过期，2已过期（2.6增加）3新入账（3.35增加）
<parent_cate>45</parent_cate> 如果是限分类优惠券，则返回限制的父分类名称，为优惠券点击跳转准备，如果限制为父分类，则子分类返回""（3.2新增）
<child_cate/>如果是限分类优惠券，则返回限制的子分类，为优惠券点击跳转准备（3.2新增）
<child_cate_name/>如果是限分类优惠券，则返回限制的子分类名称(3.2新增)
<ticket_type>4</ticket_type>限活动的优惠券需要返回活动的类型：1普通4酒店(3.2新增)
<selected>1</selected>是否默认选中：1是0否
</item>
<item>
<use_status>2</use_status>
<coupon_type>1</coupon_type>
<activity_id>0</activity_id>
<coupon_sn>1qkd2kj423</coupon_sn>
<use_limit>0</use_limit>
<coupon_money>60</coupon_money>
<coupon_start_time>2014-07-10 00:00:00</coupon_start_time>
<coupon_end_time>2014-07-31 00:00:00</coupon_end_time>
<order_sn>20140714181506807171</order_sn>
<use_time>2014-07-14 18:15:07</use_time>
<use_time_stamp>1405332907</use_time_stamp>
<coupon_type_cn>代金券</coupon_type_cn>
<coupon_status_cn>已使用</coupon_status_cn>

</item>
<item>
<use_status>1</use_status>
<coupon_type>1</coupon_type>
<activity_id>0</activity_id>
<coupon_sn>2aVpUVCDZMum</coupon_sn>
<use_limit>0</use_limit>
<coupon_money>30</coupon_money>
<coupon_start_time>2014-07-01 00:00:00</coupon_start_time>
<coupon_end_time>2014-08-15 23:59:59</coupon_end_time>
<order_sn>20140812171006886279</order_sn>
<use_time>2014-08-12 17:10:07</use_time>
<use_time_stamp>1407834607</use_time_stamp>
<coupon_type_cn>代金券</coupon_type_cn>
<coupon_status_cn>使用中</coupon_status_cn>
<activity_title/>
</item>
<item>
<use_status>0</use_status>
<coupon_type>1</coupon_type>
<activity_id>0</activity_id>
<coupon_sn>2Ne4p2V3dj7M</coupon_sn>
<use_limit>0</use_limit>
<coupon_money>100</coupon_money>
<coupon_start_time>2014-07-01 00:00:00</coupon_start_time>
<coupon_end_time>2014-07-31 23:59:59</coupon_end_time>
<order_sn/>
<use_time>0000-00-00 00:00:00</use_time>
<use_time_stamp>0</use_time_stamp>
<coupon_type_cn>代金券</coupon_type_cn>
<coupon_status_cn>已过期</coupon_status_cn>
<activity_title/>
</item>
<item>
<use_status>0</use_status>
<coupon_type>1</coupon_type>
<activity_id>0</activity_id>
<coupon_sn>2pQZwNfTf8js</coupon_sn>
<use_limit>0</use_limit>
<coupon_money>10000</coupon_money>
<coupon_start_time>2014-08-01 00:00:00</coupon_start_time>
<coupon_end_time>2014-08-26 23:59:59</coupon_end_time>
<order_sn/>
<use_time>0000-00-00 00:00:00</use_time>
<use_time_stamp>0</use_time_stamp>
<coupon_type_cn>代金券</coupon_type_cn>
<coupon_status_cn>已过期</coupon_status_cn>
<activity_title/>
</item>
</list>

错误返回示例

参数不全

<error_code>301001</error_code>

<error_msg>无数据</error_msg>