大平台——App客户端接口

App接口


查询我的优惠券列表(4.0)

<p><strong>简要描述:</strong> </p> <ul> <li>查询我的优惠券列表(1.5)</li> </ul> <p><strong>作者:</strong> </p> <ul> <li>梁志杰</li> </ul> <p><strong>请求URL:</strong> </p> <ul> <li><code>xtwl_read_interface/cmd</code></li> </ul> <p><strong>请求方式:</strong></p> <ul> <li>POST </li> </ul> <p><strong>参数:</strong> </p> <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;">type</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>1可使用的 2历史优惠券</td> </tr> <tr> <td style="text-align: left;">page</td> <td style="text-align: left;">是</td> <td style="text-align: left;">Integer</td> <td>分页</td> </tr> </tbody> </table> <p><strong>请求示例</strong></p> <pre><code>{ &amp;quot;modular&amp;quot;: &amp;quot;rCoupon&amp;quot;, &amp;quot;param&amp;quot;: { &amp;quot;authKey&amp;quot;: &amp;quot;5C42473DD62B46A7E053C208A8C08B5B&amp;quot;, &amp;quot;dtype&amp;quot;: &amp;quot;2&amp;quot;, &amp;quot;secretKey&amp;quot;: &amp;quot;70F92A9749575CF01C11B6BBD66308BE&amp;quot;, &amp;quot;timeStamp&amp;quot;: &amp;quot;1516780235381&amp;quot;, &amp;quot;userKey&amp;quot;: &amp;quot;6262A9F8F63976A4E0538C06030A6B0C&amp;quot;, &amp;quot;uuid&amp;quot;: &amp;quot;4cdb83916aca4dc5a0b672c00ede891a&amp;quot;, &amp;quot;type&amp;quot;:&amp;quot;1&amp;quot;, &amp;quot;page&amp;quot;:10 }, &amp;quot;requestname&amp;quot;: &amp;quot;queryMyCouponList&amp;quot;, &amp;quot;version&amp;quot;: &amp;quot;1.0&amp;quot; } </code></pre> <p><strong>返回参数说明</strong> </p> <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;">custId</td> <td style="text-align: left;">string</td> <td>custId</td> </tr> <tr> <td style="text-align: left;">couponActRelId</td> <td style="text-align: left;">string</td> <td>优惠券活动关联id</td> </tr> <tr> <td style="text-align: left;">giveoutId</td> <td style="text-align: left;">string</td> <td>发放方式id</td> </tr> <tr> <td style="text-align: left;">couponId</td> <td style="text-align: left;">string</td> <td>优惠券id</td> </tr> <tr> <td style="text-align: left;">name</td> <td style="text-align: left;">string</td> <td>优惠券名称</td> </tr> <tr> <td style="text-align: left;">code</td> <td style="text-align: left;">string</td> <td>优惠券编号</td> </tr> <tr> <td style="text-align: left;">businessType</td> <td style="text-align: left;">string</td> <td>业务类型:1外卖、2团购、3跑腿、4跑腿(取送件)、5跑腿(代购) 6拼团 7砍价、8线下</td> </tr> <tr> <td style="text-align: left;">businessTypeLevel</td> <td style="text-align: left;">string</td> <td>业务类型类别级别(一级、二级):0全部、1一级、2二级</td> </tr> <tr> <td style="text-align: left;">thresholdAmount</td> <td style="text-align: left;">string</td> <td>优惠券门槛金额</td> </tr> <tr> <td style="text-align: left;">amount</td> <td style="text-align: left;">string</td> <td>优惠券金额(指定金额-面值;随机金额组-优惠券总金额)</td> </tr> <tr> <td style="text-align: left;">beginTime</td> <td style="text-align: left;">string</td> <td>优惠券开始时间(精确到时分秒)</td> </tr> <tr> <td style="text-align: left;">endTime</td> <td style="text-align: left;">string</td> <td>优惠券结束时间(精确到时分秒)</td> </tr> <tr> <td style="text-align: left;">beginTime2</td> <td style="text-align: left;">string</td> <td>优惠券开始时间(精确到年月日)</td> </tr> <tr> <td style="text-align: left;">endTime2</td> <td style="text-align: left;">string</td> <td>优惠券结束时间(精确到年月日)</td> </tr> <tr> <td style="text-align: left;">effectiveDays</td> <td style="text-align: left;">string</td> <td>有效天数</td> </tr> <tr> <td style="text-align: left;">threshold</td> <td style="text-align: left;">string</td> <td>优惠券使用门槛:0不限制、1限制</td> </tr> <tr> <td style="text-align: left;">preferentialForm</td> <td style="text-align: left;">string</td> <td>优惠形式:1指定金额、2随机金额组</td> </tr> <tr> <td style="text-align: left;">userLimit</td> <td style="text-align: left;">string</td> <td>用户限制:0不限制、1新用户、2绑定手机 3新用户+绑定手机都限制</td> </tr> <tr> <td style="text-align: left;">validityType</td> <td style="text-align: left;">string</td> <td>有效期形式:1固定日期、2当日开始N天内有效、3次日开始N天内有效</td> </tr> <tr> <td style="text-align: left;">isReminding</td> <td style="text-align: left;">string</td> <td>是否到期提醒:0否、1是</td> </tr> <tr> <td style="text-align: left;">deliveryType</td> <td style="text-align: left;">string</td> <td>配送方式:0不限制、1限平台配送、2限商家配送</td> </tr> <tr> <td style="text-align: left;">shopTypeIds</td> <td style="text-align: left;">string</td> <td>分类id(最多可选择6个同级分类 &quot;,&quot;隔开)</td> </tr> <tr> <td style="text-align: left;">shopTypeNames</td> <td style="text-align: left;">string</td> <td>分类名称(最多可选择6个同级分类 &quot;,&quot;隔开)</td> </tr> <tr> <td style="text-align: left;">isDiscount</td> <td style="text-align: left;">string</td> <td>是否与折扣互斥</td> </tr> <tr> <td style="text-align: left;">isSubtraction</td> <td style="text-align: left;">string</td> <td>是否与满减互斥</td> </tr> <tr> <td style="text-align: left;">isExemption</td> <td style="text-align: left;">string</td> <td>是否与满免运费互斥</td> </tr> <tr> <td style="text-align: left;">isGifts</td> <td style="text-align: left;">string</td> <td>是否与满赠互斥</td> </tr> <tr> <td style="text-align: left;">isNewuser</td> <td style="text-align: left;">string</td> <td>是否与新用户立减互斥</td> </tr> <tr> <td style="text-align: left;">userPhone</td> <td style="text-align: left;">string</td> <td>用户手机(返回为空就是没绑定)</td> </tr> <tr> <td style="text-align: left;">maturityDay</td> <td style="text-align: left;">string</td> <td>到期天数(type为1时返回)</td> </tr> <tr> <td style="text-align: left;">isOnlyToday</td> <td style="text-align: left;">string</td> <td>是否仅限今日 0否 1是(type为1时返回)</td> </tr> <tr> <td style="text-align: left;">maturityDescr</td> <td style="text-align: left;">string</td> <td>到期文案(限今日、今日到期、明日到期、N日后到期)(type为1时返回)</td> </tr> <tr> <td style="text-align: left;">isUsed</td> <td style="text-align: left;">string</td> <td>1已使用 2已到期 3已失效(type为2时返回) (2.5)</td> </tr> <tr> <td style="text-align: left;">couponDescr</td> <td style="text-align: left;">string</td> <td>优惠券说明</td> </tr> <tr> <td style="text-align: left;">couponType</td> <td style="text-align: left;">string</td> <td>1平台优惠券 2商家代金券(2.5)</td> </tr> <tr> <td style="text-align: left;">isMutex</td> <td style="text-align: left;">string</td> <td>0同享券 1互斥券(当couponType=2时才显示该标签 2.5)</td> </tr> <tr> <td style="text-align: left;">shopId</td> <td style="text-align: left;">string</td> <td>shopId(couponType=2时才有 4.0)</td> </tr> <tr> <td style="text-align: left;">couponCode</td> <td style="text-align: left;">string</td> <td>线下支付券码,用于生成二维码</td> </tr> </tbody> </table> <p><strong>返回示例</strong></p> <pre><code>{ &amp;quot;result&amp;quot;: { &amp;quot;info&amp;quot;: {&amp;quot;userPhone&amp;quot;: &amp;quot;13965455454&amp;quot;}, &amp;quot;count&amp;quot;: 1, &amp;quot;list&amp;quot;: [ { &amp;quot;giveoutId&amp;quot;: &amp;quot;7270927C73B2E6E8ET53191EA8C0CA95&amp;quot;, &amp;quot;couponActRelId&amp;quot;: &amp;quot;5D96ED676D31420F81F1CE123D5F9DCB&amp;quot;, &amp;quot;couponId&amp;quot;: &amp;quot;7270997C73B2E6E8ET53191EA8C0CA95&amp;quot;, &amp;quot;custId&amp;quot;: &amp;quot;705174A501424C9BBA566275E944DCA4&amp;quot;, &amp;quot;name&amp;quot;: &amp;quot;13961665706&amp;quot;, &amp;quot;threshold&amp;quot;: &amp;quot;0&amp;quot;, &amp;quot;preferentialForm&amp;quot;: &amp;quot;1&amp;quot;, &amp;quot;userLimit&amp;quot;: &amp;quot;1&amp;quot;, &amp;quot;validityType&amp;quot;: &amp;quot;1&amp;quot;, &amp;quot;code&amp;quot;: &amp;quot;1180731001&amp;quot;, &amp;quot;thresholdAmount&amp;quot;: &amp;quot;0&amp;quot;, &amp;quot;amount&amp;quot;: &amp;quot;20&amp;quot;, &amp;quot;beginTime&amp;quot;: &amp;quot;2018-07-02 16:26:48&amp;quot;, &amp;quot;endTime&amp;quot;: &amp;quot;2018-11-02 16:26:48&amp;quot;, &amp;quot;beginTime2&amp;quot;: &amp;quot;2018-07-02&amp;quot;, &amp;quot;endTime2&amp;quot;: &amp;quot;2018-11-02&amp;quot;, &amp;quot;autoType&amp;quot;: &amp;quot;1&amp;quot;, &amp;quot;giveType&amp;quot;: &amp;quot;5&amp;quot;, &amp;quot;shopTypeIds&amp;quot;: &amp;quot;8873A325C1C8458092D66DC9C5BF1067,A957FF3A07BA46C4819F182DA8AA0C41&amp;quot;, &amp;quot;shopTypeNames&amp;quot;: &amp;quot;面包,甜点饮品&amp;quot;, &amp;quot;isDiscount&amp;quot;:&amp;quot;1&amp;quot;, &amp;quot;isSubtraction&amp;quot;:&amp;quot;1&amp;quot;, &amp;quot;isExemption&amp;quot;:&amp;quot;1&amp;quot;, &amp;quot;isGifts&amp;quot;:&amp;quot;0&amp;quot;, &amp;quot;maturityDay&amp;quot;:&amp;quot;3&amp;quot;, &amp;quot;isOnlyToday&amp;quot;:&amp;quot;0&amp;quot;, &amp;quot;maturityDescr&amp;quot;:&amp;quot;3日后到期&amp;quot;, &amp;quot;couponDescr&amp;quot;:&amp;quot;限品类:生鲜果蔬。限生鲜果蔬类商家首单支付使用。 限收货手机号为15264847581。 限外面商家首单支付使用。 最高抵扣限制:该优惠券最高抵扣5元。 有效期:2018-07-02 16:26:48至2018-11-02 16:26:48。 活动互斥:不与折扣同享;不与满额免配送费同享。&amp;quot; }] }, &amp;quot;resultcode&amp;quot;: &amp;quot;0&amp;quot;, &amp;quot;resultdesc&amp;quot;: &amp;quot;success&amp;quot; }</code></pre> <p><strong>备注</strong> </p> <ul> <li>更多返回错误代码请看首页的错误代码描述</li> </ul>

页面列表

ITEM_HTML