[TOC]
## 任务列表
* 请求地址： `/task`
* 请求方式： get
* 请求参数： 无
* 成功返回：
```json
{
"code": 0,
"data": {
"data": [
{
"id": 1,
"into_time": "2017-12-12 00:00:00",//入住时间
"out_time": "2017-12-21 00:00:00",//到期时间
"create_time": "2017-11-30 17:55:38",//下单时间
"mode": 0,//租住方式 0 短租合租 1 短租整租 2 长租合租 3 长租整租
"status": 1,//订单状态 0 未支付 1 已支付 2 已退款 3 待入住 4 已入住 5 申请退房 6 已退房 7 已逾期 9 订单已取消
"h_name": "树海",//房源名
"h_community": "光华中心",//小区名
"h_l_rent": null,//长租租金
"h_s_rent": null,//短租租金
"h_s_p_m": null,//短租支付方式
"r_name": "厕所",//房间名
"r_l_rent": 100,//长租租金
"r_s_rent": null,//短租租金
"r_s_p_m": [//短租支付方式
{
"day": 10,//天数
"rent": 9000,//租金
"deposit": 30000//押金
}
],
"phone": "13725554033",//用户手机号
"photo": null,//用户头像
"nickname": null//用户昵称
}
]
}
}
```
>[info] 状态不为1的房源就不允许被处理
* 失败返回： 其他错误信息
## 任务分页
* 请求地址: `/task/pag`
* 请求方式: get
* 请求参数:
| 字段名 | 字段类型 | 字段长度 | 必填 | 字段说明 |
| --- | --- | --- | --- | --- |
| `currentPage` | int | 11 | `是` | 当前页 |
| `pageNumber` | int | 11 | `是` | 页码 |
* 成功返回:
```json
{
"code": 0,
"data": {
"data": [
{
"id": 1,
"h_community": "幸福小区",//小区名
"h_unit": "九栋一单元",//所在单元
"h_rent": 300000,//期望租金 单位是 分
"create_time": "2017-11-09 19:34:00",//委托时间
"status": 2,//状态 1 审核中 2 房源通过审核 3 房源被拒绝
"l_phone": "",//房东电话
"l_name": "",//房东姓名
"admin_name": "",//委托管理姓名
"admin_phone": "",//委托管理手机号
"sale_name": null,//委托销售姓名
"sale_phone": null,//委托销售手机号
"user_name": null,//委托房东姓名
"user_phone": null,//委托房东手机号
"property_name": null,//委托物业姓名
"property_phone": null,//委托物业手机号
"source":0//来源 0 平台添加 1 用户房东添加 2 销售添加 3 物业添加 4 第三方销售添加
}
]
}
}
```
* 失败返回:
```json
{
"code": -1,
"msg": "参数错误!"
}
```
## 任务搜索(暂时还未添加功能)
* 请求地址: `/task/search`
* 请求方式: get
* 请求参数:
| 字段名 | 字段类型 | 字段长度 | 必填 | 字段说明 |
| --- | --- | --- | --- | --- |
| `search` | string | 2-200 | `是` | 搜索内容 |
* 成功返回:
```json
{
"code": 0,
"data": {
"data": [
{
"id": 1,
"h_community": "幸福小区",//小区名
"h_unit": "九栋一单元",//所在单元
"h_rent": 300000,//期望租金 单位是 分
"create_time": "2017-11-09 19:34:00",//委托时间
"status": 2,//状态 1 审核中 2 房源通过审核 3 房源被拒绝
"l_phone": "",//房东电话
"l_name": "",//房东姓名
"admin_name": "",//委托管理姓名
"admin_phone": "",//委托管理手机号
"sale_name": null,//委托销售姓名
"sale_phone": null,//委托销售手机号
"user_name": null,//委托房东姓名
"user_phone": null,//委托房东手机号
"property_name": null,//委托物业姓名
"property_phone": null//委托物业手机号
}
]
}
}
```
* 失败返回:
```json
{
"code": -1,
"msg": "参数错误!"
}
```
## 取消房源
* 请求地址: `/task/cancel`
* 请求方式: post
* 请求参数:
| 字段名 | 字段类型 | 字段长度 | 必填 | 字段说明 |
| --- | --- | --- | --- | --- |
| `id` | int | 11 | `是` | 房源id |
* 成功返回:
```json
{
"code": 0
}
```
* 失败返回:
```json
{
"code": -1,
"msg": "参数错误!"
}
```
## 完善房源
* 请求地址: `/task/perfect`
* 请求方式: post
* 请求参数:
| 字段名 | 字段类型 | 字段长度 | 必填 | 字段说明 |
| --- | --- | --- | --- | --- |
| `id` | int | 11 | 是 | 房源id |
* 成功返回:
```json
{
"code": 0,
"data": {
"data": {
"id": 3,
"h_video": null,//视频地址
"h_img": null,//房源图片 json格式
"r_mode": 1,//出租方式 0 短租合租 1 短租整租 2 长租整租 3 长租合租 4 长短合租 5 长短整租
"h_name": null,//房源名
"province_id": 1,//省id
"h_province": "四川省",//省名
"city_id": 1,//市id
"h_city": "成都市",//市名
"county_id": 1,//区id
"h_county": "青羊区",//区名
"landmark_id": 1,//地标id
"h_landmark": "鹏瑞利广场", //地标名
"community_id": 1,//小区id
"h_community": "幸福小区",//小区名
"h_unit": "九栋一单元",//单元地址
"metro_id": 1,//地铁线路id
"h_metro": 1,//地铁线路
"site_id": 1,//地铁站点id
"h_site": "中坝",//地铁站点
"h_type": "三室两厅",//户型
"h_floor": "12楼/32楼",//所在楼层
"h_fitment": "精装",//装修
"h_sex": 0, //性别限制 0 女 1 男 2 不限
"h_swap": 1,//是否可调换 0 不允许 1 允许
"h_contract": 0,// 是否完善合同 0未完善 1 已完善 (该字段用于判断,提交参数不用填写)
"h_is_d_b": 0,//是否需要门禁 0 不需要 1需要
"h_area": 30,//房源面积
"h_facilities": [//配套设施
{
}
],
"h_l_rent": null,//长租租金
"h_s_rent": null,//短租租金(设计没有，我自己添加的 备用)
"h_l_p_m": null,//长租支付方式 (需要关联支付方式的id)
"h_l_p_n":null,//长租支付名(押一付三)
"h_s_p_m": null,//短租支付方式 json 格式
"other": null,//其他信息(用于存放描述信息)
"source": 0, //来源 0 平台添加 1 用户房东添加 2 销售添加 3 物业添加 4 第三方销售添加
"status": 0,//状态 0 未上架 1 已上架 2 已出租 3 已退房(该字段用于判断显示)
"h_toward": null,//房源朝向 (设计没有 不填)
"guard": null,// 门禁人员资料 (设计没有，不填)
"h_is_look": 0// 是否完善电子锁 0 未完善 1 已完善 (或者0表示没有电子锁)
}
}
}
```
* 失败返回:
```json
{
"code": -1,
"msg": "参数错误!"
}
```
## 申请看房用户
* 请求地址: `/task/look`
* 请求方式: get
* 请求参数: 无
* 成功返回:
```json
{
"code": 0,
"data": {
"data": [
{
"id": 1,
"status": 0,//状态 0 申请看房中 1 等待物业开门 2 看房中 3 结束看房
"create_time": "2017-11-30 15:26:53",//申请时间
"mode":0,//开门方式 0 未充值 1 物业开门 2 自己开门
"h_name": "树海",//房源名
"h_type": "1室0厅0卫",//户型
"h_floor": "60楼/90层",//楼层
"h_area": 58,//面积
"h_site": "中坝",//地铁站点
"h_metro": 4,//地铁线路
"phone": "18483659413",//用户手机号
"photo": null,//用户头像
"nickname": null//用户昵称
}
],
"currentPage": 1,//当前页
"pageNumber": 10,//页码
"count": 1//总条数
}
}
```
* 失败返回:
```json
{
"code": -1,
"msg": "参数错误!"
}
```
## 申请看房分页
* 请求地址: `/task/lookPag`
* 请求方式: get
| 字段名 | 字段类型 | 字段长度 | 必填 | 字段说明 |
| --- | --- | --- | --- | --- |
| `currentPage` | int | 11 | `是` | 当前页 |
| `pageNumber` | int | 11 | `是` | 页码 |
* 请求参数: 无
* 成功返回:
```json
{
"code": 0,
"data": {
"data": [
{
"id": 1,
"status": 0,//状态 0 申请看房中 1 等待物业开门 2 看房中 3 结束看房
"create_time": "2017-11-30 15:26:53",//申请时间
"mode":0,//开门方式 0 未充值 1 物业开门 2 自己开门
"h_name": "树海",//房源名
"h_type": "1室0厅0卫",//户型
"h_floor": "60楼/90层",//楼层
"h_area": 58,//面积
"h_site": "中坝",//地铁站点
"h_metro": 4,//地铁线路
"phone": "18483659413",//用户手机号
"photo": null,//用户头像
"nickname": null//用户昵称
}
]
}
}
```
* 失败返回:
```json
{
"code": -1,
"msg": "参数错误!"
}
```
## 申请租房用户
* 请求地址: `/task/rentRoom`
* 请求方式: get
* 请求参数: 无
* 成功返回:
```json
{
"code": 0,
"data": {
"data": [
{
"id": 1,
"into_time": "2017-12-14 00:00:00",//入住时间
"out_time": "2017-12-15 00:00:00",//离开时间
"create_time": "2017-12-11 11:34:41",//下单时间
"mode": 2,//租住方式 0 短租合租 1 短租整租 2 长租合租 3 长租整租
"status": 1,//订单状态 0 未支付 1 已支付 2 已退款 3 待入住 4 已入住 5 申请退房 6 已退房 7 已逾期 9 订单已取消
"rent": 3,//下单租金
"phone": "13725554033",//用户手机号码
"photo": null,//用户头像
"nickname": null,//用户昵称
"h_name": "树海",//房源名
"h_community": "光华中心",//小区名
"h_l_rent": null,//房源长租租金
"h_s_rent": null,//房源短租租金
"h_s_p_m": [//房源短租支付方式
{
"day": 1,//天数
"rent": 1,//租金
"deposit": 1//押金
}
],
"r_name": "厕所",//房间名
"r_l_rent": null,//房间长租租金
"r_s_rent": null,//房间短租租金
"r_s_p_m": [//房间短租支付方式
{
"day": 1,//天数
"rent": 3,//租金
"deposit": 3//押金
}
]
}
],
"currentPage": 1,//当前页
"pageNumber": 10,//页码
"count": 1//总条数
}
}
```
* 失败返回:
```json
{
"code": -1,
"msg": "参数错误!"
}
```
## 申请租房分页
* 请求地址: `/task/rentRoomPag`
* 请求方式: get
| 字段名 | 字段类型 | 字段长度 | 必填 | 字段说明 |
| --- | --- | --- | --- | --- |
| `currentPage` | int | 11 | `是` | 当前页 |
| `pageNumber` | int | 11 | `是` | 页码 |
* 请求参数: 无
* 成功返回:
```json
{
"code": 0,
"data": {
"data": [
{
"id": 1,
"into_time": "2017-12-14 00:00:00",//入住时间
"out_time": "2017-12-15 00:00:00",//离开时间
"create_time": "2017-12-11 11:34:41",//下单时间
"mode": 2,//租住方式 0 短租合租 1 短租整租 2 长租合租 3 长租整租
"status": 1,//订单状态 0 未支付 1 已支付 2 已退款 3 待入住 4 已入住 5 申请退房 6 已退房 7 已逾期 9 订单已取消
"rent": 3,//下单租金
"phone": "13725554033",//用户手机号码
"photo": null,//用户头像
"nickname": null,//用户昵称
"h_name": "树海",//房源名
"h_community": "光华中心",//小区名
"h_l_rent": null,//房源长租租金
"h_s_rent": null,//房源短租租金
"h_s_p_m": [//房源短租支付方式
{
"day": 1,//天数
"rent": 1,//租金
"deposit": 1//押金
}
],
"r_name": "厕所",//房间名
"r_l_rent": null,//房间长租租金
"r_s_rent": null,//房间短租租金
"r_s_p_m": [//房间短租支付方式
{
"day": 1,//天数
"rent": 3,//租金
"deposit": 3//押金
}
]
}
]
}
}
```
* 失败返回:
```json
{
"code": -1,
"msg": "参数错误!"
}
```
## 租房详情查看
* 请求地址: `/task/orderDetail`
* 请求方式: get
* 请求参数:
| 字段名 | 字段类型 | 字段长度 | 必填 | 字段说明 |
| --- | --- | --- | --- | --- |
| `id` | int | 11 | `是` | 当前页 |
* 成功返回:
```json
{
"code": 0,
"data": {
"order": {//订单信息
"id": 1,
"h_i_id": 1,//房源id
"r_id": 3,//房间id
"into_time": "2017-12-12 00:00:00",//入住时间
"out_time": "2017-12-21 00:00:00",//离开时间
"create_time": "2017-11-30 17:55:38",//下单时间
"mode": 0,//租房方式 0 短租合租 1 短租整租 2 长租合租 3 长租整租
"status": 1,//订单状态 0 未支付 1 已支付 2 已退款 3 待入住 4 已入住 5 申请退房 6 已退房 7 已逾期 9 订单已取消
"rent":10 //租金
},
"house": {//房源信息
"id": 1,
"h_video": "",//房源视频
"h_img": [],//房源图片
"h_name": "树海",//房源名
"h_floor": "9楼/9层",//所在楼层
"h_area": 90//面积
},
"room": {//房间信息
"id": 3,
"r_name": "厕所",//房间名
"r_area": 34,//面积
"h_l_p_n": "押一付一",//长租支付方式
"h_facilities": [//配套设施
{
"id": 2,
"name": "洗衣机"
}
],
"h_toward": "南",//朝向
"h_fitment": "精装修",//装修
"h_sex": 2//性别限制 0 女 1 男 2 不限
}
}
}
```
* 失败返回:
```json
{
"code": -1,
"msg": "参数错误!"
}
```
