## 添加户型时搜索大厦得出的列表【选择大厦页面】
+++
get: Api/Housing/searchSource.html
search=搜索关键字 #
start=从多少条开始# 默认为0 //用于分页
length=获取多少条数据# 默认为20 //用于分页
<<<
success
返回参数说明：
[
{
"_id":{"$id":"58a3f6bfa81e5a312913ee8d"},
"name":"北科大厦",
"district_id":"3", //行政区ID。考虑到服务器性能问题。需要客户端获取所有行政区数据后循环匹配名称
"city_id":"1" //市区ID。考虑到服务器性能问题。需要客户端获取所有市区数据后循环匹配名称
},
{
"_id":{"$id":"58a57696b15c80242100002e"},
"name":"\u8f6f\u4ef6\u4ea7\u4e1a\u57fa\u5730",
"district_id":"3",
"city_id":"1"
}
}
+++
## 根据盘源ID获取栋座数量与楼层数量
+++
Api/Housing/getBuildingFloor.html
*source_id=盘源ID #
<<<
success
返回参数说明：
[
{
"building_code":"1A", //栋座名称
"_id":"58aa9c58b15c80682f00002914875767013626", //栋座ID
"total_floor":"20" //楼层数量
},
{
"building_code":"2A",
"_id":"58aa9c58b15c80682f00002914875767155800",
"total_floor":"20"
},
{
"building_code":"3A",
"_id":"58aa9c58b15c80682f00002914875767291185",
"total_floor":"20"
}
]
<<<
error
{
"data": "",
"info": "缺少必须参数:source_id。",
"code": 997,
"state": 2
}
可能返回的错误：
66
代号 错误
67
997 大厦ID不可为空或有误
68
996 为找到数据
69
+++
## 添加户型
>注意：数组形式是需要在字段名称后面加个“[]”如：action在后面加个方括号 “action[]”
注意：图片是先调用上传图片接口，值为图片接口返回的图片地址
+++
post:Api/Housing/addSource/token/用户token
*source_id=楼盘ID #
is_authentication=是否认证 1为认证，2为不认证【需要认证的话需要携带户型委托书ID】 默认为2#
type=认证方式 3为经纪人认证的房源。4为经纪人独家代理的房源 5为用户的私自房源 默认为3#
*room_title=户型标题 #
*building_id=栋座 #
*floor=楼层 #
*doorplate=门牌号 #
*area=面积 #
*price=价格 #
*room_price_id=价格单位 #
*renovation_id=装修类型 #
action=空间匹配 【数组形式】#
*ground_type_bet=付款方式【押】 #
*ground_type_pay=付款方式【付】 #
*payment_type=佣金 #
matching=空间配套 【数组形式】#
*con_name=联系人 #
*con_tel=联系电话 #
*toomImg=户型图 【数组形式】#
*property_fee=物业费#
*conditioner_fee=空调费#
other_fee=其他费#
entrust_id= 委托书ID【需要认证的户型，委托书ID不可为空】 #
<<<
success
返回参数说明：
{
"data":"",
"info":"添加成功",
"code":1000,
"state":1
}
<<<
error
{
"data": "",
"info": "", //错误原因说明
"code": 1006, //错误代码
"state": 2 //状态
}
可能返回的错误：
代号 错误
1006 数据格式不正确
998 添加失败
+++
## 添加户型委托书协议
+++
post:Api/Housing/entrust//token/用户token
*property_name=物业名称 #
*property_position=物业位置 #
*area=面积 #
*term=合同有效期 【格式为2017-07-04/2017-08-04】 #
*commission=佣金 #
*autograph=签名 【签名为一张图片，所有调用上传图片接口。获取图片上传接口返回的图片地址】 #
*trustee=乙方【受托方】 #
<<<
success
返回参数说明：
{
"data": {
"$id": "58d0d2c0b15c80202d00002a" //委托书ID。
},
"info": "签署成功。",
"code": 1000,
"state": 1
}
<<<
error
{
"data": "",
"info": "请输入正确的合同有效期",
"code": 1006,
"state": 2
}
可能返回的错误：
代号 错误
1006 数据格式不正确
998 添加数据失败
+++
## 搜索大厦
>注意：价格最高最低不是以大厦为准，而是以大厦内的户型为准备.比如：大厦的价格是59，而该大厦里面有个户型价格为40，搜索条件最高价格为45.大厦价格为59的一样搜索出来。因为该大厦内实际户型最低价格为40。反之该大厦设置的价格为59，实际大厦内的户型最低100.搜索最高价格70，该大厦也是搜索不出来
总的来说就是价格和面积是以大厦内的户型为准。
+++
Api/Housing/search
keyword=搜索关键字 【主要：当输入搜索关键字的时候，别的参数将无效】#
region=区域ID 默认为深圳#
start=从多少条开始查询 # //用于分页
length=查询条数 默认20条 # //用于分页
priceSort=价格排序 # 0为智能排序 1为价格从低到高，2为价格从高到第
lat=经度 #
lng=纬度 #
radius= 查询范围 如：1公里=1000，3公里等于3000 #
priceLow=最低价格 #
priceHigh=最高价格 #
areaLow=最小面积 #
areaHigh=最大面积 #
district=行政区ID #
street=街道ID #
metro_site=地铁站点ID #
<<<
success
{
"data": [
{
"_id": {
"$id": "58bcc8ba30fc0fd7e85f3df0"
},
"phone": "15507898841",
"name": "软件产业基地",
"lease_price_company": "元/m²/月",
"file": "shenFengZheng/2017030610223914887669596999.jpg",
"city": "韩国区",
"district": "福田区",
"roomNum": 0
}
],
"info": "查询成功",
"code": 1000,
"state": 1
}
<<<
error
说明：没有查找到房源的时候。将推介5套房源。前期房源不多的情况下推介的房源为升序。以后房源多的情况下可以设计别的条件
{
"data": [
{
"_id": {
"$id": "58bcc8b030fc0fd7e85f3dec"
},
"phone": "15507898841",
"name": "软件产业基地",
"lease_price_company": "元/m²/月",
"file": [ "shenFengZheng/2017030610223914887669596999.jpg",
"shenFengZheng/2017030610224414887669643478.jpg"
],
"city": "韩国区",
"district": "福田区",
"roomNum": 0
}
],
"info": "未找到合适的房源",
"code": 1030,
"state": 2
}
可能返回的错误：这个不算错误。只是未找到数据
代号 错误
1030 未找到合适的房源
+++
## 大厦详情
> 说明：如果大厦有“priceLow，priceHigh，areaLow，areaHigh”这四个，需要传到该接口。主要用于取出符合价格与面积的户型的数量
大厦详情没有户型列表，需要前端在加载详情的时候通过大厦ID和栋座ID去获取
+++
Api/Housing/getSourceDetails
*source_id=盘源ID #
priceLow=最低价格 #
priceHigh=最高价格 #
areaLow=最小面积 #
areaHigh=最大面积 #
<<<
success
{
"data": {
"_id": {
"$id": "58bcc8b030fc0fd7e85f3dec"
},
"name": "软件产业基地", //盘源名称
"phone": "15507898841", //咨询热线
"street_id": "3", //街道ID
"lease_price": "58", //出租价格
"lease_price_company": "元/m²/月", //出租价格单位名称
"sell_price": "555", //出售价格
"sell_price_company": "元/月", //出租价格单位名称
"file": [ //展示图
"shenFengZheng/2017030610223914887669596999.jpg",
"shenFengZheng/2017030610224414887669643478.jpg"
],
"total_area": "1200", //总建筑面积
"average_area": "300", //每层面积
"renovation_id": "精装", //renovation_id
"building_num": "12", //栋座数量
"floor_height": "3.8", //平均每层高度
"elevator_num": "11", //电梯数量
"greening_rate": "12", //绿化率
"label": [ //特色标签
"产业特色"
],
"property_name": "软件产业基地物业部", //项目名称
"property_fee": "50", //物业费
"property_fee_company": "元/月", //物业费价格单位名称
"parking_num": "300", //车位数量
"project_name": "软件产业基地", //项目名称
"developers": "软件产业基地开发商", //开发商
"developers_briefing": "软件产业基地简介\r\n", //开发商简介
"property_term": "70", //产权期限
"address": "深圳市南山区", //地址
"map_lng": "113.929515", //百度地图经度
"map_lat": "22.567346", //百度地图纬度
"Building": [ //栋座
{
"building_code": "1A", //栋座名称
"_id": "58bcc873a81e5a6f066acff314887671268520" //栋座id
},
{
"building_code": "2B",
"_id": "58bcc873a81e5a6f066acff314887671895189"
}
],
"roomNum": 13 //符合要求的户型数量
},
"info": "获取成功",
"code": 1000,
"state": 1
}
<<<
error
{
"data": "",
"info": "大厦ID不可为空", //错误原因说明
"code": 997, //错误代码
"state": 2 //状态
}
可能返回的错误：
代号 错误
997 大厦ID不可为空
998 未找到该大厦
+++
## 盘源下的户型列表
> 说明：如果盘源有“priceLow，priceHigh，areaLow，areaHigh”这四个，需要传到该接口。主要用于取出符合价格与面积的户型的数量
> 搜索出来的房源都是要通过后台认证的。“状态state为1的户型”
+++
Api/Housing/getRoomList
*building_id= 栋座ID #
*source_id=盘源ID #
start=当前页数（从0开始算，默认为0） #
length=没有数量【默认为20】 #
priceLow=最低价格 #
priceHigh=最高价格 #
areaLow=最小面积 #
areaHigh=最大面积 #
<<<
success
{
"data": [
{
"_id": {
"$id": "58bcca1b30fc0fd7e85f3e23"
},
"area": 300,
"price": 58,
"room_price_id": "元/m²/月",
"first": [ "shenFengZheng/2017030610294214887673823174.jpg",
"shenFengZheng/2017030610294414887673847781.jpg"
]
},
{
"_id": {
"$id": "58bce03e30fc0fd7e85f40c9"
},
"area": 300,
"price": 58,
"room_price_id": "元/m²/月",
"first": [
"shenFengZheng/2017030610294214887673823174.jpg",
"shenFengZheng/2017030610294414887673847781.jpg"
]
}
],
"info": "查询成功",
"state": 1
}
<<<
error
{
"data": "",
"info": "没有合适的户型", //错误原因说明
"code": 996, //错误代码
"state": 2 //状态
}
可能返回的错误：
代号 错误
996 大厦ID不可为空
997 大厦或栋座ID不可为空
+++
## 获取户型详情
+++
Api/Housing/getRoomDetails
*room_id=户型ID #
<<<
success
{
"data": [{
"_id": {
"$id": "58ac3abd9b94e8ff355d624b"
},
"room_title": "55",
"floor": "1",
"doorplate": "555",
"type": "1",
"area": 555,
"price": 555,
"room_price_id": "元/m²/月",
"renovation_id": "毛坯",
"action": [
"办公",
"孵化",
"科研"
],
"ground_type_id": "元/m²/年",
"ground_type_bet": "0",
"ground_type_pay": "1",
"payment_type": "555",
"payment_type_company": "2",
"vacant": "1",
"vacant_time": "3",
"matching": [
"办公桌",
"办公椅",
"会议桌"
],
"contain_expenses": [
"取暖费",
"车位费"
],
"property": "5555",
"con_name": "555",
"evaluate": "555",
"room_id": "58ac1cf5b15c806c0b00002914876810555939"
}],
"info": "查询成功",
"code": 1000,
"state": 1
}
<<<
error
{
"data": "",
"info": "户型ID不可为空", //错误原因说明
"code": 997, //错误代码
"state": 2 //状态
}
可能返回的错误：
代号 错误
996 为找到该户型
997 户型ID不可为空或有误
+++
## 添加收藏房源
>说明：（该说明只针对后台）考虑到性能问题，收藏房户型保存在两个地方。分别是户型详情和收藏表。原因：如果只保存在收藏表里面，用户在访问户型详情的时候每次都要到收藏表检查该用户是否收藏了该户型，这样会耗费性能。如果只保存在户型详情表里面，用户查看“我的收藏户型”的时候将要搜索所有户型，性能不好。所有使用保存在两个地方的方法
+++
Api/Housing/collection/token/用户token
*room_id=户型ID #
<<<
success
{
"data": "",
"info": "收藏成功。",
"code": 1000,
"state": 1
}
<<<
error
{
"data": "",
"info": "用户ID与户型ID不可为空。",
"code": 997,
"state": 2
}
可能返回的错误：
代号 错误
997 用户ID与户型ID不可为空,或有误
996 未找到该户型
1031 该户型已收藏，不能重复收藏。
+++
## 取消收藏房源
>说明：（该说明给后台看的，测试和前端就别揪了。没你们的事）因为添加收藏的时候，添加在两个地方，取消收藏的时候也是删除两个地方
+++
Api/Housing/cancelCollection/token/用户token
*room_id=户型ID #
<<<
success
{
"data": "",
"info": "取消收藏成功。",
"code": 1000,
"state": 1
}
<<<
error
{
"data": "",
"info": "未找到该户型。",
"code": 996,
"state": 2
}
可能返回的错误：
代号 错误
996 用户ID与户型ID不可为空,或有误
997 未找到该户型
+++
## 获取用户户型列表
+++
Api/Housing/getUserRoom/token/用户token
priceLow=最低价格 #
priceHigh=最高价格 #
areaLow=最小面积 #
areaHigh=最大面积 #
is_lease= 是否已出租 1为是 0为否 #
state= 是否已认证 0为否 1为是#
<<<
success
{
"data": [
{
"_id": {
"$id": "58d0dc82b15c80202d00002b"
},
"is_authentication": "2", //是否是认证户型，1为是 2为否
"room_title": "阿萨德大所大所多", //户型标题
"area": 99, //户型面积
"is_lease": 0, //是否已出租 1为是 0为否
"price": 22, //价格
"room_price_id": " 222", //价格单位（考虑到服务器性能，价格单位需要先获取所有单位循环查找出对应的价格单位）
"first": "222", //户型图片
"state": 0 //状态 只有认证户型才需要状态 0为待审核 1为审核通过 2为审核不通过
},
{
"_id": {
"$id": "58d0dc95b15c80202d00002c"
},
"is_authentication": "1",
"room_title": "阿萨德大所大所多",
"floor": "2",
"area": 99,
"is_lease": 0,
"price": 22,
"room_price_id": " 222",
"first": "222",
"state": 0
}
],
"info": "查询成功。",
"code": 1000,
"state": 1
}
<<<
error
{
"data": "",
"info": "您还未登录",
"code": 999,
"state": 2
}
可能返回的错误：
代号 错误
996 无房源
997 户型ID不可为空或有误
1024 用户ID与户型ID不一致
+++
## 获取用户上传的户型详情
+++
Api/Housing/showUserRoomDateils/token/用户token
*id= 户型ID#
<<<
success
{
"data": {
"_id": {
"$id": "58bcca5530fc0fd7e85f3e3a"
},
"source_id": "58bcc8b030fc0fd7e85f3dec",
"source_name": "软件产业基地",
"room_title": "软件产业基地户型",
"building_id": "58bcc873a81e5a6f066acff314887671268520",
"floor": "6",
"doorplate": "1314",
"type": "1",
"area": 300,
"price": 58,
"room_price_id": "58a3c720a81e5a701b13ee8d",
"renovation_id": "58a3c97fa81e5a0e1f13ee8d",
"action": [
"58a3ce8ca81e5aa22013ee8d",
"58a3ce94a81e5ac82313ee8d",
"58a3ce9da81e5acb2313ee8d"
],
"ground_type_id": "58a3c956a81e5afe1d13ee8e",
"ground_type_bet": "2",
"ground_type_pay": "6",
"payment_type": "222",
"payment_type_company": "2",
"vacant": "0",
"vacant_time": "1",
"matching": [
"58a3c99ea81e5a8c1f13ee8d",
"58a3c9a6a81e5a561f13ee8d"
],
"contain_expenses": [
"58a3c9d7a81e5a481f13ee8d",
"58a3c9e0a81e5a8c1f13ee8e"
],
"property": "滴滴滴滴",
"con_name": "滴滴滴滴",
"con_tel": "1212323121",
"evaluate": "滴滴滴滴",
"toomImg": [
"shenFengZheng/2017030610292814887673683866.jpg",
"shenFengZheng/2017030610293114887673719382.jpg",
"shenFengZheng/2017030610293614887673763948.jpg"
],
"first": [
"shenFengZheng/2017030610294214887673823174.jpg",
"shenFengZheng/2017030610294414887673847781.jpg"
],
"building_name": "1A"
},
"info": "查询成功",
"code": 1000,
"state": 1
}
<<<
error
{
"data": "",
"info": "您还未登录",
"code": 999,
"state": 2
}
可能返回的错误：
代号 错误
999 您还未登录
1024 用户ID与户型ID不一致
+++
## 修改户型信息
+++
Api/Housing/updateUserRoom/token/用户token
*_id= 户型ID#
is_authentication=是否认证 1为认证，2为不认证【需要认证的话需要携带户型委托书ID】 默认为2#
*source_id= 盘源ID#
*building_id= 栋座ID#
*room_title= 户型标题#
*floor= 楼层#
*doorplate= 门牌号#
type= 认证方式 3为经纪人认证的房源。4为经纪人独家代理的房源 5为用户私房源 默认为5#
*area= 面积#
*price= 价格#
*room_price_id= 价格单位#
*renovation_id= 装修类型#
action= 空间匹配【数组形式】#
*ground_type_bet= 付款方式（押）#
*ground_type_pay= 付款方式（付）#
payment_type= 佣金#
matching= 空间配套【数组形式】#
*property_fee=物业费#
*conditioner_fee=空调费#
*other_fee=其他费#
*toomImg= 户型图【数组形式】#
entrust_id= 委托书ID【需要认证的户型，委托书ID不可为空】 #
<<<
success
{
"data": "",
"info": "修改成功。",
"code": 1000,
"state": 1
}
<<<
error
{
"data": "",
"info": "您还未登录",
"code": 999,
"state": 2
}
可能返回的错误：
代号 错误
999 您还未登录
998 修改失败
1001 数据格式不正确
+++
## 获取业主电话
+++
Api/Housing/getOwnerTel/token/用户token
*room_id= 户型ID#
<<<
success
{
"data": "8617190329274",
"info": "获取电话成功",
"code": 1000,
"state": 1
}
<<<
error
{
"data": "",
"info": "获取电话失败",
"code": 1022,
"state": 2
}
可能返回的错误：
代号 错误
999 您还未登录
997 户型ID不可为空或有误
996 未找到户型电话号码
1001 用户号码出错。请联系客服处理。
1022 获取电话失败
+++
## 解除米糠云小号绑定（给后台使用的。前端和测试不用管）
+++
Api/Housing/getRoomList
<<<
success
+++
