[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": "參數錯誤!"
}
```
## 房源搜索
* 請求地址: ` /house_info/search`
* 請求方式: get
* 請求參數:
| 字段名 | 字段類型 | 字段長度 | 是否必填 | 字段說明 |
| --- | --- | --- | --- | --- |
| search | string | 1-255 | `是` | 搜素內容(房源名、小區名、戶型) |
| mode | int | 0,1,2,3 | `是` | 租房方式 |
| special | int | 11 | 否 | 是否是特殊房源 |
>[info] 搜索內容 小區名 房源戶型
> 是否是特殊房源 special =1 就篩選特殊房源 special =0 就是普通房源
* 成功返回:
```json
{
"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": ""//戶型
}
]
}
}
```
* 失敗返回:
```json
{
"code": -1,
"msg": "參數錯誤!"
}
```
## 房源詳情
* 請求地址: `/house_info/read`
* 請求方式: get
* 請求參數:
| 字段名 | 字段類型 | 字段長度 | 是否必填 | 字段說明 |
| --- | --- | --- | --- | --- |
| `id` | int | 11 | `是` | 房源id |
* 成功返回:
```json
{
"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已收藏
}
}
```
>[danger] 若房間沒有被出租 房間信息中的sex返回值為 null
* 失敗返回:
```json
{
"code": -1,
"msg": "參數錯誤!"
}
```
## 獲取可開門物業
* 請求地址: `/house_info/property`
* 請求方式: get
* 請求參數:
| 字段名 | 字段類型 | 字段長度 | 是否必填 | 字段說明 |
| --- | --- | --- | --- | --- |
| `id` | int | 11 | `是` | 房源id |
| `r_id` | int | 11 | 否 | 房間id |
* 成功返回:
```json
{
"code": 0,
"data": {
"property": 1,//當前可以開門的物業人員id
"data": [
{
"id": 1,
"name": "測試賬號",//物業人員姓名
"phone": "15181474781",//手機號
"landline": "028-88888888"//座機號
}
]
}
}
```
>[info] 有物業的情況就會返回物業人員的列表信息
> 沒有物業人員就會返回 負責該房源的銷售信息
```json
{
"code": 0,
"data": {
"data": {
"name": "測試賬號",//銷售名
"phone": "15181474781"//銷售手機號
}
}
}
```
* 失敗返回:
```json
{
"code": -1,
"msg": "參數錯誤!"
}
```
## 申請看房
* 請求地址: `/house_info/look`
* 請求方式: post
* 請求參數:
| 字段名 | 字段類型 | 字段長度 | 是否必填 | 字段說明 |
| --- | --- | --- | --- | --- |
| `id` | int | 11 | `是` | 房源id |
| `r_id` | int | 11 | 否 | 房間id |
* 成功返回:
**第一種情況**
>[success] 無電子鎖
> 無電子鎖也沒有物業公司
> 返回的內容如下：負責該房源的銷售信息
```json
{
"code": 0,
"data": {
"data": {
"name": "測試賬號1",
"phone": "15181474781"
}
}
}
```
**第二種情況**
>[success] 無電子鎖
> 無電子鎖有物業公司
> 返回的內容如下：物業人員信息
```json
{
"code": 0,
"data": {
"data": {
"name": "",//物業人員姓名
"phone": "",//物業人員手機號
"landline": "",//物業人員座機號
"company": "",//物業人員所在物業公司
"h_community": "",//房源小區名
"h_unit": "",//房源所在單元
"h_floor": "",//房源所在樓層
"id": "1"
}
}
}
```
**第三種情況**
>[success] 有電子鎖
> 有物業公司
> 返回的內容如下：物業人員信息
```json
{
"code": 0,
"data": {
"data": {
"name": "",//物業人員姓名
"phone": "",//物業人員手機號
"landline": "",//物業人員座機號
"company": "",//物業人員所在物業公司
"h_community": "",//房源小區名
"h_unit": "",//房源所在單元
"h_floor": "",//房源所在樓層
"id": "1
}
}
}
```
**第四種情況**
>[success] 有電子鎖
> 有物業公司 且物業人員 **授權開門電子鎖** 且物業人員沒有被凍結
> 返回的內容如下：物業人員信息
```json
{
"code": 0,
"data": {
"data": {
"name": "",//物業人員姓名
"phone": "",//物業人員手機號
"landline": "",//物業人員座機號
"company": "",//物業人員所在物業公司
"h_community": "",//房源小區名
"h_unit": "",//房源所在單元
"h_floor": "",//房源所在樓層
"id": "1"
}
}
}
```
**第五種情況**
>[success] 有電子鎖
> 有物業公司 且物業人員**未被授權開門電子鎖** 或者物業人員**被凍結**
> 用戶的看房押金不足
> 返回的內容如下：需要充值押金
```json
{
"code": 1
}
```
**第六種情況**
>[success] 有電子鎖
> 有物業公司 且物業人員**未被授權開門電子鎖** 或者物業人員**被凍結**
> 用戶的看房押金充足
> 返回的內容如下：用戶自己掃碼看房
```json
{
"code": 0
}
```
* 失敗返回:
```json
{
"code": -1,
"msg": "參數錯誤!"
}
```
## 跳過物業
* 請求地址: `/house_info/jump`
* 請求方式: post
* 請求參數:
| 字段名 | 字段類型 | 字段長度 | 是否必填 | 字段說明 |
| --- | --- | --- | --- | --- |
| `id` | int | 11 | `是` | 返回物業信息中的id |
* 成功返回:
>[info] 需要用戶先交押金才可以看房
```json
{
"code": 1
}
```
>[info] 用戶可以掃碼開門
```json
{
"code": 0
}
```
* 失敗返回:
```json
{
"code": -1,
"msg": "參數錯誤!"
}
```
