bookShopApi

商城Api项目


提交订单

<h5>接口描述</h5> <ul> <li>提交订单</li> </ul> <h5>请求URL</h5> <ul> <li><code>/api/orders</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>说明</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> <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;">address_id</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>地址id</td> </tr> </tbody> </table> <h5>返回参数</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;">id</td> <td style="text-align: left;">是</td> <td style="text-align: left;">int</td> <td>自增长主键ID</td> </tr> <tr> <td style="text-align: left;">order_no</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>单号</td> </tr> <tr> <td style="text-align: left;">user_id</td> <td style="text-align: left;">是</td> <td style="text-align: left;">int</td> <td>创建者</td> </tr> <tr> <td style="text-align: left;">amount</td> <td style="text-align: left;">是</td> <td style="text-align: left;">int</td> <td>总价</td> </tr> <tr> <td style="text-align: left;">status</td> <td style="text-align: left;">是</td> <td style="text-align: left;">int</td> <td>状态</td> </tr> <tr> <td style="text-align: left;">address_id</td> <td style="text-align: left;">是</td> <td style="text-align: left;">int</td> <td>收货地址</td> </tr> <tr> <td style="text-align: left;">express_type</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>快递类型</td> </tr> <tr> <td style="text-align: left;">express_no</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>快递号</td> </tr> <tr> <td style="text-align: left;">pay_time</td> <td style="text-align: left;">是</td> <td style="text-align: left;">timestamp</td> <td>支付时间</td> </tr> <tr> <td style="text-align: left;">pay_type</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>支付类型</td> </tr> <tr> <td style="text-align: left;">trade_no</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>支付流水号</td> </tr> <tr> <td style="text-align: left;">created_at</td> <td style="text-align: left;">是</td> <td style="text-align: left;">timestamp</td> <td>添加时间</td> </tr> <tr> <td style="text-align: left;">updated_at</td> <td style="text-align: left;">是</td> <td style="text-align: left;">timestamp</td> <td>修改时间</td> </tr> </tbody> </table> <h5>返回示例</h5> <ul> <li>状态码 200 创建成功</li> </ul> <pre><code>{ "id": 1, "order_no": "123123", "user_id": 1, "amount": 111, "status": 1, "address_id": 1, "express_type": null, "express_no": null, "pay_time": null, "pay_type": null, "trade_no": null, "created_at": null, "updated_at": null }</code></pre> <ul> <li>状态码 400 请求异常</li> </ul> <pre><code>{ "message": "xx商品 库存不足, 请重新选择商品", "status_code": 400, }</code></pre> <ul> <li>状态码 422 参数异常</li> </ul> <pre><code>{ "message": "The given data was invalid.", "errors": { "address_id": [ "收货地址 不能为空" ] }, }</code></pre>

页面列表

ITEM_HTML