悬浮挂件
<p><strong>简要描述:</strong> </p>
<ul>
<li>悬浮挂件</li>
</ul>
<p><strong>请求URL:</strong> </p>
<ul>
<li><code>/api/goods/suspend</code></li>
</ul>
<p><strong>请求方式:</strong></p>
<ul>
<li>
<p>GET </p>
<p><strong>返回示例</strong></p>
</li>
</ul>
<pre><code>{
"code": 0,
"msg": "返回成功",
"data": {
"id": 51,
"title": "test",
"cover": "http://img.daff9.cn/biyingniao/images/other/1912/5dedb50db8083.png",
"aspect_ratio": "1:1.2",
"bg_color": null,
"need_login": 0,
"target_type": 1,
"target": {
"url": "http://www.baidu.com?pid=mm_54243242_42592331_54342450098",
"url_type": 0,
"title": "百度一下",
"scheme_able": false,
"open_share": false
}
}
}</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;">cover</td>
<td style="text-align: left;">string</td>
<td>图片地址</td>
</tr>
<tr>
<td style="text-align: left;">need_login</td>
<td style="text-align: left;">int</td>
<td>用户是否必须登录才能跳转 0-不用登录 1-必须登录</td>
</tr>
</tbody>
</table>
<ul>
<li>
<p>target 数据格式</p>
</li>
<li>1.target_type = 1</li>
</ul>
<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;">url</td>
<td style="text-align: left;">string</td>
<td>web链接</td>
</tr>
<tr>
<td style="text-align: left;">url_type</td>
<td style="text-align: left;">int</td>
<td>web链接来源:0-其他,1-淘宝,2-拼多多,3-京东</td>
</tr>
<tr>
<td style="text-align: left;">title</td>
<td style="text-align: left;">string</td>
<td>web标题</td>
</tr>
<tr>
<td style="text-align: left;">scheme_able</td>
<td style="text-align: left;">bool</td>
<td>是否开启APP唤醒</td>
</tr>
<tr>
<td style="text-align: left;">open_share</td>
<td style="text-align: left;">bool</td>
<td>是否可分享</td>
</tr>
<tr>
<td style="text-align: left;">need_oauth</td>
<td style="text-align: left;">boolean</td>
<td>是否需要淘宝授权, true-去授权</td>
</tr>
<tr>
<td style="text-align: left;">oauth_url</td>
<td style="text-align: left;">string</td>
<td>淘宝授权链接</td>
</tr>
<tr>
<td style="text-align: left;">share_data</td>
<td style="text-align: left;">object</td>
<td>分享信息,可分享的时候才返回该字段</td>
</tr>
</tbody>
</table>
<ul>
<li>2.target_type = 2</li>
</ul>
<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;">type</td>
<td style="text-align: left;">int</td>
<td>商品类型: 1-淘宝;2-拼多多;3-京东</td>
</tr>
<tr>
<td style="text-align: left;">item_id</td>
<td style="text-align: left;">string</td>
<td>商品ID</td>
</tr>
<tr>
<td style="text-align: left;">activity_id</td>
<td style="text-align: left;">string</td>
<td>优惠券ID</td>
</tr>
<tr>
<td style="text-align: left;">need_oauth</td>
<td style="text-align: left;">boolean</td>
<td>是否需要淘宝授权, true-去授权</td>
</tr>
<tr>
<td style="text-align: left;">oauth_url</td>
<td style="text-align: left;">string</td>
<td>淘宝授权链接</td>
</tr>
</tbody>
</table>
<ul>
<li>
<p>3.target_type = 3,4,5,6
客户端技术人员需要根据返回的值调【商品列表】接口:
3--淘宝特色列表 聚划算
4--淘宝特色列表 9块9包邮
5--拼多多任意一个特色列表,根据自己需求
6--京东任意一个特色列表,根据自己需求,建议使用channel_type=1</p>
</li>
<li>4.target_type = 7</li>
</ul>
<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;">id</td>
<td style="text-align: left;">int</td>
<td>专辑ID</td>
</tr>
</tbody>
</table>
<ul>
<li>5.target_type = 10</li>
</ul>
<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;">id</td>
<td style="text-align: left;">int</td>
<td>淘宝物料ID</td>
</tr>
<tr>
<td style="text-align: left;">need_oauth</td>
<td style="text-align: left;">boolean</td>
<td>是否需要淘宝授权, true-去授权</td>
</tr>
<tr>
<td style="text-align: left;">oauth_url</td>
<td style="text-align: left;">string</td>
<td>淘宝授权链接</td>
</tr>
</tbody>
</table>
<p>客户端技术人员需要调【商品列表】接口,mall_id传1和2都行,数据是一样的,activity_type=5,material_id=id</p>
<ul>
<li>
<p>6.target_type = 11,12
服务端经过转链,给客户端的是个H5链接,需要唤醒拼多多/京东app</p>
</li>
<li>7.target_type = 13</li>
</ul>
<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;">path</td>
<td style="text-align: left;">string</td>
<td>跳转路径</td>
</tr>
</tbody>
</table>
<p>客户端根据自己定的规则跳转</p>