# 接口说明 ## 通用接口 ### 上传图片 - `POST /upload` - 参数: 参数 | 类型 | 可选 | 备注 ----------- | ------ | ------ | -------- photo | png/jpeg | 必须 | 图片 - 响应: ``` { "status": 0, "path": "/path/photo.jpeg" } { "status": -1, "message": "error, photo is valid" } { "status": -2, "message": "error, error message" } ``` ## 活动接口 ### 创建/修改活动 - `POST /campaign/store` - 参数: 参数 | 类型 | 可选 | 备注 ----------- | ------ | ------------------ | -------- id | integer | 创建时空,修改时必须 | 活动id title | string | 必须 | 标题 content | string | 必须 | 内容 status | integer | 可选 | 活动状态:0.进行中, 1.结束 - 响应: ``` { "status": 0, "message": "保存成功" } { "status": -1, "message": "信息不能为空!" } ``` ### 删除活动 - `DELETE /campaign/delete` - 参数: 参数 | 类型 | 可选 | 备注 ----------- | ------ | ------- | -------- id | integer | 必须 | 活动id - 响应: ``` { "status": 0, "message": "删除成功" } { "status": -1, "message": "id不能为空!" } ``` ### 获得某活动 - `GET /campaign/${id}` - 参数: 无 - 响应: ``` { "status": 0, "data": { "id": 123456, "title": "测试标题", "content": "测试内容", "status": 0, "created_at": "2018-02-16 11:10:56", "updated_at": "2018-02-16 12:00:51" } } ``` ### 分页查询活动 - `GET /campaigns` - 参数: 无 - 响应: ``` { "total": 50, "per_page": 15, "current_page": 1, "last_page": 4, "first_page_url": "http://laravel.app?page=1", "last_page_url": "http://laravel.app?page=4", "next_page_url": "http://laravel.app?page=2", "prev_page_url": null, "path": "http://laravel.app", "from": 1, "to": 15, "data":[{ "id": 123456, "title": "测试标题", "content": "测试内容", "status": 0, "created_at": "2018-02-16 11:10:56", "updated_at": "2018-02-16 12:00:51" },{ "id": 34578, "title": "测试标题2", "content": "测试内容2", "status": 1, "created_at": "2018-02-16 11:10:56", "updated_at": "2018-02-16 12:00:51" }, ... ] } ``` ## 产品接口 ### 创建/修改产品 - `POST /product/store` - 参数: 参数 | 类型 | 可选 | 备注 ----------- | ------ | ------------------ | -------- id | integer | 创建时空,修改时必须 | 产品id name | string | 必须 | 产品名称 info | string | 必须 | 产品信息 color | string | 必须 | 产品款色 price | double | 必须 | 产品价格 classify | string | 必须 | 产品分类 status | integer | 可选 | 产品状态:0.上架, 1.下架 - 响应: ``` { "status": 0, "message": "保存成功" } { "status": -1, "message": "信息不能为空!" } ``` ### 删除产品 - `DELETE /product/delete` - 参数: 参数 | 类型 | 可选 | 备注 ----------- | ------ | ------- | -------- id | integer | 必须 | 产品id - 响应: ``` { "status": 0, "message": "删除成功" } { "status": -1, "message": "id不能为空!" } ``` ### 获得某产品 - `GET /product/${id}` - 参数:无 - 响应: ``` { "status": 0, "data": { "id": 123456, "name": "测试名称", "info": "测试信息", "price": 1234.31, "classify": "分类1", "color": "款色", "collect_num": 765, //收藏数 "sell_num": 5, //销量 "status": 0, //0上架, 1下架 "created_at": "2018-02-16 11:10:56", "updated_at": "2018-02-16 12:00:51" } } ``` ### 分页查询活动 - `GET /campaigns` - 参数: 无 - 响应: ``` { "total": 50, "per_page": 15, "current_page": 1, "last_page": 4, "first_page_url": "http://laravel.app?page=1", "last_page_url": "http://laravel.app?page=4", "next_page_url": "http://laravel.app?page=2", "prev_page_url": null, "path": "http://laravel.app", "from": 1, "to": 15, "data":[ { "id": 123456, "name": "测试名称", "info": "测试信息", "price": 1234.31, "classify": "分类1", "collect_num": 765, //收藏数 "sell_num": 5, //销量 "status": 0, //0上架, 1下架 "created_at": "2018-02-16 11:10:56", "updated_at": "2018-02-16 12:00:51" }, { "id": 123456, "name": "测试名称", "info": "测试信息", "price": 1234.31, "classify": "分类1", "collect_num": 765, //收藏数 "sell_num": 5, //销量 "status": 0, //0上架, 1下架 "created_at": "2018-02-16 11:10:56", "updated_at": "2018-02-16 12:00:51" } ... ] } ``` ## 家居清洁订单接口 ### 创建/修改家居清洁订单 - `POST `