视权益API文档

视权益API文档


查询单个卡密信息

<p>[TOC]</p> <h5>简要描述</h5> <ul> <li>根据产品ID查询单个卡密信息</li> <li>由于视权益卡券商品,存在用户自定价格销售,故平台销售会有多价格存在,此功能查询只展示当前卡密的最低价,并有总库存数据和当前最低价库存数-即查询的数据是实时平台正在销售的最低价<code>2023-07-14新增</code></li> </ul> <h5>请求URL</h5> <ul> <li><code>网关地址 + /dcapi/card/queryCardDetail</code></li> </ul> <h5>请求方式</h5> <ul> <li>POST </li> </ul> <h5>请求类型</h5> <ul> <li>application/x-www-form-urlencoded</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;">appid</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>合作商appid</td> </tr> <tr> <td style="text-align: left;">card_id</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>卡券产品ID</td> </tr> <tr> <td style="text-align: left;">sign</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>签名(不参与签名)签名方式请参考-签名算法方式说明</td> </tr> </tbody> </table> <h5>返回示例</h5> <pre><code>{     &amp;quot;code&amp;quot;: 1,     &amp;quot;msg&amp;quot;: &amp;quot;查询成功&amp;quot;,     &amp;quot;result&amp;quot;: {         &amp;quot;logo&amp;quot;: &amp;quot;http://img.wumingyingshi.cn/cardimg/20211106/b140961f939f701d526363414bdbc17b.png&amp;quot;,         &amp;quot;name&amp;quot;: &amp;quot;30元充值码&amp;quot;,         &amp;quot;pid&amp;quot;: 314,         &amp;quot;id&amp;quot;: 315,         &amp;quot;type&amp;quot;: 0,         &amp;quot;notice&amp;quot;: &amp;quot;&amp;lt;p style=\&amp;quot;font-family: 'Microsoft YaHei';\&amp;quot;&amp;gt;&amp;lt;span style=\&amp;quot;color: #e03e2d;\&amp;quot;&amp;gt;兑换流程:&amp;lt;/span&amp;gt;&amp;lt;/p&amp;gt;\n&amp;lt;p style=\&amp;quot;font-family: 'Microsoft YaHei';\&amp;quot;&amp;gt;&amp;lt;span style=\&amp;quot;color: #95a5a6;\&amp;quot;&amp;gt;通过[奈雪点单]小程序,进入&amp;amp;ldquo;我的\&amp;quot;,点击\&amp;quot;奈雪券\&amp;quot;,输入兑换码后即可兑换奈雪会员券。&amp;lt;/span&amp;gt;&amp;lt;/p&amp;gt;\n&amp;lt;p style=\&amp;quot;font-family: 'Microsoft YaHei';\&amp;quot;&amp;gt;&amp;lt;span style=\&amp;quot;color: #e03e2d;\&amp;quot;&amp;gt;使用规则:&amp;lt;/span&amp;gt;&amp;lt;/p&amp;gt;\n&amp;lt;p style=\&amp;quot;font-family: 'Microsoft YaHei';\&amp;quot;&amp;gt;&amp;lt;span style=\&amp;quot;color: #95a5a6;\&amp;quot;&amp;gt;1.该张代金券可在小程序下单时使用,也可在线下门店(.上海浦东机场店、奈雪梦工厂除外)出示会员二维码,告知店员账上有代金券。&amp;lt;/span&amp;gt;&amp;lt;/p&amp;gt;\n&amp;lt;p style=\&amp;quot;font-family: 'Microsoft YaHei';\&amp;quot;&amp;gt;&amp;lt;span style=\&amp;quot;color: #95a5a6;\&amp;quot;&amp;gt;2.该券需消费满券面金额可使用,且仅可单次使用,抵用积分不提供发票,不可叠加多张使用。&amp;lt;/span&amp;gt;&amp;lt;/p&amp;gt;\n&amp;lt;p style=\&amp;quot;font-family: 'Microsoft YaHei';\&amp;quot;&amp;gt;&amp;lt;span style=\&amp;quot;color: #95a5a6;\&amp;quot;&amp;gt;3.该券仅可兑换门]店在售产品(菜单上标有红色雪花产品除外)、不可兑换现金或找零,使用该券的金额不参与会员积分。&amp;lt;/span&amp;gt;&amp;lt;/p&amp;gt;\n&amp;lt;p style=\&amp;quot;font-family: 'Microsoft YaHei';\&amp;quot;&amp;gt;&amp;lt;span style=\&amp;quot;color: #95a5a6;\&amp;quot;&amp;gt;4.电子凭证请在有效期内兑换,逾期作废。&amp;lt;/span&amp;gt;&amp;lt;/p&amp;gt;\n&amp;lt;p style=\&amp;quot;font-family: 'Microsoft YaHei';\&amp;quot;&amp;gt;&amp;lt;span style=\&amp;quot;color: #95a5a6;\&amp;quot;&amp;gt;5.电子凭证类商品,一经兑换不予办理退积分(货)。&amp;lt;/span&amp;gt;&amp;lt;/p&amp;gt;&amp;quot;,         &amp;quot;card_name&amp;quot;: &amp;quot; 奈雪の茶&amp;quot;,         &amp;quot;num&amp;quot;: 21,         &amp;quot;current_price_num&amp;quot;: 5,         &amp;quot;priceList&amp;quot;: [             {                 &amp;quot;price&amp;quot;: &amp;quot;21.24&amp;quot;,                 &amp;quot;hours&amp;quot;: 72             },             {                 &amp;quot;price&amp;quot;: &amp;quot;21.24&amp;quot;,                 &amp;quot;hours&amp;quot;: 24             },             {                 &amp;quot;price&amp;quot;: &amp;quot;21.13&amp;quot;,                 &amp;quot;hours&amp;quot;: 12             },             {                 &amp;quot;price&amp;quot;: &amp;quot;21.05&amp;quot;,                 &amp;quot;hours&amp;quot;: 10             },             {                 &amp;quot;price&amp;quot;: &amp;quot;20.99&amp;quot;,                 &amp;quot;hours&amp;quot;: 1             }         ],         &amp;quot;typeName&amp;quot;: &amp;quot;官方激活码&amp;quot;     } }</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;">logo</td> <td style="text-align: left;">string</td> <td>卡密产品logo</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;">id</td> <td style="text-align: left;">string</td> <td>卡密产品ID 下单时使用</td> </tr> <tr> <td style="text-align: left;">type</td> <td style="text-align: left;">number</td> <td>卡密类型 0 官方激活码 1 卡号和密码 2 图片二维码 3 链接+卡密 4 链接直兑</td> </tr> <tr> <td style="text-align: left;">typeName</td> <td style="text-align: left;">string</td> <td>卡密类型名称</td> </tr> <tr> <td style="text-align: left;">notice</td> <td style="text-align: left;">string</td> <td>卡密说明-富文本格式,如需使用,请自行解析</td> </tr> <tr> <td style="text-align: left;">card_name</td> <td style="text-align: left;">string</td> <td>卡密产品名称</td> </tr> <tr> <td style="text-align: left;">num</td> <td style="text-align: left;">number</td> <td>当前卡密总库存数量</td> </tr> <tr> <td style="text-align: left;">current_price_num</td> <td style="text-align: left;">number</td> <td>当前价格的库存数 <code>2023-07-14新增</code></td> </tr> <tr> <td style="text-align: left;">priceList</td> <td style="text-align: left;">array</td> <td>卡密价格明细 -最低价格-不同收货时间对应的价格</td> </tr> </tbody> </table> <h5>auto_confirm_hour 订单保护期参数说明 <code>2023-07-14删除</code></h5> <h5>priceList参数说明</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;">price</td> <td style="text-align: left;">string</td> <td>卡密产品实际价格</td> </tr> <tr> <td style="text-align: left;">hours</td> <td style="text-align: left;">number</td> <td>自动确认收货时间(单位/小时)</td> </tr> </tbody> </table> <h5>备注</h5> <ul> <li>数据为实时数据</li> </ul>

页面列表

ITEM_HTML