twt-trade-platform

校园二手交易平台


分页查询商品列表

<p>[TOC]</p> <h2>简要描述</h2> <ul> <li>分页查询商品列表接口,默认每页30条数据</li> </ul> <h2>请求路径</h2> <ul> <li><code>/item/search</code></li> </ul> <h2>请求方式</h2> <ul> <li>GET </li> </ul> <h2>请求头</h2> <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;">Authorization</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>JWT Token</td> </tr> </tbody> </table> <h2>请求参数</h2> <p>请求参数格式:queryString</p> <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;">page</td> <td style="text-align: left;">否</td> <td style="text-align: left;">int</td> <td>当前页码,默认为1</td> </tr> <tr> <td style="text-align: left;">keyword</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>搜索关键词</td> </tr> <tr> <td style="text-align: left;">category</td> <td style="text-align: left;">否</td> <td style="text-align: left;">enum</td> <td>商品种类(教材,代步,电子,日用,二次元,运动,娱乐,服饰,文具,其他)</td> </tr> <tr> <td style="text-align: left;">campus</td> <td style="text-align: left;">否</td> <td style="text-align: left;">enum</td> <td>商品校区(北洋园,卫津路)</td> </tr> <tr> <td style="text-align: left;">min_price</td> <td style="text-align: left;">否</td> <td style="text-align: left;">decimal</td> <td>商品最低价格</td> </tr> <tr> <td style="text-align: left;">max_price</td> <td style="text-align: left;">否</td> <td style="text-align: left;">decimal</td> <td>商品最高价格</td> </tr> <tr> <td style="text-align: left;">sort_by_price</td> <td style="text-align: left;">否</td> <td style="text-align: left;">enum</td> <td>价格排序方式(asc,desc)</td> </tr> </tbody> </table> <h2>请求示例</h2> <pre><code>page=1&amp;amp;keyword=自行车&amp;amp;category=代步&amp;amp;campus=北洋园&amp;amp;min_price=100&amp;amp;max_price=300&amp;amp;sort_by_price=asc</code></pre> <h2>响应参数</h2> <p>响应参数格式:application/json</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;">code</td> <td style="text-align: left;">int</td> <td>状态码</td> </tr> <tr> <td style="text-align: left;">data</td> <td style="text-align: left;">object</td> <td>返回数据</td> </tr> <tr> <td style="text-align: left;">message</td> <td style="text-align: left;">string</td> <td>返回信息</td> </tr> <tr> <td style="text-align: left;">data.total</td> <td style="text-align: left;">long</td> <td>总数据条数</td> </tr> <tr> <td style="text-align: left;">data.list</td> <td style="text-align: left;">array</td> <td>返回的浏览记录列表</td> </tr> <tr> <td style="text-align: left;">data.list.id</td> <td style="text-align: left;">long</td> <td>商品id</td> </tr> <tr> <td style="text-align: left;">data.list.name</td> <td style="text-align: left;">string</td> <td>商品名称</td> </tr> <tr> <td style="text-align: left;">data.list.price</td> <td style="text-align: left;">decimal</td> <td>商品价格</td> </tr> <tr> <td style="text-align: left;">data.list.status</td> <td style="text-align: left;">enum</td> <td>商品的状态(pending,rejected,available,trading,sold)</td> </tr> <tr> <td style="text-align: left;">data.list.image</td> <td style="text-align: left;">string</td> <td>商品图片地址</td> </tr> <tr> <td style="text-align: left;">data.list.create_time</td> <td style="text-align: left;">LocalDateTime</td> <td>创建商品的时间</td> </tr> <tr> <td style="text-align: left;">data.list.update_time</td> <td style="text-align: left;">LocalDateTime</td> <td>修改商品的时间</td> </tr> </tbody> </table> <h2>响应示例</h2> <pre><code>{     &amp;quot;code&amp;quot;: 20041,     &amp;quot;data&amp;quot;: {         &amp;quot;total&amp;quot;: 2,         &amp;quot;list&amp;quot;: [ {                 &amp;quot;id&amp;quot;: 18,                 &amp;quot;name&amp;quot;: &amp;quot;二手自行车&amp;quot;,                 &amp;quot;price&amp;quot;: 100.23,                 &amp;quot;status&amp;quot;: &amp;quot;available&amp;quot;,                 &amp;quot;image&amp;quot;: &amp;quot;https://twt-trade-platform.oss-cn-beijing.aliyuncs.com/242fac3d-0fe2-4b66-9b04-94f339550433.jpg&amp;quot;,                 &amp;quot;create_time&amp;quot;: &amp;quot;2025-02-24 16:12:30&amp;quot;,                 &amp;quot;update_time&amp;quot;: &amp;quot;2025-02-24 20:01:27&amp;quot;             },             {                 &amp;quot;id&amp;quot;: 13,                 &amp;quot;name&amp;quot;: &amp;quot;二手自行车&amp;quot;,                 &amp;quot;price&amp;quot;: 250.05,                 &amp;quot;status&amp;quot;: &amp;quot;available&amp;quot;,                 &amp;quot;image&amp;quot;: &amp;quot;https://twt-trade-platform.oss-cn-beijing.aliyuncs.com/242fac3d-0fe2-4b66-9b04-94f339550433.jpg&amp;quot;,                 &amp;quot;create_time&amp;quot;: &amp;quot;2025-02-22 20:30:23&amp;quot;,                 &amp;quot;update_time&amp;quot;: &amp;quot;2025-02-22 20:30:23&amp;quot;             }         ]     },     &amp;quot;message&amp;quot;: &amp;quot;查询商品列表成功&amp;quot; }</code></pre> <h2>状态码</h2> <table> <thead> <tr> <th style="text-align: left;">状态码</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">20041</td> <td>查询成功</td> </tr> <tr> <td style="text-align: left;">20040</td> <td>查询错误</td> </tr> </tbody> </table> <h2>备注</h2> <p>pending 审核中 rejected 审核失败 available 可购买 trading 交易中 sold 已售出</p> <p>asc 升序 desc 降序</p> <ul> <li>更多返回状态码请看首页的状态码描述</li> </ul>

页面列表

ITEM_HTML