[TOC] ## 房源篩選 * 請求地址: `/house_info/filter` * 請求方式: get * 請求參數: | 字段名 | 字段類型 | 字段長度 | 是否必填 | 字段說明 | | --- | --- | --- | --- | --- | | mode | int | 0,1,2,3 | `是` | 租房方式 | | city | string | 2-16 | 否 | 市名 | | province | string | 2-16 | 否 | 省名 | | county | string | 2-16 | 否 | 區名 | | landmark | string | 2-16 | 否 | 地標名 | | metro | int | 11 | 否 | 地鐵線路 | | site | string | 2-16 | 否 | 地鐵站點 | | price | int | 11 | 否 | 價格區間id | | area | int | 11 | 否 | 面積區間id | | community | string | 2-16 | 否 | 小區名 | | type | string | 2-16 | 否 | 房源戶型 | | facility | string | 0 | 否 | 配套設施 | >[info] 配套設施格式 ~~~ 1,2,3 ~~~ >[danger] 里面的數字是前端選擇的配套設施里面的id >把選出的id以**英文**逗號拼接 >[info] 租房方式 0 短租合租 1 短租整租 2 長租整租 3 長租合租 > 價格區間id 傳從接口中獲取出的 價格區間的id > 面積區間id 傳從接口中獲取出的 面積區間的id > 地區可以不用傳 但是為了避免出現較多房源 最好加上地區 * 成功返回 ```json { "code": 0, "data": { "data": [ { "id": 1,//小區id "name": "光華中心",//小區名 "longitude": "103.970194",//小區經度 "latitude": "30.675829",//小區緯度 "house_num": 2//小區下可租房源 } ] } } ``` * 失敗返回: ```json { "code": -1, "msg": "參數錯誤!" } ``` ## 小區下的房源 * 請求地址: `/house_info/list` * 請求方式: get * 請求參數: | 字段名 | 字段類型 | 字段長度 | 是否必填 | 字段說明 | | --- | --- | --- | --- | --- | | mode | int | 0,1,2,3 | `是` | 租房方式 | | city | string | 2-16 | 是 | 市名 | | province | string | 2-16 | 否 | 省名 | | county | string | 2-16 | 否 | 區名 | | landmark | string | 2-16 | 否 | 地標名 | | metro | int | 11 | 否 | 地鐵線路 | | site | string | 2-16 | 否 | 地鐵站點 | | price | int | 11 | 否 | 價格區間id | | area | int | 11 | 否 | 面積區間id | | community | string | 2-16 | 否 | 小區名 | | type | string | 2-16 | 否 | 房源戶型 | | facility | json | 0 | 否 | 配套設施 | | community_id | int | 11 | 否 | 小區id | | special | int | 11 | 否 | 是否是特殊房源 | | currentPage | int | 11 | 否 | 當前頁 | | pageNumber | int | 11 | 否 | 頁碼 | >[success] 可以和篩選的參數一致提交來查詢 >[info] 租房方式 0 短租合租 1 短租整租 2 長租整租 3 長租合租 > 價格區間id 傳從接口中獲取出的 價格區間的id > 面積區間id 傳從接口中獲取出的 面積區間的id > 是否是特殊房源 special =1 就篩選特殊房源 special =0 就是普通房源 * 成功返回 ```json { "code": 0, "data": { "data": [ { "id": 1, "h_video": null,//房源視頻 "h_img": null,//房源圖片 json "r_mode": 0,//出租方式 0 短租合租 1 短租整租 2 長租整租 3 長租合租 4 長短合租 5 長短整租 "h_name": "",//房源名 "h_metro": 1,//地鐵線路 "h_site": "",//地鐵站點 "h_floor": "",//房源樓層 "h_l_rent": 1000,//長租租金 "h_s_rent": null,//短租租金 "h_s_p_m": [//短租支付方式 { "day": 1, "rent": 200,//租金 "deposit": 2000//押金 } ], "h_l_p_n": null,//長租支付方式名 "h_community": "",//小區名 "h_type": "",//戶型 "money": 60000//長租合租房源 返回房間租金 } ] } } ``` >[info] 只有長租合租才會返回 money 字段 * 失敗返回: ```json { "code": -1, "msg": "參數錯誤!" } ``` ## 房源搜索 ~~~[api] get:/house_info/search *string:search=搜索內容#房源名、小區名、戶型 *int:mode=0#0 1 2 3 *int:special=0# 0 普通房源 1 特殊房源 <<< success { "code": 0, "data": { "data": [ { "id": 1, "h_video": null,//房源視頻 "h_img": null,//房源圖片 "r_mode": 0,//出租方式 0 短租合租 1 短租整租 2 長租整租 3 長租合租 4 長短合租 5 長短整租 "h_name": "",//房源名 "h_metro": 1,//地鐵線路 "h_site": "中壩",//地鐵站點 "h_floor": "",//所在樓層 "h_l_rent": 1000,//長租租金 "h_s_rent": null,//短租租金 "h_s_p_m": [//短租支付方式 { "day": 2,//天數 "rent": 200,//租金 "deposit": 2000//押金 } ], "h_l_p_n": null,//長租支付方式名 "h_community": "",//小區名 "h_type": ""//戶型 } ] } } <<< error { "code": -1, "msg": "參數錯誤!" } ~~~ ## 房源詳情 >[danger] 若房間沒有被出租 房間信息中的sex返回值為 null ~~~[api] get:/house_info/read *int:id=1#房源 id <<< success { "code": 0, "data": { "house": { "id": 1, "h_video": "",//房源視頻地址 "h_img": [],//房源圖片 json形式 可能有多張 圖片都是自動加了水印的 "r_mode": 4,//出租方式 0 短租合租 1 短租整租 2 長租整租 3 長租合租 4 長短合租 5 長短整租 "h_name": "赫海",//房源名 "h_unit": "18棟18單元18號",//所在單元 "h_floor": "18樓/18層",//所在樓層 "h_fitment": "豪華裝修",//裝修程度 "h_area": 8,//房源面積 "h_site": "蔡橋",//地鐵站點名 "h_metro": 4,//地鐵線路名 "h_l_p_n": "押二付一",//房源出租方式 "h_type": "五室四廳四衛",//房源戶型 "h_community": "光華中心",//小區名 "h_facilities": [//配套設施 { "id": 1, "name": "洗衣機" } ], "h_sex": 0,//性別限制 0 女 1 男 2 不限 "h_l_rent": 80000,//長租租金 "h_s_rent": null,//短租租金 "h_l_p_m": 1,//長租支付方式id "h_s_p_m": [//短租支付方式 { "day": 1,//出租天數 "rent": 100,//租金 "deposit": 100//押金 } ], "status": 1,//房源狀態 "community_id": 1//所在小區id }, "room": [//房源下的房間信息 { "id": 1, "r_name": "廁所",//房間名 "r_area": 35,//房間面積 "h_l_rent": 120000,//長租租金 "h_s_rent": null,//短租租金 "h_l_p_n": "押二付一",//長租支付方式 "h_s_p_m": [],//短租支付方式 "h_facilities": [//配套設施 { "id": 1, "name": "冰箱"//配套設施名 } ], "h_toward": "東",//房間朝向 "status": 0,//房間狀態 0 可租 1 已出租 "h_fitment": "精裝修",//裝修類型 "h_sex": 0，//性別限制 0 女 1 男 2 不限 "sex": 1//租客性別 0 女 1 男 } ], "community": {//小區信息 "longitude": "103.970194",//所在經度 "latitude": "30.675829"//所在緯度 }, "sale": {//管家信息 "phone": "15181474781",//管家手機號 "name": "測試賬號1",//管家姓名 "photo": null//管家 }, "collect": 0//是否收藏過 0 沒有 1已收藏 } } <<< error { "code": -1, "msg": "參數錯誤!" } ~~~ ## 獲取可開門物業 ~~~[api] get:/house_info/property *int:id=1#房源 id int:r_id=1#房間 id <<< success // 有物業 返回 物業人員信息 { "code": 0, "data": { "property": 1,//當前可以開門的物業人員id "data": [ { "id": 1, "name": "測試賬號",//物業人員姓名 "phone": "15181474781",//手機號 "landline": "028-88888888"//座機號 } ] } } <<< success // 沒有物業 返回銷售人員 信息 { "code": 0, "data": { "data": { "name": "測試賬號",//銷售名 "phone": "15181474781"//銷售手機號 } } } <<< error { "code": -1, "msg": "參數錯誤!" } ~~~ ## 申請看房 ~~~[api] post:/house_info/look *int:id=1#房源 id int:r_id=1#房間 id <<< success //沒有電子鎖 //沒有電子鎖也沒有物業公司 //返回的內容如下：負責該房源的銷售信息 { "code": 0, "data": { "data": { "name": "測試賬號1", "phone": "15181474781" } } } <<< success //無電子鎖 //無電子鎖有物業公司 //返回的內容如下：物業人員信息 { "code": 0, "data": { "data": { "name": "",//物業人員姓名 "phone": "",//物業人員手機號 "landline": "",//物業人員座機號 "company": "",//物業人員所在物業公司 "h_community": "",//房源小區名 "h_unit": "",//房源所在單元 "h_floor": "",//房源所在樓層 "id": "1" } } } <<< success //有電子鎖 //有物業公司 //返回的內容如下：物業人員信息 { "code": 0, "data": { "data": { "name": "",//物業人員姓名 "phone": "",//物業人員手機號 "landline": "",//物業人員座機號 "company": "",//物業人員所在物業公司 "h_community": "",//房源小區名 "h_unit": "",//房源所在單元 "h_floor": "",//房源所在樓層 "id": "1 } } } <<< success //有電子鎖 //有物業公司 且物業人員 **授權開門電子鎖** 且物業人員沒有被凍結 //返回的內容如下：物業人員信息 { "code": 0, "data": { "data": { "name": "",//物業人員姓名 "phone": "",//物業人員手機號 "landline": "",//物業人員座機號 "company": "",//物業人員所在物業公司 "h_community": "",//房源小區名 "h_unit": "",//房源所在單元 "h_floor": "",//房源所在樓層 "id": "1" } } } <<< success //有電子鎖 //有物業公司 且物業人員**未被授權開門電子鎖** 或者物業人員**被凍結** //用戶的看房押金不足 //返回的內容如下：需要充值押金 { "code": 1 } <<< success //有電子鎖 //有物業公司 且物業人員**未被授權開門電子鎖** 或者物業人員**被凍結** //用戶的看房押金充足 //返回的內容如下：用戶自己掃碼看房 { "code": 0 } <<< error { "code": -1, "msg": "參數錯誤!" } ~~~ ## 跳過物業 ~~~[api] post:/house_info/jump *int:id=1#物業信息中的id <<< success //需要用戶先交押金才可以看房 { "code": 1 } <<< success //用戶可以掃碼開門 { "code": 0 } <<< error { "code": -1, "msg": "參數錯誤!" } ~~~