蛋糕叔叔API接口文档

蛋糕叔叔API接口文档


商品列表接口

<p><strong>简要描述:</strong></p> <ul> <li>商品列表接口</li> </ul> <p><strong>请求URL:</strong></p> <ul> <li><code>/dsapi/product/get_product_hot_list</code></li> </ul> <p><strong>请求方式:</strong></p> <ul> <li>POST/GET</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 style="text-align: left;">示例值</th> <th style="text-align: left;">说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">city_id</td> <td style="text-align: left;">否</td> <td style="text-align: left;">int</td> <td style="text-align: left;">2</td> <td style="text-align: left;">城市id,比如北京城市id是2,有值的话提取当前城市商品,不传提取所有商品</td> </tr> <tr> <td style="text-align: left;">product_type</td> <td style="text-align: left;">否</td> <td style="text-align: left;">int</td> <td style="text-align: left;">1</td> <td style="text-align: left;">商品类型,1是蛋糕,2是零食,3是鲜花</td> </tr> <tr> <td style="text-align: left;">search_title</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td style="text-align: left;">生日</td> <td style="text-align: left;">商品关键词搜索</td> </tr> <tr> <td style="text-align: left;">sort_price_type</td> <td style="text-align: left;">是</td> <td style="text-align: left;">int</td> <td style="text-align: left;">1</td> <td style="text-align: left;">商品价格排序,1是按价格倒序 ,2是按价格升序</td> </tr> <tr> <td style="text-align: left;">start_time</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td style="text-align: left;">2021-01-01</td> <td style="text-align: left;">开始时间(查询商品最后更新时间,第一次全量查询商品信息时候和end_time都不必传参)</td> </tr> <tr> <td style="text-align: left;">end_time</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td style="text-align: left;">2021-01-02</td> <td style="text-align: left;">结束时间</td> </tr> <tr> <td style="text-align: left;">brand_id</td> <td style="text-align: left;">否</td> <td style="text-align: left;">int</td> <td style="text-align: left;">47</td> <td style="text-align: left;">品牌ID,可根据此条件进行筛选</td> </tr> <tr> <td style="text-align: left;">cat_id2</td> <td style="text-align: left;">否</td> <td style="text-align: left;">int</td> <td style="text-align: left;">47</td> <td style="text-align: left;">二级分类ID,可根据此条件进行筛选</td> </tr> <tr> <td style="text-align: left;">cat_id3</td> <td style="text-align: left;">否</td> <td style="text-align: left;">int</td> <td style="text-align: left;">47</td> <td style="text-align: left;">三级分类ID,可根据此条件进行筛选</td> </tr> <tr> <td style="text-align: left;">page</td> <td style="text-align: left;">是</td> <td style="text-align: left;">int</td> <td style="text-align: left;">1</td> <td style="text-align: left;">页数</td> </tr> <tr> <td style="text-align: left;">size</td> <td style="text-align: left;">是</td> <td style="text-align: left;">int</td> <td style="text-align: left;">10</td> <td style="text-align: left;">每页显示的条数(默认最大值为50)</td> </tr> </tbody> </table> <p>** 备注: <code>start_time 和 end_time为第一次全量查询商品之后 可用作定时更新商品信息接口时的传参 两个参数也可只传start_time</code></p> <p><strong>返回示例</strong></p> <pre><code>{ &amp;quot;code&amp;quot;:200, &amp;quot;msg&amp;quot;:&amp;quot;success&amp;quot;, &amp;quot;data&amp;quot;:{ &amp;quot;product_list&amp;quot;:[ { &amp;quot;id&amp;quot;:&amp;quot;1309258&amp;quot;, &amp;quot;title&amp;quot;:&amp;quot;元祖萌虎鲜奶蛋糕&amp;quot;, &amp;quot;market_price&amp;quot;:&amp;quot;158.00&amp;quot;, &amp;quot;price&amp;quot;:&amp;quot;158.00&amp;quot;, &amp;quot;image_path&amp;quot;:null, &amp;quot;brand_name&amp;quot;:&amp;quot;元祖&amp;quot;, &amp;quot;brand_id&amp;quot;:&amp;quot;3&amp;quot;, &amp;quot;is_yushou&amp;quot;:&amp;quot;0&amp;quot;, &amp;quot;is_greeting&amp;quot;:&amp;quot;0&amp;quot;, &amp;quot;label_name&amp;quot;: null, &amp;quot;cat_id&amp;quot;: &amp;quot;8&amp;quot;, &amp;quot;cat_id2&amp;quot;: &amp;quot;66&amp;quot;, &amp;quot;cat_id3&amp;quot;: &amp;quot;67&amp;quot;, &amp;quot;specs&amp;quot;:[ { &amp;quot;spec_id&amp;quot;: &amp;quot;1154105&amp;quot;, &amp;quot;name&amp;quot;: &amp;quot;12寸&amp;quot;, &amp;quot;price&amp;quot;: &amp;quot;2488.00&amp;quot;, &amp;quot;market_price&amp;quot;: &amp;quot;2488.00&amp;quot;, &amp;quot;clearing_price&amp;quot;: &amp;quot;2488.00&amp;quot;, &amp;quot;promotion_id&amp;quot;: &amp;quot;&amp;quot;, &amp;quot;shop_discount&amp;quot;: &amp;quot;75.00&amp;quot; } ] } ] } }</code></pre> <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 style="text-align: left;">说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">product_list[]</td> <td style="text-align: left;">array</td> <td style="text-align: left;">[]</td> <td style="text-align: left;">banner列表</td> </tr> <tr> <td style="text-align: left;">product_list[id]</td> <td style="text-align: left;">string</td> <td style="text-align: left;">1</td> <td style="text-align: left;">商品id</td> </tr> <tr> <td style="text-align: left;">product_list[title]</td> <td style="text-align: left;">string</td> <td style="text-align: left;">鲜奶蛋糕</td> <td style="text-align: left;">商品名称</td> </tr> <tr> <td style="text-align: left;">product_list[market_price]</td> <td style="text-align: left;">string</td> <td style="text-align: left;">239.00</td> <td style="text-align: left;">市场价</td> </tr> <tr> <td style="text-align: left;">product_list[price]</td> <td style="text-align: left;">string</td> <td style="text-align: left;">219.00</td> <td style="text-align: left;">售价</td> </tr> <tr> <td style="text-align: left;">product_list[image_path]</td> <td style="text-align: left;">string</td> <td style="text-align: left;"><a href="https://img.dangaoss.com/public/p/97/7/1226113_m.jpg">https://img.dangaoss.com/public/p/97/7/1226113_m.jpg</a></td> <td style="text-align: left;">商品图片地址</td> </tr> <tr> <td style="text-align: left;">product_list[brand_name]</td> <td style="text-align: left;">string</td> <td style="text-align: left;">幸福西饼</td> <td style="text-align: left;">品牌名称</td> </tr> <tr> <td style="text-align: left;">product_list[brand_id]</td> <td style="text-align: left;">string</td> <td style="text-align: left;">10203</td> <td style="text-align: left;">品牌id</td> </tr> <tr> <td style="text-align: left;">product_list[is_yushou]</td> <td style="text-align: left;">int</td> <td style="text-align: left;">0</td> <td style="text-align: left;">是否是预售商品,1代表预售商品,默认0</td> </tr> <tr> <td style="text-align: left;">product_list[is_greeting]</td> <td style="text-align: left;">int</td> <td style="text-align: left;">0</td> <td style="text-align: left;">是否支持祝福语配置 0支持 1不支持</td> </tr> <tr> <td style="text-align: left;">product_list[label_name]</td> <td style="text-align: left;">string</td> <td style="text-align: left;">鲜奶蛋糕</td> <td style="text-align: left;">商品标签</td> </tr> <tr> <td style="text-align: left;">product_list[cat_id]</td> <td style="text-align: left;">string</td> <td style="text-align: left;">8</td> <td style="text-align: left;">一级分类</td> </tr> <tr> <td style="text-align: left;">product_list[cat_id2]</td> <td style="text-align: left;">string</td> <td style="text-align: left;">66</td> <td style="text-align: left;">二级分类</td> </tr> <tr> <td style="text-align: left;">product_list[cat_id3]</td> <td style="text-align: left;">string</td> <td style="text-align: left;">67</td> <td style="text-align: left;">三级分类</td> </tr> <tr> <td style="text-align: left;">product_list[specs]</td> <td style="text-align: left;">array</td> <td style="text-align: left;">规格列表</td> </tr> <tr> <td style="text-align: left;">product_list[specs][spec_id]</td> <td style="text-align: left;">int</td> <td style="text-align: left;">1154105</td> <td style="text-align: left;">规格id</td> </tr> <tr> <td style="text-align: left;">product_list[specs][name]</td> <td style="text-align: left;">string</td> <td style="text-align: left;">12寸</td> <td style="text-align: left;">规格名称</td> </tr> <tr> <td style="text-align: left;">product_list[specs][price]</td> <td style="text-align: left;">string</td> <td style="text-align: left;">2488.00</td> <td style="text-align: left;">规格价格</td> </tr> <tr> <td style="text-align: left;">product_list[specs][market_price]</td> <td style="text-align: left;">string</td> <td style="text-align: left;">2488.00</td> <td style="text-align: left;">规格市场价</td> </tr> <tr> <td style="text-align: left;">product_list[specs][clearing_price]</td> <td style="text-align: left;">string</td> <td style="text-align: left;">2488.00</td> <td style="text-align: left;">规格结算价</td> </tr> <tr> <td style="text-align: left;">product_list[specs][promotion_id]</td> <td style="text-align: left;"></td> <td style="text-align: left;"></td> <td style="text-align: left;">此字段暂无使用</td> </tr> <tr> <td style="text-align: left;">product_list[specs][shop_discount]</td> <td style="text-align: left;"></td> <td style="text-align: left;"></td> <td style="text-align: left;">此字段暂无使用</td> </tr> </tbody> </table> <p><strong>备注</strong></p> <ul> <li>更多返回错误代码请看首页的错误代码描述</li> </ul>

页面列表

ITEM_HTML