[TOC]
## 房源列表
~~~[api]
get:/house_info
<<<
success
{
"code": 0,
"data": {
"data": [
{
"id": 1,
"h_video": "",//视频地址
"h_img": [],//图片 json 格式
"r_mode": 0,//出租方式 0 短租合租 1 短租整租 2 长租整租 3 长租合租 4 长短合租 5 长短整租
"h_name": "龙湖时代天街",//房源名
"h_metro": 4,//地铁线路
"h_site": "中坝",//地铁站点
"h_area": 50,//房源面积
"h_type": "五室四厅四卫",//户型
"h_floor": "18楼/18层",//楼层
"h_facilities": [//配套设施
{
}
],
"h_l_rent": 50000,//长租租金
"h_s_rent": null,//短租租金 (设计没有，备用)
"h_l_p_n": "押三付一",//长租支付方式
"h_s_p_m": [//短租支付方式
{
"rent":10,//租金
"deposit":10,//押金
"day":3//天数
}
],
"create_time": "2017-11-15 09:31:07",//完善时间
"audit": 0,//审核状态 0 待提交审核 1 提交审核中 2 审核通过 3 审核被拒
"status": 0,//状态 0 未上架 1 已上架 2 已出租 3 已退房
"room": 0//可租房间数量
}
],
"currentPage": 1,//当前页
"pageNumber": 10,//页码
"count": 1//总条数
}
}
<<<
error
~~~
## 房源分页
~~~[api]
get:/house_info/pag
*int:currentPage=1#当前页
*int:pageNumber=10#页码
<<<
success
{
"code": 0,
"data": {
"data": [
{
"id": 1,
"h_video": "",//视频地址
"h_img": [],//图片 json 格式
"r_mode": 0,//出租方式 0 短租合租 1 短租整租 2 长租整租 3 长租合租 4 长短合租 5 长短整租
"h_name": "龙湖时代天街",//房源名
"h_metro": 4,//地铁线路
"h_site": "中坝",//地铁站点
"h_area": 50,//房源面积
"h_type": "五室四厅四卫",//户型
"h_floor": "18楼/18层",//楼层
"h_facilities": [//配套设施
{
}
],
"h_l_rent": 50000,//长租租金
"h_s_rent": null,//短租租金 (设计没有，备用)
"h_l_p_n": "押三付一",//长租支付方式
"h_s_p_m": [//短租支付方式
{
"rent":10,//租金
"deposit":10,//押金
"day":3//天数
}
],
"create_time": "2017-11-15 09:31:07",//完善时间
"audit": 0,//审核状态 0 待提交审核 1 提交审核中 2 审核通过 3 审核被拒
"status": 0,//状态 0 未上架 1 已上架 2 已出租 3 已退房
"room": 0//可租房间数量
}
]
}
}
<<<
error
{
"code": -1,
"msg": "参数错误!"
}
~~~
## 房源修改查询
~~~[api]
get:/house_info/edit
*int:id=1#房源列表 id
<<<
success
{
"code": 0,
"data": {
"data": {
"id": 1,
"h_video": "",
"h_img": [],
"r_mode": 4,
"h_name": "龙城高新天地",
"province_id": 1,
"h_province": "四川省",
"city_id": 1,
"h_city": "成都市",
"county_id": 1,
"h_county": "青羊区",
"landmark_id": 1,
"h_landmark": "内光华",
"community_id": 1,
"h_community": "光华中心",
"h_unit": "8栋8单元8号",
"metro_id": 1,
"h_metro": 4,
"site_id": 1,
"h_site": "中坝",
"h_type": "一室零厅零卫",
"h_floor": "8楼/8层",
"h_fitment": "豪华装修",
"h_sex": 1,
"h_swap": 1,
"h_contract": 1,
"h_is_d_b": 0,
"h_area": 34,
"h_facilities": [
{
"id": 2,
"name": "洗衣机"
}
],
"h_l_rent": 120000,
"h_s_rent": null,
"h_l_p_m": 1,
"h_l_p_n": "押二付一",
"h_s_p_m": [
{
"day": 0,
"rent": 15000,
"deposit": 80000
}
],
"other": "Ft",
"source": 2,
"status": 1,
"h_toward": "",
"guard": [],
"h_is_look": 0
}
}
}
<<<
error
{
"code": -1,
"msg": "参数错误!"
}
~~~
## 房源修改保存(初步完善房源信息)
* 请求地址: `/house_info/update`
* 请求方式: post
* 请求参数:
| 字段名 | 字段类型 | 字段长度 | 必填 | 字段说明 |
| --- | --- | --- | --- | --- |
| `id` | int | 11 | `是` | id |
| `h_video` | string | 2-160 | 是(选填) | 视频地址 |
| `h_img` | json | 0 | 是(选填) | 房源图片 |
| `r_mode` | int | 1-6 | `是` | 出租方式 |
| `h_name` | string | 2-64 | `是` | 房源名 |
| `province_id` | int | 11 | `是` | `是` | `是` | 省id |
| `h_province` | string | 2-16 | `是` | `是` | 省名 |
| `city_id` | int | 11 | `是` | 市id |
| `h_city` | string | 2-16 | `是` | 市名 |
| `county_id` | int | 11 | `是` | 区id |
| `h_county` | string | 2-16 | `是` | 区名 |
| `landmark_id` | int | 11 | `是` | 地标id |
| `h_landmark` | string | 2-32 | `是` | 地标名 |
| `community_id` | int | 11 | `是` | 小区id |
| `h_community` | string | 2-32 | `是` | 小区名 |
| `h_unit` | string | 2-32 | 是(选填) | 所在单元 |
| `metro_id` | int | 11 | 是(选填) | 地铁线路id |
| `h_metro` | int | 11 | 是(选填) | 地铁线路名 |
| `site_id` | int | 11 | 是(选填) | 地铁站点id |
| `h_site` | string | 2-16 | 是(选填) | 地铁站点名 |
| `h_type` | string | 2-16 | `是` | 户型 |
| `h_floor` | string | 2-16 | 是(选填) | 楼层 |
| `h_fitment` | string | 2-16 | `是` | 装修 |
| `h_sex` | int | 1-3 | `是` | 性别限制 |
| `h_swap` | int | 0/1 | `是` | 是否可调换 |
| `h_is_d_b` | int | 0/1 | `是` | 是否需要门禁 |
| `h_area` | int | 11 | `是` | 房源面积 |
| `h_facilities` | json | 0 | `是` | 配套设施 |
| `h_l_rent` | bigint | 20 | 是(选填) | 长租租金 |
| `h_s_rent` | bingint | 20 | 是(选填) | 短租租金 |
| `h_l_p_m` | int | 11 | 是(选填) | 长租支付方式 |
| `h_l_p_n` | string | 2-16 | 是(选填) |长租支付方式名 |
| `h_s_p_m` | json | 0 | 是(选填) | 短租支付方式 |
| `other` | string | 0-255 | 是(选填) | 其他说明 |
| `h_toward` | string | 16 | 是(选填) | 朝向 |
| `guard` | json | 0 | 否 | 门禁人员资料 |
>[info] 请根据前端的实际情况选择填写字段
> 其中 是(选填) 字段可以为空 需要填才填写
* 成功返回:
```json
{
"code": 0
}
```
* 失败返回:
```json
{
"code": -1,
"msg": "参数错误!"
}
```
## 第二步完善房源信息查询
~~~[api]
get:/house_info/read
*int:id=1#列表的 id
<<<
success
{
"code": 0,
"data": {
"id": 1,
"h_p_c_id": null,//物业公司id
"h_p_id": null,//物业人员id
"is_empower": 0,//是否授权开门 0 已授权 1 不授权
"commission": 0,//人员佣金
"property_company": null,//物业公司名
"property": null//物业人员名
}
}
~~~
## 完善物业提交审核
~~~[api]
post:/house_info/property
*int:id=1#列表的 id
*int:h_p_c_id=1#物业公司 id
int:h_p_id=0#物业人员 id
*int:is_empower=1#是否授权开门 0 已授权 1 未授权
*int:commission=1#人员佣金
<<<
success
{
"code": 0
}
<<<
error
{
"code": -1,
"msg": "参数错误!"
}
~~~
## 获取文件上传地址
>[info] 提交地址为返回参数中的host
>[danger] 注：上传方式 需要使用表单 `FormData` 格式上传
>注：返回的上传参数中若有key，必须使用返回的key，如果没有，就需要使用返回的 `dir+/filename` 的格式拼接文件名
>注：`filename` 是自己定义的文件名
>注： file字段**必须在最后**，类型根据平台不同而不同，兼容 `FormData`即可
>注：上传成功之后会返回一个xml格式的文件，请解析xml文件 。
>注：取出xml文件的 location 当做图片或者视频地址 提交到服务器
>注：上传图片请自定义文件名
>
~~~[api]
get:/house_info/getUpdatePath
*int:id=1#列表的 id
<<<
上传案例
{
"OSSAccessKeyId": "oss_id",
"policy": "policy",
"Signature": "signature",
"key":"key",
"success_action_status":"201",
"file":"raw file data"
}
success
{
"video": {//视频上传地址
"oss_id": "",//ossid
"host": "",//上传地址
"policy": "",//上传需要的 参数
"signature": "",//上传需要的 参数
"expire": 0,//上传时间限制
"dir": "",//上传文件目录名
"max_size": ,//上传文件大小限制
"key": ""//上传文件的文件名
},
"img": {
"oss_id": "",
"host": "",
"policy": "",
"signature": "",//上传需要的 参数
"expire": 0,
"dir": "",
"max_size": 0
}
}
<<<
error
{
"code": -1,
"msg": "参数错误!"
}
~~~
- 使用说明
- 后台管理
- 后台--登录注册
- 后台--共用数据
- 后台--个人相关
- 后台--管理相关
- 后台--管理角色
- 后台--常见问题
- 后台--生活缴费
- 后台--缴费订单
- 后台--面积区间
- 后台--租金区间
- 后台--户型管理
- 后台--配套设施
- 后台--长租周期
- 后台--短租周期
- 后台--支付方式
- 后台--banner
- 后台--区域管理
- 后台--省
- 后台--市
- 后台--区
- 后台--地标
- 后台--地铁线路
- 后台--地铁站点
- 后台--小区管理
- 后台--门店相关
- 后台--内部门店
- 后台--内部提现
- 后台--外部提现
- 后台--处理提现
- 后台--第三方门店
- 后台--物业相关
- 后台--物业公司
- 后台--物业人员
- 后台--物业申请提现
- 后台--物业奖励设置
- 后台--物业奖励金
- 后台--销售相关
- 后台--内部销售
- 后台--第三方销售
- 后台--配置相关
- 后台--配置信息
- 后台--销售提成
- 后台--前端相关
- 后台--前端用户
- 后台--用户提现
- 后台--申请看房
- 后台--租房订单
- 后台--站内信
- 后台--房源相关
- 后台--房源委托
- 后台--房源信息
- 后台--房源统计
- 后台--电子锁
- 后台--财务管理
- 后台--操作记录
- 后台--内部店长
- 内部--登录注册
- 内部--门店相关
- 内部--销售相关
- 内部--提现相关
- 后台--三方店长
- 三方--登录注册
- 三方--门店相关
- 三方--销售相关
- 三方--提现相关
- 前端--用户相关
- 用户--登录注册
- 用户--共用数据
- 用户--用户相关
- 用户--配置信息
- 用户--常见问题
- 用户--站内信
- 用户--资金相关
- 用户--充值缴费
- 用户--生活缴费
- 用户--房源相关
- 用户--房源委托
- 用户--房源信息
- 用户--房源收藏
- 用户--浏览记录
- 用户--订单相关
- 用户--我的订单
- 用户--短租下单
- 用户--长租下单
- 用户--开门相关
- 用户--物业开门
- 用户--扫码开门
- 前端--销售相关
- 销售--登录注册
- 销售--共用数据
- 销售--用户相关
- 销售--小区相关
- 销售--物业相关
- 销售--物业人员
- 销售--物业公司
- 销售--房源相关
- 销售--房源委托
- 销售--我的任务
- 销售--房源信息
- 销售--房源合同
- 销售--房间相关
- 销售--电子锁
- 销售--委托三方
- 销售--站内信
- 前端--物业相关
- 物业--登录注册
- 物业--共用数据
- 物业--用户相关
- 物业--站内信
- 物业--资金相关
- 物业--房源委托
- 物业--用户开门
- 前端--三方销售
- 三销--登录注册
- 三销--共用数据
- 三销--用户相关
- 三销--小区相关
- 三销--我的任务
- 三销--站内信
- 三销--房源相关