twt-trade-platform

校园二手交易平台


新增商品

<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>{     &amp;quot;name&amp;quot; : &amp;quot;二手自行车&amp;quot;,     &amp;quot;price&amp;quot; : 250.05,     &amp;quot;description&amp;quot; : &amp;quot;自用9成新&amp;quot;,     &amp;quot;category&amp;quot; : &amp;quot;代步&amp;quot;,     &amp;quot;campuses&amp;quot; : [&amp;quot;北洋园&amp;quot;, &amp;quot;卫津路&amp;quot;],     &amp;quot;images&amp;quot; : [         &amp;quot;https://twt-trade-platform.oss-cn-beijing.aliyuncs.com/242fac3d-0fe2-4b66-9b04-94f339550433.jpg&amp;quot;,         &amp;quot;https://twt-trade-platform.oss-cn-beijing.aliyuncs.com/3b17d698-6123-413e-a8ff-08e297d2d01e.jpg&amp;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>{     &amp;quot;code&amp;quot;: 20011,     &amp;quot;data&amp;quot;: null,     &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;">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>

页面列表

ITEM_HTML