分页查询商品列表
<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;keyword=自行车&amp;category=代步&amp;campus=北洋园&amp;min_price=100&amp;max_price=300&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>{
&quot;code&quot;: 20041,
&quot;data&quot;: {
&quot;total&quot;: 2,
&quot;list&quot;: [
{
&quot;id&quot;: 18,
&quot;name&quot;: &quot;二手自行车&quot;,
&quot;price&quot;: 100.23,
&quot;status&quot;: &quot;available&quot;,
&quot;image&quot;: &quot;https://twt-trade-platform.oss-cn-beijing.aliyuncs.com/242fac3d-0fe2-4b66-9b04-94f339550433.jpg&quot;,
&quot;create_time&quot;: &quot;2025-02-24 16:12:30&quot;,
&quot;update_time&quot;: &quot;2025-02-24 20:01:27&quot;
},
{
&quot;id&quot;: 13,
&quot;name&quot;: &quot;二手自行车&quot;,
&quot;price&quot;: 250.05,
&quot;status&quot;: &quot;available&quot;,
&quot;image&quot;: &quot;https://twt-trade-platform.oss-cn-beijing.aliyuncs.com/242fac3d-0fe2-4b66-9b04-94f339550433.jpg&quot;,
&quot;create_time&quot;: &quot;2025-02-22 20:30:23&quot;,
&quot;update_time&quot;: &quot;2025-02-22 20:30:23&quot;
}
]
},
&quot;message&quot;: &quot;查询商品列表成功&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>