商战网络前台API开发文档

商战网络


商品信息订阅

<p>[TOC]</p> <h5>接口说明</h5> <ul> <li>将商品的价格变动、销售状态信息,通过POST的方式实时同步到客户服务器。收到通知后,请返回字符串success或ok,否则继续通知,直至通知机制完成。</li> <li>通知机制:最多通知3次,第一次立即执行,第二次在首次发送后间隔3分钟,第三次在第二次发送后间隔5分钟。</li> <li>请求格式(Content-Type)为application/json</li> <li>订阅签名生成规则:md5(密钥+时间戳),得带的加密32位字符串转大写 <h5>接口地址</h5></li> </ul> <p>由客户提供,提供方法:登陆平台pc端,进入[个人中心] / [订阅通知] / [商品订阅通知],填写能够正常接收通知的接口地址并保存即可</p> <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;">event_type</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>事件触发类型,详见下方说明</td> </tr> <tr> <td style="text-align: left;">event_data</td> <td style="text-align: left;">是</td> <td style="text-align: left;">json</td> <td>事件类型对应的数据,详见下方说明</td> </tr> <tr> <td style="text-align: left;">product_id</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>商品编号</td> </tr> <tr> <td style="text-align: left;">product_name</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>商品名称</td> </tr> <tr> <td style="text-align: left;">product_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;">timestamp</td> <td style="text-align: left;">是</td> <td style="text-align: left;">int</td> <td>秒级10位时间戳</td> </tr> <tr> <td style="text-align: left;">sign</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>签名(生成规则:密钥+时间戳md5加密后转大写得到签名字符串)</td> </tr> </tbody> </table> <p>&gt;<strong>event_type说明:</strong> </p> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th>描述</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">supply_changed</td> <td>商品状态改变</td> </tr> <tr> <td style="text-align: left;">price_changed</td> <td>商品售价改变</td> </tr> <tr> <td style="text-align: left;">supply_price_changed</td> <td>商品售价,状态改变</td> </tr> </tbody> </table> <p>&gt;<strong>event_data说明:</strong> </p> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th>描述</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">supply_state</td> <td>状态(1:上架,2:暂售,3:下架)</td> </tr> <tr> <td style="text-align: left;">price</td> <td>当前售价</td> </tr> </tbody> </table> <p><strong>返回示例:</strong></p> <pre><code>{     &amp;quot;product_id&amp;quot;: 1234,     &amp;quot;product_name&amp;quot;: &amp;quot;卡密测试&amp;quot;,     &amp;quot;product_type&amp;quot;: 1,     &amp;quot;event_type&amp;quot;: &amp;quot;price_changed&amp;quot;,     &amp;quot;event_data&amp;quot;: &amp;quot;{&amp;quot;supply_state&amp;quot;:3,&amp;quot;price&amp;quot;:&amp;quot;5.80&amp;quot;}&amp;quot;, &amp;quot;timestamp&amp;quot;: 1722825667, &amp;quot;sign&amp;quot;: &amp;quot;785DABFF1CF91E7DC3EFDEE027662F92&amp;quot;, }</code></pre>

页面列表

ITEM_HTML