房間信息 · 超神宿銷售端接口使用說明

[TOC] ## 檢查是否完善過房間 * 請求地址： `/room/read` * 請求方式： get * 請求參數： | 字段名 | 字段類型 | 字段長度 | 必填 | 字段說明 | | --- | --- | --- | --- | --- | | `id` | int | 11 | `是` | 房源id | * 成功返回： >[info] 沒有房間返回 ```json { "code": 0, "data": { "data": [] } } ``` >[info] 有房間返回 ```json { "code": 0, "data": { "data": [ { "id": 1, "r_name": "房間名",//房間名 "r_area": 20,//房間面積 "h_l_rent": null,//長租租金 "h_s_rent": null,//短租租金(設計沒有，暫不使用) "h_l_p_m": null,//長租支付方式 "h_l_p_n": null,//長租支付方式名 "h_s_p_m": [//短租支付方式 { "rent":10,//租金 "deposit":10,//押金 "day":3//天數 } ], "h_facilities": [//配套設施 { } ], "h_toward": "向西",//房間朝向 "h_fitment": "毛坯",//房間裝修 "h_sex": 2//性別限制 0 女 1 男 2 不限 } ] } } ``` * 失敗返回：其他錯誤信息 ## 新增房間 * 請求地址: `/room/save` * 請求方式: post * 請求參數: | 字段名 | 字段類型 | 字段長度 | 必填 | 字段說明 | | --- | --- | --- | --- | --- | | `r_name` | string | 2-64 | `是` | 房間名 | | `h_i_id` | int | 18 | `是` | 房源id | | `r_area` | int | 11 | `是` | 房間面積 | | `h_facilities` | json | 0 | `是` | 房間設施 | | `h_toward` | string | 2-16 | `是` | 房間朝向 | | `h_l_p_m` | int | 11 | 是 | 長租支付方式 | | `h_l_p_n` | string | 2-16 | 是 | 長租支付方式名 | | `h_s_p_m` | json | 0 | 是 | 短租支付方式 | | `h_l_rent` | int | 20 | 是 | 長租租金(單位·分) | | `h_s_rent` | int | 20 | 是 | 短租租金(單位·分) | | `h_fitment` | string | 2-16 | 房間裝修 | | `h_sex` | int | 0,1,2 | 是 | 0 女 1 男 2 不限 | | `is_all_pay` | int | 11 | 否 | 是否全付 | >[info] 由于出租方式不同有些字段填的是請根據不同的情況傳不同的參數 > 是否全付在長租里面自行判斷填寫 0 全付 1 不全付 * 成功返回: ```json { "code": 0 } ``` * 失敗返回: ```json { "code": -1, "msg": "參數錯誤!" } ``` ## 修改房間信息 * 請求地址: `/room/update` * 請求方式: post * 請求參數: | 字段名 | 字段類型 | 字段長度 | 必填 | 字段說明 | | --- | --- | --- | --- | --- | | `id` | int | 11 | `是` | id | | `r_name` | string | 2-64 | `是` | 房間名 | | `r_area` | int | 11 | `是` | 房間面積 | | `h_facilities` | json | 0 | `是` | 房間設施 | | `h_toward` | string | 2-16 | `是` | 房間朝向 | | `h_l_p_m` | int | 11 | 是 | 長租支付方式 | | `h_l_p_n` | string | 2-16 | 是 | 長租支付方式名 | | `h_s_p_m` | json | 0 | 是 | 短租支付方式 | | `h_l_rent` | int | 20 | 是 | 長租租金(單位·分) | | `h_s_rent` | int | 20 | 是 | 短租租金(單位·分) | | `h_fitment` | string | 2-16 | 房間裝修 | | `h_sex` | int | 0,1,2 | 是 | 0 女 1 男 2 不限 | | `is_all_pay` | int | 11 | 否 | 是否全付 | >[info] 由于出租方式不同有些字段填的是請根據不同的情況傳不同的參數 > 是否全付在長租里面自行判斷填寫 0 全付 1 不全付 * 成功返回: ```json { "code": 0 } ``` * 失敗返回: ```json { "code": -1, "msg": "參數錯誤!" } ``` ## 房間信息修改查詢 * 請求地址: `/room/edit` * 請求方式: get * 請求參數: | 字段名 | 字段類型 | 字段長度 | 必填 | 字段說明 | | --- | --- | --- | --- | --- | | `id` | int | 11 | `是` | 房間id | * 成功返回: ```json { "code": 0, "data": { "data": { "id": 1, "r_name": "房間名",//房間名 "r_area": 20,//房間面積 "h_l_rent": null,//長租租金 "h_s_rent": null,//短租租金(設計沒有，暫不使用) "h_l_p_m": null,//長租支付方式 "h_l_p_n": null,//長租支付方式名 "h_s_p_m": [//短租支付方式 { "rent":10,//租金 "deposit":10,//押金 "day":3//天數 } ], "h_facilities": [//配套設施 { } ], "h_toward": "向西",//房間朝向 "h_fitment": "毛坯",//房間裝修 "h_sex": 2//性別限制 0 女 1 男 2 不限 } } } ``` * 失敗返回: ```json { "code": -1, "msg": "參數錯誤!" } ``` ## 刪除房間 * 請求地址: `/room/delete` * 請求方式: post * 請求參數: | 字段名 | 字段類型 | 字段長度 | 必填 | 字段說明 | | --- | --- | --- | --- | --- | | `id` | int | 11 | `是` | id | * 成功返回: ```json { "code": 0 } ``` * 失敗返回: ```json { "code": -1, "msg": "參數錯誤!" } ```