14 获取当前用户已发布房源信息#

获取用户已发布房源信息服务（商品相关）

创建命令#

1
$ micro new -type "srv" sss/GetUserHouses

流程与接口#

1
#Request:
2
method: GET
3
url:api/v1.0/user/houses
4
#data:
5
no input data
6
#Response
7
#返回成功：
8
{
9
  "errno": "0",
10
  "errmsg": "成功",
11
  "data": {
12
    "houses": [
13
      {
14
        "address": "西三旗桥东",
15
        "area_name": "昌平区",
16
        "ctime": "2017-11-06 11:16:24",
17
        "house_id": 1,
18
        "img_url": "http://101.200.170.171:9998/group1/M00/00/00/Zciqq1oBJY-AL3m8AAS8K2x8TDE052.jpg",
19
        "order_count": 0,
20
        "price": 100,
21
        "room_count": 2,
22
        "title": "上奥世纪中心",
23
        "user_avatar": "http://101.200.170.171:9998/group1/M00/00/00/Zciqq1oBLFeALIEjAADexS5wJKs340.png"
24
      },
25
      {
26
        "address": "北清路郑上路",
27
        "area_name": "顺义区",
28
        "ctime": "2017-11-06 11:38:54",
29
        "house_id": 2,
30
        "img_url": "http://101.200.170.171:9998/group1/M00/00/00/Zciqq1oBKtmAC8y8AAZcKg5PznU817.jpg",
31
        "order_count": 0,
32
        "price": 1000,
33
        "room_count": 1,
34
        "title": "修正大厦302教室",
35
        "user_avatar": "http://101.200.170.171:9998/group1/M00/00/00/Zciqq1oBLFeALIEjAADexS5wJKs340.png"
36
      }
37
    ]
38
  }
39
}
40

41
#返回失败：
42
{
43
    "errno": "400x",   //状态码
44
    "errmsg":"状态错误信息"
45
}

15 发布房源信息#

发送（发布）房源信息服务（商品相关）

创建命令#

1
$ micro new --type "srv" sss/PostHouses

流程与接口#

1
#Request:
2
method: POST
3
url:api/v1.0/houses
4
#data:
5
{
6
"title":"上奥世纪中心",
7
"price":"666",
8
"area_id":"5",
9
"address":"西三旗桥东建材城1号",
10
"room_count":"2",
11
"acreage":"60",
12
"unit":"2室1厅",
13
"capacity":"3",
14
"beds":"双人床2张",
15
"deposit":"200",
16
"min_days":"3",
17
"max_days":"0",
18
"facility":["1","2","3","7","12","14","16","17","18","21","22"]
19
}
20
#Response
21
#返回成功：
22
{
23
  "errno": "0",
24
  "errmsg": "成功"
25
  "data" :{
26
        "house_id": "1"
27
  }
28
}
29
#返回失败：
30
{
31
    "errno": "400x",   //状态码
32
    "errmsg":"状态错误信息"
33
}

16 上传房屋图片#

发送（上传）房屋图片服务（商品相关）

创建命令#

1
$ micro new --type "srv" sss/PostHousesImage

流程与接口#

1
#Request:
2
method: POST
3
#3表示房源id
4
url:api/v1.0/houses/3/images
5
url:api/v1.0/houses/:id/images
6

7
#data:
8
图片二进制数据
9
#Response
10
#返回成功：
11
{
12
  "errno": "0",
13
  "errmsg": "成功",
14
  "data": {
15
    "url": "http://101.200.170.171:9998/group1/M00/00/00/Zciqq1oBLmWAHlsrAAaInSze-cQ719.jpg"
16
  }
17
}
18
#返回失败：
19
{
20
    "errno": "400x",   //状态码
21
    "errmsg":"状态错误信息"
22
}

17 获取房源详细信息#

获取房屋详细信息服务（商品相关）

创建命令#

1
$ micro new --type "srv" sss/GetHouseInfo

流程与接口#

1
#Request:
2
method: GET
3
#1表示房源id
4
url:api/v1.0/houses/1
5
url:api/v1.0/houses/:id
6
#data:
7
no input data
8
#Response
9
#返回成功：
10
{
11
  "errno": "0",
12
  "errmsg": "成功",
13
  "data": {
14
    "house": {
15
      "acreage": 80,
16
      "address": "西三旗桥东",
17
      "beds": "2双人床",
18
      "capacity": 3,
19
      "comments": [
20
        {
21
          "comment": "评论的内容",
22
          "ctime": "2017-11-12 12:30:30",
23
          "user_name": "评论人的姓名"
24
        },
25
        {
26
          "comment": "评论的内容",
27
          "ctime": "2017-11-12 12:30:30",
28
          "user_name": "评论人的姓名"
29
        },
30
        {
31
          "comment": "评论的内容",
32
          "ctime": "2017-11-12 12:30:30",
33
          "user_name": "评论人的姓名"
34
        }
35
      ],
36
      "deposit": 200,
37
      "facilities": [9,11,13,16,19,20,21,23],
38
      "hid": 1,
39
      "img_urls": [
40
        "http://101.200.170.171:9998/group1/M00/00/00/Zciqq1oBJY-AL3m8AAS8K2x8TDE052.jpg",
41
        "http://101.200.170.171:9998/group1/M00/00/00/Zciqq1oBJZmAYqGWAAaInSze-cQ230.jpg"
42
      ],
43
      "max_days": 30,
44
      "min_days": 1,
45
      "price": 100,
46
      "room_count": 2,
47
      "title": "上奥世纪中心",
48
      "unit": "3室3厅",
49
      "user_avatar": "http://101.200.170.171:9998/group1/M00/00/00/Zciqq1oBLFeALIEjAADexS5wJKs340.png",
50
      "user_id": 1,
51
      "user_name": "Panda"
52
    },
53
    "user_id": 1
54
  }
55
}
56

57
#返回失败：
58
{
59
    "errno": "400x",   //状态码
60
    "errmsg":"状态错误信息"
61
}

18 获取首页动画图片#

获取首页轮播图片服务（首页相关）

创建命令#

1
$ micro new --type "srv" sss/GetIndex

流程与接口#

1
#Request:
2
method: GET
3
url:api/v1.0/houses/index
4
#data:
5
no input data
6
#Response
7
#返回成功：
8
{
9
  "errno": "0",
10
  "errmsg": "成功",
11
  "data": {
12
        "houses": [
13
      {
14
    "house_id":    this.Id,
15
    "title":       this.Title,
16
    "price":       this.Price,
17
    "area_name":   this.Area.Name,
18
    "img_url":     utils.AddDomain2Url(this.Index_image_url),
19
    "room_count":  this.Room_count,
20
    "order_count": this.Order_count,
21
    "address":     this.Address,
22
    "user_avatar": utils.AddDomain2Url(this.User.Avatar_url),
23
    "ctime":       this.Ctime.Format("2006-01-02 15:04:05"),
24
  },
25
      {
26
    "house_id":    this.Id,
27
    "title":       this.Title,
28
    "price":       this.Price,
29
    "area_name":   this.Area.Name,
30
    "img_url":     utils.AddDomain2Url(this.Index_image_url),
31
    "room_count":  this.Room_count,
32
    "order_count": this.Order_count,
33
    "address":     this.Address,
34
    "user_avatar": utils.AddDomain2Url(this.User.Avatar_url),
35
    "ctime":       this.Ctime.Format("2006-01-02 15:04:05"),
36
  }
37
    ],
38

39
  }
40
}
41

42

43
#返回失败：
44
{
45
    "errno": "400x",   //状态码
46
    "errmsg":"状态错误信息"
47
}

19 搜索房源#

获取（搜索）房源服务（商品相关）

创建命令#

1
$ micro new --type "srv" sss/GetHouses

流程与接口#

1
#Request:
2
method: GET
3
#adi表示地区编号
4
#sd表示起始日期
5
#ed表示结束日期
6
#sk表示查询方式
7
#p表示页码
8
url:api/v1.0/houses?aid=5&sd=2017-11-12&ed=2017-11-30&sk=new&p=1
9
#data:
10
no input data
11
#Response
12
#返回成功：
13
{
14
  "errno": "0",
15
  "errmsg": "成功",
16
  "data": {
17
    "current_page": 1,
18
    "houses": [
19
      {
20
        "address": "西三旗桥东",
21
        "area_name": "昌平区",
22
        "ctime": "2017-11-06 11:16:24",
23
        "house_id": 1,
24
        "img_url": "http://101.200.170.171:9998/group1/M00/00/00/Zciqq1oBJY-AL3m8AAS8K2x8TDE052.jpg",
25
        "order_count": 0,
26
        "price": 100,
27
        "room_count": 2,
28
        "title": "上奥世纪中心13号楼",
29
        "user_avatar": "http://101.200.170.171:9998/group1/M00/00/00/Zciqq1oBLFeALIEjAADexS5wJKs340.png"
30
      },
31
      {
32
        "address": "西三旗桥东",
33
        "area_name": "昌平区",
34
        "ctime": "2017-11-06 11:16:24",
35
        "house_id": 1,
36
        "img_url": "http://101.200.170.171:9998/group1/M00/00/00/Zciqq1oBJY-AL3m8AAS8K2x8TDE052.jpg",
37
        "order_count": 0,
38
        "price": 100,
39
        "room_count": 2,
40
        "title": "上奥世纪中心18号楼",
41
        "user_avatar": "http://101.200.170.171:9998/group1/M00/00/00/Zciqq1oBLFeALIEjAADexS5wJKs340.png"
42
        }
43
    ],
44
    "total_page": 1
45
  }
46
}
47

48
#返回失败：
49
{
50
    "errno": "400x",   //状态码
51
    "errmsg":"状态错误信息"
52
}

20 发布订单#

发送（发布）订单服务（订单相关）

创建命令#

1
$ micro new --type "srv" sss/PostOrders

流程与接口#

1
#Request:
2
method: POST
3
url:api/v1.0/orders
4
#data:
5
{
6
  "house_id": "1",
7
  "start_date": "2017-11-11 21:23:49",
8
  "end_date": "2017-11-12 21:23:49",
9
}
10

11
#Response
12
#返回成功：
13
{
14
  "errno": "0",
15
  "errmsg": "成功",
16
  "data": {
17
    "order_id":"1"
18
  }
19
}
20

21
#返回失败：
22
{
23
    "errno": "400x",   //状态码
24
    "errmsg":"状态错误信息"
25
}

21 请求查看房东/租客订单信息#

获取房东/租户订单信息服务（订单相关）

创建命令#

1
$ micro new --type "srv" sss/GetUserOrder

流程与接口#

1
#Request:
2
method: GET
3
url:api/v1.0/user/orders?role=custom 备注:role=custom为租客查看订单信息
4
url:api/v1.0/user/orders?role=landlord 备注:role=landlord为房东查看被预定订单信息
5
#data:
6
no input data
7

8
#Response
9
#返回成功：
10
{
11
  "errno": "0",
12
  "errmsg": "成功",
13
  "data": {
14
    "orders": [
15
      {
16
        "amount": 200,
17
        "comment": "哈哈拒接",
18
        "ctime": "2017-11-11 21:23:49",
19
        "days": 2,
20
        "end_date": "2017-11-29 16:00:00",
21
        "img_url": "http://101.200.170.171:9998/group1/M00/00/00/Zciqq1oBJY-AL3m8AAS8K2x8TDE052.jpg",
22
        "order_id": 3,
23
        "start_date": "2017-11-28 16:00:00",
24
        "status": "REJECTED",//WAIT_ACCPET,WAIT_COMMENT,REJECTED,COMPLETE,CANCELED
25
        "title": "上奥世纪中心"
26
      },
27
      {
28
        "amount": 1500,
29
        "comment": "",
30
        "ctime": "2017-11-11 01:32:10",
31
        "days": 15,
32
        "end_date": "2017-11-24 16:00:00",
33
        "img_url": "http://101.200.170.171:9998/group1/M00/00/00/Zciqq1oBJY-AL3m8AAS8K2x8TDE052.jpg",
34
        "order_id": 2,
35
        "start_date": "2017-11-10 16:00:00",
36
        "status": "WAIT_COMMENT",
37
        "title": "上奥世纪中心"
38
      },
39
      {
40
        "amount": 300,
41
        "comment": "",
42
        "ctime": "2017-11-10 01:46:00",
43
        "days": 3,
44
        "end_date": "2017-11-11 16:00:00",
45
        "img_url": "http://101.200.170.171:9998/group1/M00/00/00/Zciqq1oBJY-AL3m8AAS8K2x8TDE052.jpg",
46
        "order_id": 1,
47
        "start_date": "2017-11-09 16:00:00",
48
        "status": "WAIT_COMMENT",
49
        "title": "上奥世纪中心"
50
      }
51
    ]
52
  }
53
}
54

55

56
#返回失败：
57
{
58
    "errno": "400x",   //状态码
59
    "errmsg":"状态错误信息"
60
}

22 房东同意/拒绝订单#

更新房东同意/拒绝订单（订单相关）

创建命令#

1
$ micro new --type "srv" sss/PutOrders

流程与接口#

1
#Request:
2
method: PUT
3
#4表示订单id
4
url:api/v1.0/orders/4/status
5
url:api/v1.0/orders/:id/status
6
#data:
7
#"accept"表示接受
8
#"reject"表示拒绝
9
{action: "accept"}
10

11
#Response
12
#返回成功：
13

14
{
15
  "errno": "0",
16
  "errmsg": "成功"
17
}
18

19
#返回失败：
20
{
21
    "errno": "400x",   //状态码
22
    "errmsg":"状态错误信息"
23
}

23 用户评价订单信息#

更新用户评价订单信息（订单相关）

创建命令#

1
$ micro new --type "srv" sss/PutComment

流程与接口#

1
#Request:
2
method: PUT
3
#2表示订单id
4
url:api/v1.0/orders/2/comment
5
url:api/v1.0/orders/:id/comment
6
#data:
7
{
8
    order_id: "2",
9
    comment: "烂房子！"
10
}
11
#Response
12
#返回成功：
13

14
{
15
  "errno": "0",
16
  "errmsg": "成功"
17
}
18

19
#返回失败：
20
{
21
    "errno": "400x",   //状态码
22
    "errmsg":"状态错误信息"
23
}

14 获取当前用户已发布房源信息#

创建命令#

流程与接口#

15 发布房源信息#

创建命令#

流程与接口#

16 上传房屋图片#

创建命令#

流程与接口#

17 获取房源详细信息#

创建命令#

流程与接口#

18 获取首页动画图片#

创建命令#

流程与接口#

19 搜索房源#

创建命令#

流程与接口#

20 发布订单#

创建命令#

流程与接口#

21 请求查看房东/租客订单信息#

创建命令#

流程与接口#

22 房东同意/拒绝订单#

创建命令#

流程与接口#

23 用户评价订单信息#

创建命令#

流程与接口#

相关阅读