新增商品
<p>[TOC]</p>
<h2>简要描述</h2>
<ul>
<li>新增商品接口</li>
</ul>
<h2>请求路径</h2>
<ul>
<li><code>/item/add</code></li>
</ul>
<h2>请求方式</h2>
<ul>
<li>POST </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>请求参数格式:application/json</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;">name</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>商品名称(名称长度限定为1-40个字符)</td>
</tr>
<tr>
<td style="text-align: left;">price</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">decimal</td>
<td>商品价格(整数部分限制为5位,小数部分限制为2位)</td>
</tr>
<tr>
<td style="text-align: left;">description</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;">campuses</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">array</td>
<td>商品校区列表</td>
</tr>
<tr>
<td style="text-align: left;">images</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">array</td>
<td>商品图片url地址列表</td>
</tr>
</tbody>
</table>
<h2>请求示例</h2>
<pre><code>{
&quot;name&quot; : &quot;二手自行车&quot;,
&quot;price&quot; : 250.05,
&quot;description&quot; : &quot;自用9成新&quot;,
&quot;category&quot; : &quot;代步&quot;,
&quot;campuses&quot; : [&quot;北洋园&quot;, &quot;卫津路&quot;],
&quot;images&quot; : [
&quot;https://twt-trade-platform.oss-cn-beijing.aliyuncs.com/242fac3d-0fe2-4b66-9b04-94f339550433.jpg&quot;,
&quot;https://twt-trade-platform.oss-cn-beijing.aliyuncs.com/3b17d698-6123-413e-a8ff-08e297d2d01e.jpg&quot;
]
}</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;">null</td>
<td>返回数据</td>
</tr>
<tr>
<td style="text-align: left;">message</td>
<td style="text-align: left;">string</td>
<td>返回信息</td>
</tr>
</tbody>
</table>
<h2>响应示例</h2>
<pre><code>{
&quot;code&quot;: 20011,
&quot;data&quot;: null,
&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;">20011</td>
<td>插入成功</td>
</tr>
<tr>
<td style="text-align: left;">20010</td>
<td>插入错误</td>
</tr>
<tr>
<td style="text-align: left;">30010</td>
<td>格式错误</td>
</tr>
</tbody>
</table>
<h2>备注</h2>
<ul>
<li>更多返回状态码请看首页的状态码描述</li>
</ul>