houseworking/manage-server

接口说明

通用接口

上传图片

• 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