>[danger] 我的任務暫時就不用了，設計圖沒有這個流程
[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": "參數錯誤!"
}
```
