## 添加戶型時搜索大廈得出的列表【選擇大廈頁面】
+++
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": "元/m2/月",
"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": "元/m2/月",
"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": "元/m2/月", //出租價格單位名稱
"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": "元/m2/月",
"first": [ "shenFengZheng/2017030610294214887673823174.jpg",
"shenFengZheng/2017030610294414887673847781.jpg"
]
},
{
"_id": {
"$id": "58bce03e30fc0fd7e85f40c9"
},
"area": 300,
"price": 58,
"room_price_id": "元/m2/月",
"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": "元/m2/月",
"renovation_id": "毛坯",
"action": [
"辦公",
"孵化",
"科研"
],
"ground_type_id": "元/m2/年",
"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
+++
