shopApi

商城API项目


商品列表路由

<h5>接口描述</h5> <ul> <li>商品列表模板</li> </ul> <h5>请求URL</h5> <ul> <li><code>/api/goods</code></li> </ul> <h5>请求方式</h5> <ul> <li>GET</li> </ul> <h5>Query 请求参数</h5> <p>|参数名|必选|类型|说明| |:----    |:---|:----- |-----   | |title |是  |string |标题   | |category_id |是  |string |分类   | |sales |是  |string |销量 默认1  | |price |是  |string |价格  1 | |comments_count |是  |string |评论数  1 |</p> <h5>返回示例</h5> <ul> <li>状态码 200 请求成功</li> </ul> <pre><code>{     &amp;quot;goods&amp;quot;: {         &amp;quot;current_page&amp;quot;: 1,         &amp;quot;data&amp;quot;: [             {                 &amp;quot;id&amp;quot;: 1,                 &amp;quot;title&amp;quot;: &amp;quot;Minus rerum eaque.&amp;quot;,                 &amp;quot;price&amp;quot;: 1180,                 &amp;quot;cover&amp;quot;: &amp;quot;https://picsum.photos/640/480&amp;quot;,                 &amp;quot;category_id&amp;quot;: 14,                 &amp;quot;sales&amp;quot;: 0,                 &amp;quot;updated_at&amp;quot;: &amp;quot;2024-04-03T12:56:35.000000Z&amp;quot;,                 &amp;quot;comments_count&amp;quot;: 0,                 &amp;quot;cover_url&amp;quot;: &amp;quot;https://picsum.photos/640/480&amp;quot;             }         ],         &amp;quot;first_page_url&amp;quot;: &amp;quot;http://api.test/api/goods?title=Minus&amp;amp;category_id=14&amp;amp;sales=1&amp;amp;price=1&amp;amp;comments_count=1&amp;amp;page=1&amp;quot;,         &amp;quot;from&amp;quot;: 1,         &amp;quot;next_page_url&amp;quot;: null,         &amp;quot;path&amp;quot;: &amp;quot;http://api.test/api/goods&amp;quot;,         &amp;quot;per_page&amp;quot;: 20,         &amp;quot;prev_page_url&amp;quot;: null,         &amp;quot;to&amp;quot;: 1     },     &amp;quot;recommend_goods&amp;quot;: [         {             &amp;quot;id&amp;quot;: 50,             &amp;quot;title&amp;quot;: &amp;quot;Tenetur sunt vero.&amp;quot;,             &amp;quot;price&amp;quot;: 80698,             &amp;quot;cover&amp;quot;: &amp;quot;https://picsum.photos/640/480&amp;quot;,             &amp;quot;comments_count&amp;quot;: 0,             &amp;quot;cover_url&amp;quot;: &amp;quot;https://picsum.photos/640/480&amp;quot;         },         {             &amp;quot;id&amp;quot;: 90,             &amp;quot;title&amp;quot;: &amp;quot;Et odit debitis.&amp;quot;,             &amp;quot;price&amp;quot;: 57820,             &amp;quot;cover&amp;quot;: &amp;quot;https://picsum.photos/640/480&amp;quot;,             &amp;quot;comments_count&amp;quot;: 0,             &amp;quot;cover_url&amp;quot;: &amp;quot;https://picsum.photos/640/480&amp;quot;         },         {             &amp;quot;id&amp;quot;: 89,             &amp;quot;title&amp;quot;: &amp;quot;Autem molestiae.&amp;quot;,             &amp;quot;price&amp;quot;: 53862,             &amp;quot;cover&amp;quot;: &amp;quot;https://picsum.photos/640/480&amp;quot;,             &amp;quot;comments_count&amp;quot;: 0,             &amp;quot;cover_url&amp;quot;: &amp;quot;https://picsum.photos/640/480&amp;quot;         },         {             &amp;quot;id&amp;quot;: 34,             &amp;quot;title&amp;quot;: &amp;quot;Laborum harum nam.&amp;quot;,             &amp;quot;price&amp;quot;: 60591,             &amp;quot;cover&amp;quot;: &amp;quot;https://picsum.photos/640/480&amp;quot;,             &amp;quot;comments_count&amp;quot;: 0,             &amp;quot;cover_url&amp;quot;: &amp;quot;https://picsum.photos/640/480&amp;quot;         },         {             &amp;quot;id&amp;quot;: 93,             &amp;quot;title&amp;quot;: &amp;quot;Laborum asperiores.&amp;quot;,             &amp;quot;price&amp;quot;: 56706,             &amp;quot;cover&amp;quot;: &amp;quot;https://picsum.photos/640/480&amp;quot;,             &amp;quot;comments_count&amp;quot;: 0,             &amp;quot;cover_url&amp;quot;: &amp;quot;https://picsum.photos/640/480&amp;quot;         },         {             &amp;quot;id&amp;quot;: 99,             &amp;quot;title&amp;quot;: &amp;quot;Molestiae nobis.&amp;quot;,             &amp;quot;price&amp;quot;: 67009,             &amp;quot;cover&amp;quot;: &amp;quot;https://picsum.photos/640/480&amp;quot;,             &amp;quot;comments_count&amp;quot;: 0,             &amp;quot;cover_url&amp;quot;: &amp;quot;https://picsum.photos/640/480&amp;quot;         },         {             &amp;quot;id&amp;quot;: 5,             &amp;quot;title&amp;quot;: &amp;quot;Pariatur provident.&amp;quot;,             &amp;quot;price&amp;quot;: 20117,             &amp;quot;cover&amp;quot;: &amp;quot;https://picsum.photos/640/480&amp;quot;,             &amp;quot;comments_count&amp;quot;: 0,             &amp;quot;cover_url&amp;quot;: &amp;quot;https://picsum.photos/640/480&amp;quot;         },         {             &amp;quot;id&amp;quot;: 68,             &amp;quot;title&amp;quot;: &amp;quot;Perferendis.&amp;quot;,             &amp;quot;price&amp;quot;: 64086,             &amp;quot;cover&amp;quot;: &amp;quot;https://picsum.photos/640/480&amp;quot;,             &amp;quot;comments_count&amp;quot;: 0,             &amp;quot;cover_url&amp;quot;: &amp;quot;https://picsum.photos/640/480&amp;quot;         },         {             &amp;quot;id&amp;quot;: 63,             &amp;quot;title&amp;quot;: &amp;quot;Quas praesentium.&amp;quot;,             &amp;quot;price&amp;quot;: 83222,             &amp;quot;cover&amp;quot;: &amp;quot;https://picsum.photos/640/480&amp;quot;,             &amp;quot;comments_count&amp;quot;: 0,             &amp;quot;cover_url&amp;quot;: &amp;quot;https://picsum.photos/640/480&amp;quot;         },         {             &amp;quot;id&amp;quot;: 32,             &amp;quot;title&amp;quot;: &amp;quot;Aut corrupti autem.&amp;quot;,             &amp;quot;price&amp;quot;: 90268,             &amp;quot;cover&amp;quot;: &amp;quot;https://picsum.photos/640/480&amp;quot;,             &amp;quot;comments_count&amp;quot;: 0,             &amp;quot;cover_url&amp;quot;: &amp;quot;https://picsum.photos/640/480&amp;quot;         }     ],     &amp;quot;categories&amp;quot;: [         {             &amp;quot;id&amp;quot;: 1,             &amp;quot;pid&amp;quot;: 0,             &amp;quot;level&amp;quot;: 1,             &amp;quot;name&amp;quot;: &amp;quot;电子数码&amp;quot;,             &amp;quot;status&amp;quot;: 1,             &amp;quot;children&amp;quot;: [                 {                     &amp;quot;id&amp;quot;: 2,                     &amp;quot;pid&amp;quot;: 1,                     &amp;quot;name&amp;quot;: &amp;quot;手机&amp;quot;,                     &amp;quot;level&amp;quot;: 2,                     &amp;quot;status&amp;quot;: 1,                     &amp;quot;children&amp;quot;: [                         {                             &amp;quot;id&amp;quot;: 3,                             &amp;quot;pid&amp;quot;: 2,                             &amp;quot;name&amp;quot;: &amp;quot;华为&amp;quot;,                             &amp;quot;level&amp;quot;: 3,                             &amp;quot;status&amp;quot;: 1                         },                         {                             &amp;quot;id&amp;quot;: 4,                             &amp;quot;pid&amp;quot;: 2,                             &amp;quot;name&amp;quot;: &amp;quot;小米&amp;quot;,                             &amp;quot;level&amp;quot;: 3,                             &amp;quot;status&amp;quot;: 1                         }                     ]                 },                 {                     &amp;quot;id&amp;quot;: 5,                     &amp;quot;pid&amp;quot;: 1,                     &amp;quot;name&amp;quot;: &amp;quot;电脑&amp;quot;,                     &amp;quot;level&amp;quot;: 2,                     &amp;quot;status&amp;quot;: 1,                     &amp;quot;children&amp;quot;: [                         {                             &amp;quot;id&amp;quot;: 6,                             &amp;quot;pid&amp;quot;: 5,                             &amp;quot;name&amp;quot;: &amp;quot;联想&amp;quot;,                             &amp;quot;level&amp;quot;: 3,                             &amp;quot;status&amp;quot;: 1                         },                         {                             &amp;quot;id&amp;quot;: 7,                             &amp;quot;pid&amp;quot;: 5,                             &amp;quot;name&amp;quot;: &amp;quot;戴尔&amp;quot;,                             &amp;quot;level&amp;quot;: 3,                             &amp;quot;status&amp;quot;: 1                         }                     ]                 }             ]         },         {             &amp;quot;id&amp;quot;: 8,             &amp;quot;pid&amp;quot;: 0,             &amp;quot;level&amp;quot;: 1,             &amp;quot;name&amp;quot;: &amp;quot;服装衣帽&amp;quot;,             &amp;quot;status&amp;quot;: 1,             &amp;quot;children&amp;quot;: [                 {                     &amp;quot;id&amp;quot;: 9,                     &amp;quot;pid&amp;quot;: 8,                     &amp;quot;name&amp;quot;: &amp;quot;男装&amp;quot;,                     &amp;quot;level&amp;quot;: 2,                     &amp;quot;status&amp;quot;: 1,                     &amp;quot;children&amp;quot;: [                         {                             &amp;quot;id&amp;quot;: 10,                             &amp;quot;pid&amp;quot;: 9,                             &amp;quot;name&amp;quot;: &amp;quot;海澜之家&amp;quot;,                             &amp;quot;level&amp;quot;: 3,                             &amp;quot;status&amp;quot;: 1                         },                         {                             &amp;quot;id&amp;quot;: 11,                             &amp;quot;pid&amp;quot;: 9,                             &amp;quot;name&amp;quot;: &amp;quot;Nike&amp;quot;,                             &amp;quot;level&amp;quot;: 3,                             &amp;quot;status&amp;quot;: 1                         }                     ]                 },                 {                     &amp;quot;id&amp;quot;: 12,                     &amp;quot;pid&amp;quot;: 8,                     &amp;quot;name&amp;quot;: &amp;quot;女装&amp;quot;,                     &amp;quot;level&amp;quot;: 2,                     &amp;quot;status&amp;quot;: 1,                     &amp;quot;children&amp;quot;: [                         {                             &amp;quot;id&amp;quot;: 13,                             &amp;quot;pid&amp;quot;: 12,                             &amp;quot;name&amp;quot;: &amp;quot;欧时力&amp;quot;,                             &amp;quot;level&amp;quot;: 3,                             &amp;quot;status&amp;quot;: 1                         },                         {                             &amp;quot;id&amp;quot;: 14,                             &amp;quot;pid&amp;quot;: 12,                             &amp;quot;name&amp;quot;: &amp;quot;Only&amp;quot;,                             &amp;quot;level&amp;quot;: 3,                             &amp;quot;status&amp;quot;: 1                         }                     ]                 }             ]         }     ] }</code></pre> <ul> <li> <p>状态码 200 成功</p> </li> <li>状态码 422 参数错误</li> </ul>

页面列表

ITEM_HTML