视权益API文档

视权益API文档


价格和库存变动通知

<h2>卡券库存价格回调通知</h2> <h5>简要描述</h5> <ul> <li>卡券实时价格和库存变动</li> </ul> <h5>请求URL</h5> <ul> <li><code>合作商订阅时传入的notify_url</code></li> </ul> <h5>请求方式</h5> <ul> <li>POST </li> </ul> <h5>请求类型</h5> <ul> <li>application/x-www-form-urlencoded</li> </ul> <h4>请求参数</h4> <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;">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;">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;">type</td> <td style="text-align: left;">是</td> <td style="text-align: left;">number</td> <td>1 卡券</td> </tr> <tr> <td style="text-align: left;">num</td> <td style="text-align: left;">是</td> <td style="text-align: left;">number</td> <td>当前商品总库存</td> </tr> <tr> <td style="text-align: left;">current_price</td> <td style="text-align: left;">是</td> <td style="text-align: left;">float</td> <td>卡券当前商品最低价格 (单位/元)</td> </tr> <tr> <td style="text-align: left;">current_price_num</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>当前最低价格库存数量</td> </tr> <tr> <td style="text-align: left;">priceList</td> <td style="text-align: left;">是</td> <td style="text-align: left;">array</td> <td>库存信息</td> </tr> <tr> <td style="text-align: left;">timestamp</td> <td style="text-align: left;">是</td> <td style="text-align: left;">number</td> <td>当前通知时间戳</td> </tr> <tr> <td style="text-align: left;">guid</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>合作商的平台方自定义唯一参数 , 根据合作商订阅时传的采纳数,通知时此字段原样返回</td> </tr> <tr> <td style="text-align: left;">sign</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>参考[加密说明](<a href="https://www.showdoc.com.cn/dcsqy/8643334920632106">https://www.showdoc.com.cn/dcsqy/8643334920632106</a> &quot;加密说明&quot;)</td> </tr> </tbody> </table> <h4>priceList参数说明</h4> <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;">num</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> <p>1、因视权益平台卡券模块存在多价格多库存,故卡券模块价格变动通知返回当前最低价格和最低库存以及该商品的总库存数量,合作商可根据返回字段调整业务逻辑 2、由于多价格多库存形式,故价格变动和库存变动时,我们全部把库存信息和价格信息都返回,返回内容一样。原因是:价格的变动肯定导致库存的变动,库存的变动时,价格不一定变动。 3、如果有不详细的,请咨询我们技术开发。</p> <h1>代充价格变动回调说明</h1> <h5>简要描述</h5> <ul> <li>代充价格变动主动回调通知</li> </ul> <h5>请求URL</h5> <ul> <li><code>合作商订阅时传入的notify_url</code></li> </ul> <h5>请求方式</h5> <ul> <li>POST </li> </ul> <h5>请求类型</h5> <ul> <li>application/x-www-form-urlencoded</li> </ul> <h4>请求参数</h4> <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;">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;">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;">type</td> <td style="text-align: left;">是</td> <td style="text-align: left;">number</td> <td>2 代充</td> </tr> <tr> <td style="text-align: left;">price</td> <td style="text-align: left;">是</td> <td style="text-align: left;">float</td> <td>代充商品当前商品价格 (单位/元)</td> </tr> <tr> <td style="text-align: left;">demand_num</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>当前代充商品价格的库存数量(仅参考,下单可不做限制)</td> </tr> <tr> <td style="text-align: left;">timestamp</td> <td style="text-align: left;">是</td> <td style="text-align: left;">number</td> <td>当前通知时间戳</td> </tr> <tr> <td style="text-align: left;">guid</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>合作商的平台方自定义唯一参数 , 根据合作商订阅时传的采纳数,通知时此字段原样返回</td> </tr> <tr> <td style="text-align: left;">sign</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>参考[加密说明](<a href="https://www.showdoc.com.cn/dcsqy/8643334920632106">https://www.showdoc.com.cn/dcsqy/8643334920632106</a> &quot;加密说明&quot;)</td> </tr> </tbody> </table> <h3>统一请求返回示例--可参考</h3> <p>建议处理完后返回一些信息,方便回调查看信息</p> <p>使用过程中如有任何问题,可联系平台在线客服转技术服务即可</p> <pre><code class="language-json">{ code: 1, msg: &amp;#039;处理成功&amp;#039;, data: &amp;#039;&amp;#039; }</code></pre>

页面列表

ITEM_HTML