LanTongSystem-接口文档

澜通云系统服务接口说明


根据会员id查询优惠券列表

<p>[TOC]</p> <h5>简要描述</h5> <ul> <li>根据会员id查询该会员账户的优惠券列表</li> <li>测试环境:<a href="http://119.8.54.173">http://119.8.54.173</a></li> <li>生产环境:<a href="https://ms.lantoncloud.com">https://ms.lantoncloud.com</a></li> </ul> <h5>请求URL</h5> <ul> <li>/lantong-system/couponreceive/list</li> </ul> <h5>请求方式</h5> <ul> <li>requestMethod: GET</li> </ul> <h5>请求参数</h5> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">说明</th> <th style="text-align: left;">必选</th> <th>类型</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">language</td> <td style="text-align: left;">language</td> <td style="text-align: left;">是</td> <td>string</td> </tr> <tr> <td style="text-align: left;">airLine</td> <td style="text-align: left;">航司编码</td> <td style="text-align: left;">否</td> <td>string</td> </tr> <tr> <td style="text-align: left;">couponCollectionStatus</td> <td style="text-align: left;">优惠券领取状态:1为已使用,0为已领取未使用,-1为已过期</td> <td style="text-align: left;">否</td> <td>ref</td> </tr> <tr> <td style="text-align: left;">couponStatus</td> <td style="text-align: left;">优惠券状态:1生效 2失效 3已结束</td> <td style="text-align: left;">否</td> <td>ref</td> </tr> <tr> <td style="text-align: left;">couponType</td> <td style="text-align: left;">优惠券类型:1满减券 2叠加满减券 3 无门槛折扣券 4门槛折扣券 5无门槛券(需要限制大小)</td> <td style="text-align: left;">否</td> <td>ref</td> </tr> <tr> <td style="text-align: left;">memberId</td> <td style="text-align: left;">会员id</td> <td style="text-align: left;">是</td> <td>ref</td> </tr> <tr> <td style="text-align: left;">routeFromCityCode</td> <td style="text-align: left;">出发地三字码</td> <td style="text-align: left;">否</td> <td>string</td> </tr> <tr> <td style="text-align: left;">routeToCityCode</td> <td style="text-align: left;">目的地三字码</td> <td style="text-align: left;">否</td> <td>string</td> </tr> <tr> <td style="text-align: left;">used</td> <td style="text-align: left;">优惠券版块:1.快运、2.机票、3.优选</td> <td style="text-align: left;">否</td> <td>ref</td> </tr> <tr> <td style="text-align: left;">id</td> <td style="text-align: left;">id</td> <td style="text-align: left;">否</td> <td>integer(int64)</td> </tr> </tbody> </table> <h5>返回示例</h5> <pre><code>{ "code": 200, "success": true, "data": [ { "id": "1597146894256050178", "createUser": "1442335070915432449", "createDept": -1, "createTime": "2022-11-28 16:34:28", "updateUser": "1442335070915432449", "updateTime": "2022-11-28 16:34:28", "status": -1, "isDeleted": -1, "memberId": "1518919646294601730", "couponId": "1597146695529926658", "couponMoney": "3.00", "fullMoney": "0.00", "drawTime": "2022-11-28 16:34:28", "popUpStatus": 1, "popUpId": "1597146893996003329", "activitiCode": "", "type": 0, "startTime": "", "endTime": "", "validStartTime": "2022-11-28 00:00:00", "validEndTime": "2022-11-30 00:00:00", "timeZone": "", "couponName": "测试优惠券", "couponType": "5", "maximumDiscountAmount": -1, "couponDiscount": 0, "currencyType": "USD", "couponBgImg": "https://lantongcloud.obs.ap-southeast-1.myhuaweicloud.com:443/upload/20221128/dfef78eb21a8ca55ffcb88766480925a.png", "couponIcon": "https://lantongcloud.obs.ap-southeast-1.myhuaweicloud.com:443/upload/20221128/d468d1ef13378203f734cad78dc8dac3.png", "couponInstructions": "1. 法律上飞机螺丝钉\n2. 放射疗法到了付款时间\n3. 萨菲罗斯大幅减少了", "profile": "121", "couponAmountStr": "$3.0", "coupon": [], "couponPopUp": {} } ], "msg": "操作成功" }</code></pre> <h5>返回参数说明</h5> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">说明</th> <th>类型</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">code</td> <td style="text-align: left;">状态码</td> <td>integer(int32)</td> </tr> <tr> <td style="text-align: left;">data</td> <td style="text-align: left;">承载数据</td> <td>array CouponReceiveVO对象</td> </tr> <tr> <td style="text-align: left;">activitiCode</td> <td style="text-align: left;">活动编号</td> <td>string</td> </tr> <tr> <td style="text-align: left;">coupon</td> <td style="text-align: left;">优惠券详情</td> <td>array Coupon对象</td> </tr> <tr> <td style="text-align: left;">airCoupon</td> <td style="text-align: left;"></td> <td>array AirCoupon对象</td> </tr> <tr> <td style="text-align: left;">airLine</td> <td style="text-align: left;">航司编码</td> <td>string</td> </tr> <tr> <td style="text-align: left;">couponId</td> <td style="text-align: left;">优惠券表id值</td> <td>integer</td> </tr> <tr> <td style="text-align: left;">createDept</td> <td style="text-align: left;">创建部门</td> <td>integer</td> </tr> <tr> <td style="text-align: left;">createTime</td> <td style="text-align: left;">创建时间</td> <td>string</td> </tr> <tr> <td style="text-align: left;">createUser</td> <td style="text-align: left;">创建人</td> <td>integer</td> </tr> <tr> <td style="text-align: left;">id</td> <td style="text-align: left;"></td> <td>integer</td> </tr> <tr> <td style="text-align: left;">isDeleted</td> <td style="text-align: left;">是否已删除</td> <td>integer</td> </tr> <tr> <td style="text-align: left;">routeFromCityCode</td> <td style="text-align: left;">出发地三字码</td> <td>string</td> </tr> <tr> <td style="text-align: left;">routeToCityCode</td> <td style="text-align: left;">目的地三字码</td> <td>string</td> </tr> <tr> <td style="text-align: left;">status</td> <td style="text-align: left;">业务状态</td> <td>integer</td> </tr> <tr> <td style="text-align: left;">updateTime</td> <td style="text-align: left;">更新时间</td> <td>string</td> </tr> <tr> <td style="text-align: left;">updateUser</td> <td style="text-align: left;">更新人</td> <td>integer</td> </tr> <tr> <td style="text-align: left;">airLineList</td> <td style="text-align: left;"></td> <td>array string</td> </tr> <tr> <td style="text-align: left;">bgImg</td> <td style="text-align: left;">背景图片</td> <td>string</td> </tr> <tr> <td style="text-align: left;">cityCodeList</td> <td style="text-align: left;"></td> <td>array string</td> </tr> <tr> <td style="text-align: left;">code</td> <td style="text-align: left;">优惠券编码</td> <td>string</td> </tr> <tr> <td style="text-align: left;">couponAmount</td> <td style="text-align: left;">优惠券金额</td> <td>number</td> </tr> <tr> <td style="text-align: left;">couponDiscount</td> <td style="text-align: left;">优惠券折扣</td> <td>number</td> </tr> <tr> <td style="text-align: left;">createDept</td> <td style="text-align: left;"></td> <td>integer</td> </tr> <tr> <td style="text-align: left;">createTime</td> <td style="text-align: left;">创建时间</td> <td>string</td> </tr> <tr> <td style="text-align: left;">createUser</td> <td style="text-align: left;">创建人</td> <td>integer</td> </tr> <tr> <td style="text-align: left;">currencyType</td> <td style="text-align: left;">货币类型</td> <td>string</td> </tr> <tr> <td style="text-align: left;">endTime</td> <td style="text-align: left;">发放结束时间</td> <td>string</td> </tr> <tr> <td style="text-align: left;">expiredBgImg</td> <td style="text-align: left;">过期、已使用背景图片</td> <td>string</td> </tr> <tr> <td style="text-align: left;">icon</td> <td style="text-align: left;">图标</td> <td>string</td> </tr> <tr> <td style="text-align: left;">id</td> <td style="text-align: left;">主键id</td> <td>integer</td> </tr> <tr> <td style="text-align: left;">instructions</td> <td style="text-align: left;">使用说明</td> <td>string</td> </tr> <tr> <td style="text-align: left;">instructionsEn</td> <td style="text-align: left;">使用说明英文</td> <td>string</td> </tr> <tr> <td style="text-align: left;">instructionsKn</td> <td style="text-align: left;">使用说明柬文</td> <td>string</td> </tr> <tr> <td style="text-align: left;">isDeleted</td> <td style="text-align: left;"></td> <td>integer</td> </tr> <tr> <td style="text-align: left;">maximumDiscountAmount</td> <td style="text-align: left;">折扣金额上限</td> <td>number</td> </tr> <tr> <td style="text-align: left;">profile</td> <td style="text-align: left;">简介</td> <td>string</td> </tr> <tr> <td style="text-align: left;">profileEn</td> <td style="text-align: left;">简介-英文</td> <td>string</td> </tr> <tr> <td style="text-align: left;">profileKn</td> <td style="text-align: left;">简介-柬文</td> <td>string</td> </tr> <tr> <td style="text-align: left;">quota</td> <td style="text-align: left;">配额:发券数量</td> <td>integer</td> </tr> <tr> <td style="text-align: left;">startTime</td> <td style="text-align: left;">发放开始时间</td> <td>string</td> </tr> <tr> <td style="text-align: left;">status</td> <td style="text-align: left;">业务状态</td> <td>integer</td> </tr> <tr> <td style="text-align: left;">takeCount</td> <td style="text-align: left;">已领取的优惠券数量</td> <td>integer</td> </tr> <tr> <td style="text-align: left;">timeZone</td> <td style="text-align: left;">时区</td> <td>string</td> </tr> <tr> <td style="text-align: left;">title</td> <td style="text-align: left;">优惠券标题(有图片则显示图片):无门槛50元优惠券 ,单品最高减2000元</td> <td>string</td> </tr> <tr> <td style="text-align: left;">titleEn</td> <td style="text-align: left;">优惠券标题英文</td> <td>string</td> </tr> <tr> <td style="text-align: left;">titleKn</td> <td style="text-align: left;">优惠券标题柬文</td> <td>string</td> </tr> <tr> <td style="text-align: left;">type</td> <td style="text-align: left;">1满减券 2叠加满减券 3 无门槛折扣券 4门槛折扣券 5无门槛券(需要限制大小)</td> <td>integer</td> </tr> <tr> <td style="text-align: left;">updateTime</td> <td style="text-align: left;">更新时间</td> <td>string</td> </tr> <tr> <td style="text-align: left;">updateUser</td> <td style="text-align: left;">更新人</td> <td>integer</td> </tr> <tr> <td style="text-align: left;">used</td> <td style="text-align: left;">可用于:快运、机票、</td> <td>integer</td> </tr> <tr> <td style="text-align: left;">usedCount</td> <td style="text-align: left;">已使用的优惠券数量</td> <td>integer</td> </tr> <tr> <td style="text-align: left;">validDays</td> <td style="text-align: left;">自领取之日起有效天数</td> <td>integer</td> </tr> <tr> <td style="text-align: left;">validEndTime</td> <td style="text-align: left;">使用结束时间</td> <td>string</td> </tr> <tr> <td style="text-align: left;">validStartTime</td> <td style="text-align: left;">使用开始时间</td> <td>string</td> </tr> <tr> <td style="text-align: left;">validType</td> <td style="text-align: left;">时效:1绝对时效(领取后XXX-XXX时间段有效) 2相对时效(领取后N天有效)</td> <td>integer</td> </tr> <tr> <td style="text-align: left;">withAmount</td> <td style="text-align: left;">满多少金额</td> <td>number</td> </tr> <tr> <td style="text-align: left;">withSn</td> <td style="text-align: left;">商品/航线/快运业务线</td> <td>string</td> </tr> <tr> <td style="text-align: left;">withSpecial</td> <td style="text-align: left;">1可用于特价商品 2不能 默认不能(商品优惠卷除外)</td> <td>integer</td> </tr> <tr> <td style="text-align: left;">couponAmountStr</td> <td style="text-align: left;">券额格式化字符串</td> <td>string</td> </tr> <tr> <td style="text-align: left;">couponBgImg</td> <td style="text-align: left;">优惠券背景图片</td> <td>string</td> </tr> <tr> <td style="text-align: left;">couponDiscount</td> <td style="text-align: left;">优惠券折扣</td> <td>number(double)</td> </tr> <tr> <td style="text-align: left;">couponIcon</td> <td style="text-align: left;">优惠券图标</td> <td>string</td> </tr> <tr> <td style="text-align: left;">couponId</td> <td style="text-align: left;">优惠券编号</td> <td>integer(int64)</td> </tr> <tr> <td style="text-align: left;">couponInstructions</td> <td style="text-align: left;">优惠券使用说明</td> <td>string</td> </tr> <tr> <td style="text-align: left;">couponMoney</td> <td style="text-align: left;">券额</td> <td>number</td> </tr> <tr> <td style="text-align: left;">couponName</td> <td style="text-align: left;">优惠券名称</td> <td>string</td> </tr> <tr> <td style="text-align: left;">couponPopUp</td> <td style="text-align: left;">弹窗对象</td> <td>CouponPopUp对象</td> </tr> <tr> <td style="text-align: left;">cambodianBackgroundPicture</td> <td style="text-align: left;">柬文背景图片</td> <td>string</td> </tr> <tr> <td style="text-align: left;">cambodianContent</td> <td style="text-align: left;">柬文内容</td> <td>string</td> </tr> <tr> <td style="text-align: left;">cambodianTitle</td> <td style="text-align: left;">柬文标题</td> <td>string</td> </tr> <tr> <td style="text-align: left;">chineseBackgroundPicture</td> <td style="text-align: left;">中文背景图片</td> <td>string</td> </tr> <tr> <td style="text-align: left;">chineseContent</td> <td style="text-align: left;">中文内容</td> <td>string</td> </tr> <tr> <td style="text-align: left;">chineseTitle</td> <td style="text-align: left;">中文标题</td> <td>string</td> </tr> <tr> <td style="text-align: left;">couponId</td> <td style="text-align: left;">优惠券Id(多个优惠劵id使用','隔开)</td> <td>string</td> </tr> <tr> <td style="text-align: left;">couponPromptPageId</td> <td style="text-align: left;">弹窗类型id</td> <td>integer</td> </tr> <tr> <td style="text-align: left;">createDept</td> <td style="text-align: left;"></td> <td>integer</td> </tr> <tr> <td style="text-align: left;">createTime</td> <td style="text-align: left;">创建时间</td> <td>string</td> </tr> <tr> <td style="text-align: left;">createUser</td> <td style="text-align: left;">创建人</td> <td>integer</td> </tr> <tr> <td style="text-align: left;">englishBackgroundPicture</td> <td style="text-align: left;">英文背景图片</td> <td>string</td> </tr> <tr> <td style="text-align: left;">englishContent</td> <td style="text-align: left;">英文内容</td> <td>string</td> </tr> <tr> <td style="text-align: left;">englishTitle</td> <td style="text-align: left;">英文标题</td> <td>string</td> </tr> <tr> <td style="text-align: left;">id</td> <td style="text-align: left;">主键id</td> <td>integer</td> </tr> <tr> <td style="text-align: left;">isDeleted</td> <td style="text-align: left;">是否被删除</td> <td>integer</td> </tr> <tr> <td style="text-align: left;">isRelevancyCoupon</td> <td style="text-align: left;">是否关联优惠券</td> <td>boolean</td> </tr> <tr> <td style="text-align: left;">loseEfficacyTime</td> <td style="text-align: left;">失效时间</td> <td>string</td> </tr> <tr> <td style="text-align: left;">popUpSection</td> <td style="text-align: left;">弹框业务版块(系统首页、机票、优选 等等)</td> <td>string</td> </tr> <tr> <td style="text-align: left;">skipLinks</td> <td style="text-align: left;">跳转链接</td> <td>string</td> </tr> <tr> <td style="text-align: left;">status</td> <td style="text-align: left;">业务状态</td> <td>integer</td> </tr> <tr> <td style="text-align: left;">takeEffectTime</td> <td style="text-align: left;">生效时间</td> <td>string</td> </tr> <tr> <td style="text-align: left;">terminal</td> <td style="text-align: left;">作用终端(安卓为2、ios为1、全部为0)</td> <td>string</td> </tr> <tr> <td style="text-align: left;">updateTime</td> <td style="text-align: left;">更新时间</td> <td>string</td> </tr> <tr> <td style="text-align: left;">updateUser</td> <td style="text-align: left;">更新人</td> <td>integer</td> </tr> <tr> <td style="text-align: left;">couponType</td> <td style="text-align: left;">优惠券类型</td> <td>string</td> </tr> <tr> <td style="text-align: left;">createDept</td> <td style="text-align: left;"></td> <td>integer(int64)</td> </tr> <tr> <td style="text-align: left;">createTime</td> <td style="text-align: left;">创建时间</td> <td>string(date-time)</td> </tr> <tr> <td style="text-align: left;">createUser</td> <td style="text-align: left;">创建人</td> <td>integer(int64)</td> </tr> <tr> <td style="text-align: left;">currencyType</td> <td style="text-align: left;">货币类型</td> <td>string</td> </tr> <tr> <td style="text-align: left;">drawTime</td> <td style="text-align: left;">领取时间</td> <td>string</td> </tr> <tr> <td style="text-align: left;">endTime</td> <td style="text-align: left;">活动结束时间</td> <td>string</td> </tr> <tr> <td style="text-align: left;">fullMoney</td> <td style="text-align: left;">金额满</td> <td>number</td> </tr> <tr> <td style="text-align: left;">id</td> <td style="text-align: left;">主键id</td> <td>integer(int64)</td> </tr> <tr> <td style="text-align: left;">isDeleted</td> <td style="text-align: left;"></td> <td>integer(int32)</td> </tr> <tr> <td style="text-align: left;">maximumDiscountAmount</td> <td style="text-align: left;">折扣金额上限</td> <td>number</td> </tr> <tr> <td style="text-align: left;">memberId</td> <td style="text-align: left;">会员ID</td> <td>integer(int64)</td> </tr> <tr> <td style="text-align: left;">popUpId</td> <td style="text-align: left;">弹窗信息id</td> <td>integer(int64)</td> </tr> <tr> <td style="text-align: left;">popUpStatus</td> <td style="text-align: left;">弹窗状态(1为弹窗,0为未弹窗)</td> <td>integer(int32)</td> </tr> <tr> <td style="text-align: left;">profile</td> <td style="text-align: left;">简介</td> <td>string</td> </tr> <tr> <td style="text-align: left;">startTime</td> <td style="text-align: left;">活动开始时间</td> <td>string</td> </tr> <tr> <td style="text-align: left;">status</td> <td style="text-align: left;">业务状态</td> <td>integer(int32)</td> </tr> <tr> <td style="text-align: left;">timeZone</td> <td style="text-align: left;">时区</td> <td>string</td> </tr> <tr> <td style="text-align: left;">type</td> <td style="text-align: left;">优惠券发放类型</td> <td>integer(int32)</td> </tr> <tr> <td style="text-align: left;">updateTime</td> <td style="text-align: left;">更新时间</td> <td>string(date-time)</td> </tr> <tr> <td style="text-align: left;">updateUser</td> <td style="text-align: left;">更新人</td> <td>integer(int64)</td> </tr> <tr> <td style="text-align: left;">validEndTime</td> <td style="text-align: left;">有效结束时间</td> <td>string(date-time)</td> </tr> <tr> <td style="text-align: left;">validStartTime</td> <td style="text-align: left;">有效开始时间</td> <td>string(date-time)</td> </tr> <tr> <td style="text-align: left;">msg</td> <td style="text-align: left;">返回消息</td> <td>string</td> </tr> <tr> <td style="text-align: left;">success</td> <td style="text-align: left;">是否成功</td> <td>boolean</td> </tr> </tbody> </table> <h5>code码说明</h5> <table> <thead> <tr> <th style="text-align: left;">code</th> <th style="text-align: left;">说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">200</td> <td style="text-align: left;">成功</td> </tr> <tr> <td style="text-align: left;">500</td> <td style="text-align: left;">加载失败</td> </tr> </tbody> </table>

页面列表

ITEM_HTML