[TOC] ## 列表 * 請求地址: `/banner` * 請求方式: get * 請求參數: 無 * 成功返回: ```json { "code": 0, "data": { "data": [], "currentPage": 1, "pageNumber": 10, "count": 0 } } ``` * 失敗返回: ```json { "code": -1, "msg": "參數錯誤!" } ``` ## 分頁 * 請求地址: `/banner/pag` * 請求方式: get * 請求參數: | 字段名 | 字段類型 | 字段長度 | 必填 | 字段說明 | | --- | --- | --- | --- | --- | | `currentPage` | int | 11 | `是` | 當前頁 | | `pageNumber` | int | 11 | `是` | 頁碼 | * 成功返回: ```json { "code": 0, "data": { "data": [] } } ``` * 失敗返回: ```json { "code": -1, "msg": "參數錯誤!" } ``` ## 搜索 * 請求地址: `/banner/search` * 請求方式: get * 請求參數: | 字段名 | 字段類型 | 字段長度 | 必填 | 字段說明 | | --- | --- | --- | --- | --- | | `search` | string | 2-200 | `是` | 搜索內容(標題) | * 成功返回: ```json { "code": 0, "data": { "data": [] } } ``` * 失敗返回: ```json { "code": -1, "msg": "參數錯誤!" } ``` ## 新增查詢(獲取圖片上傳路徑) * 請求地址: `/banner/read` * 請求方式: get * 請求參數:無 * 成功返回: ```json { "oss_id": "",//上傳參數 "host": "",//上傳地址 "policy": "",//上傳參數 "signature": "",//上傳參數 "expire": 1514861903,//上傳時間 "dir": "banner",//上傳的文件夾 "max_size": 10485760//文件大小 } ``` >[info] 上傳參數 ```json "OSSAccessKeyId": "oss_id", "policy": "policy", "Signature": "signature", "key":"key", "success_action_status":"201", "file":"raw file data" ``` >[info] 提交地址為返回參數中的host >[danger] 注：上傳方式 需要使用表單 `FormData` 格式上傳 >注：返回的上傳參數中若有key，必須使用返回的key，如果沒有，就需要使用返回的 `dir+/filename` 的格式拼接文件名 >注：`filename` 是自己定義的文件名 >注： file字段**必須在最后**，類型根據平臺不同而不同，兼容 `FormData`即可 >注：上傳成功之后會返回一個xml格式的文件，請解析xml文件 。 >注：取出xml文件的 location 當做圖片或者視頻地址 提交到服務器 >注：上傳圖片請自定義文件名 * 失敗返回: ```json { "code": -1, "msg": "參數錯誤!" } ``` ## 新增保存 * 請求地址: `/banner/save` * 請求方式: post * 請求參數: | 字段名 | 字段類型 | 字段長度 | 必填 | 字段說明 | | --- | --- | --- | --- | --- | | `title` | string | 2-32 | `是` | 標題 | | `img` | string | 2-160 | `是` | 圖片地址 | | `url` | string | 2-160 | `是` | 連接地址 | | `order` | int | 11 | `是` | 前端排序 | | `show` | int | 11 | `是` | 是否在前端顯示 | * 成功返回: ```json { "code": 0 } ``` * 失敗返回: ```json { "code": -1, "msg": "參數錯誤!" } ``` ## 修改查詢 * 請求地址: `/banner/edit` * 請求方式: get * 請求參數: | 字段名 | 字段類型 | 字段長度 | 必填 | 字段說明 | | --- | --- | --- | --- | --- | | `id` | int | 11 | `是` | id | * 成功返回: ```json { "code": 0, "data": { "data": [] } } ``` * 失敗返回: ```json { "code": -1, "msg": "參數錯誤!" } ``` ## 修改保存 * 請求地址: `/banner/update` * 請求方式: post * 請求參數: | 字段名 | 字段類型 | 字段長度 | 必填 | 字段說明 | | --- | --- | --- | --- | --- | | `id` | int | 11 | `是` | id | | `title` | string | 2-32 | `是` | 標題 | | `img` | string | 2-160 | `是` | 圖片地址 | | `url` | string | 2-160 | `是` | 連接地址 | | `order` | int | 11 | `是` | 前端排序 | | `show` | int | 11 | `是` | 是否在前端顯示 | * 成功返回: ```json { "code": 0 } ``` * 失敗返回: ```json { "code": -1, "msg": "參數錯誤!" } ``` ## 刪除 * 請求地址: `/banner/delete` * 請求方式: post * 請求參數: | 字段名 | 字段類型 | 字段長度 | 必填 | 字段說明 | | --- | --- | --- | --- | --- | | `id` | int | 11 | `是` | id | * 成功返回: ```json { "code": 0 } ``` * 失敗返回: ```json { "code": -1, "msg": "參數錯誤!" } ```