shopApi

商城api项目


添加商品

<h4>接口描述</h4> <ul> <li>添加商品</li> </ul> <h5>请求URL</h5> <ul> <li><code>/api/admin/goods</code></li> </ul> <h5>请求方式</h5> <ul> <li>POST</li> </ul> <h5>请求头部</h5> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">必选</th> <th style="text-align: left;">类型</th> <th style="text-align: left;">说明</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 style="text-align: left;">JWT token</td> </tr> </tbody> </table> <h5>Body 参数</h5> <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;">title</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>标题</td> </tr> <tr> <td style="text-align: left;">category_id</td> <td style="text-align: left;">是</td> <td style="text-align: left;">integer</td> <td>分类ID</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;">price</td> <td style="text-align: left;">是</td> <td style="text-align: left;">integerinteger</td> <td>价格</td> </tr> <tr> <td style="text-align: left;">stock</td> <td style="text-align: left;">是</td> <td style="text-align: left;">integer</td> <td>库存</td> </tr> <tr> <td style="text-align: left;">cover</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>封面图</td> </tr> <tr> <td style="text-align: left;">pics</td> <td style="text-align: left;">是</td> <td style="text-align: left;">json</td> <td>小图集</td> </tr> <tr> <td style="text-align: left;">details</td> <td style="text-align: left;">是</td> <td style="text-align: left;">text</td> <td>详情</td> </tr> <tr> <td style="text-align: left;">is_on</td> <td style="text-align: left;">否</td> <td style="text-align: left;">tinyInteger</td> <td>是否上架 0下架 1上架</td> </tr> <tr> <td style="text-align: left;">is_recommend</td> <td style="text-align: left;">否</td> <td style="text-align: left;">tinyInteger</td> <td>是否推荐 0不推荐 1推荐</td> </tr> </tbody> </table> <h5>返回示例</h5> <ul> <li> <p>状态码201请求成功</p> </li> <li>状态码422参数错误</li> </ul> <pre><code> { "message": "The given data was invalid.", "errors": { "title": [ "标题 不能为空。" ], "category_id": [ "category id 不能为空。" ], "description": [ "描述 不能为空。" ], "price": [ "price 不能为空。" ], "stock": [ "stock 不能为空。" ], "cover": [ "cover 不能为空。" ], "pics": [ "pics 不能为空。" ], "details": [ "details 不能为空。" ] }, "status_code": 422, }</code></pre> <ul> <li>状态码400参数错误</li> </ul> <pre><code> { "message": "只能向三级分类添加商品", "status_code": 400, }</code></pre> <ul> <li>状态码401 请求头错误</li> </ul> <pre><code> { "message": "Failed to authenticate because of bad credentials or an invalid authorization header.", "status_code": 401, }</code></pre>

页面列表

ITEM_HTML