**基礎URL** PC管理后臺接口基礎URL：你的域名/adminapi 小程序接口基礎URL：你的域名/shopapi **請求方式** get請求：主要用于獲取數據、獲取下載鏈接 post請求：主要用于添加數據、更新數據、刪除數據 **所有接口在請求的時候，某些參數都是固定名稱，在接口文檔中不會再說明需要此參數。** **常用** | 參數名稱 |數據類型 | 缺少值|說明| | ------ | ------ | ------ |------ | | token | string| |token為驗證令牌，所有需要登錄接口必填。token值必須放在Headers(請求頭)。| | version | string| |version為客戶端版本，所有接口都需要傳。version值必須放在Headers(請求頭)。| 列表 | 參數名稱 |數據類型 | 缺少值|說明| | ------ | ------ | ------ |------ | | page_no | int|1| 所有列表接口固定參數，此參數會頁碼。| | page_size |int |25| 所有列表接口必固定參數，此參數為每頁數量。| | page_type |int |0| 當page_type等于1的時候，不分頁，返回列表所有數據或導出所有數據（可能被系統限制，一般夠用）| | order_by | string|"desc"|排序方式，"desc"為降序排列,"asc"為正序排列。| | field | string||排序字段的名稱，必須與列表字段名稱一致。| | start_time | string||開始時間，時間格式為"2021-07-06 00:00:00"| | end_time | string||結束時間，時間格式為"2021-07-06 23:59:59"| | start | int|| 開始值 | | end | int||結束值| 列表導出 | 參數名稱 |數據類型 | 缺少值|說明| | ------ | ------ | ------ |------ | | export | string||excel等于1時，獲取導出信息，等于2時，獲取導出文件下載鏈接| | page_type | int|0|導出類型 0-全部導出 1-按頁碼導出| | page_size | int|25|每頁數量| | page_start | int|1|導出范圍頁碼開始值| | page_end | int|200|導出范圍頁碼結束值| | file_name |string|列表默認名稱|導出下載文件的名稱| # 響應 ## 返回值通用格式 ### 通用格式 ``` { "code": 0, "show": 0, "msg": "", "data": { } } ``` | 字段名稱|數據類型 |說明| | ------ | ------ | ------ | | code |int | 1-操作成功；0-操作失敗； -1重定向到登錄頁；2-打開新的頁面(data.url)| | show |int | 0-不提示msg內容；1-提示msg內容 ；| | msg | string| 提示語| | data | object | 數據 | ### 數據列表 ``` { "code": 1, "show": 0, "msg": "", "data": { "lists": [ { "id": 3, "name": "3運營人員3", "account": "1", "role_id": 2, "create_time": "2020-12-20 15:44:39", "disable": 0, "login_time": "2021-07-07 11:35:43", "login_ip": "1.119.194.226", "multipoint_login": 1, "disable_desc": "正常", "role_name": "運營人" }, { "id": 2, "name": "運營人員", "account": "test", "role_id": 2, "create_time": "2020-12-20 15:44:39", "disable": 0, "login_time": "2021-07-29 15:43:05", "login_ip": "1.119.194.226", "multipoint_login": 1, "disable_desc": "正常", "role_name": "運營人" }, { "id": 1, "name": "賬號1", "account": "admin", "role_id": 1, "create_time": "1970-01-14 04:38:31", "disable": 0, "login_time": "2021-07-27 16:41:49", "login_ip": "113.110.226.198", "multipoint_login": 0, "disable_desc": "正常", "role_name": "系統超級管理" } ], "count": 3, "page_no": 1, "page_size": 25, "extend": [] } } ``` ### 列表導出信息 ```{ "code": 1, "show": 0, "msg": "", "data": { "count": 3, "page_size": 25, "sum_page": 1, "max_page": 1000, "all_max_size": 25000, "page_start": 1, "page_end": 1, "file_name": "管理員列表" } ``` | 字段名稱|數據類型 |說明| | ------ | ------ | ------ | | data | object | 數據 | | - count | int | 所有數據記錄數 | | - page_size | int | 每頁記錄數 | | - sum_page| int | 一共多少頁 | | - max_page | int | 最多導出記錄數 | | - page_start | int | 導出范圍頁碼開始值 | | - page_end| int|導出范圍頁碼結束值| | - file_name| string|列表導出下載文件名| ### 列表導出 ``` { "code": 2, "show": 0, "msg": "", "data": { "url": "http://www.likeshopb2cv3.localhost/index/download/export.html?file=5e372043e219f021a2ca899155425e1c1627551184" } } ``` | 字段名稱|數據類型 |說明| | ------ | ------ | ------ | | data | object | 數據 | | - url | string | 到文件下載鏈接，前端打開新鏈接即可下載 |