Browse Source

Merge branch 'master' of https://github.com/java110/MicroCommunity

wuxw 6 years ago
parent
commit
65e7e80135

+ 81 - 0
docs/document/api/demo/queryDemoConfig.md

@@ -0,0 +1,81 @@
+
+
+**1\. DEMO查询**
+###### 接口功能
+> DEMO查询接口
+
+###### URL
+> [http://api.java110.com:8008/api/demo.queryDemoConfig](http://api.java110.com:8008/api/demo.queryDemoConfig)
+
+###### 支持格式
+> JSON
+
+###### HTTP请求方式
+> GET
+
+###### 请求参数(header部分)
+|参数名称|约束|类型|长度|描述|取值说明|
+| :-: | :-: | :-: | :-: | :-: | :-:|
+|app_id|1|String|30|应用ID|Api服务分配                      |
+|transaction_id|1|String|30|请求流水号|不能重复 1000000000+YYYYMMDDhhmmss+6位序列 |
+|sign|1|String|-|签名|请参考签名说明|
+|req_time|1|String|-|请求时间|YYYYMMDDhhmmss|
+
+###### 请求参数(url部分)
+|参数名称|约束|类型|长度|描述|取值说明|
+| :-: | :-: | :-: | :-: | :-: | :-: |
+|demoName|1|String|20|用例名称|-|
+|demoValue|1|String|20|用例值|-|
+|page|1|-|-|分页|-|
+|row|1|-|-|分页|-|
+
+###### 返回协议
+
+当http返回状态不为200 时请求处理失败 body内容为失败的原因
+
+当http返回状态为200时请求处理成功,body内容为返回内容
+
+
+
+
+###### 举例
+> 地址:[http://api.java110.com:8008/api/demo.queryDemoConfig?page=1&row=10](http://api.java110.com:8008/api/demo.queryDemoConfig?page=1&row=10)
+
+``` javascript
+请求头信息:
+Content-Type:application/json
+USER_ID:1234
+APP_ID:8000418002
+TRANSACTION_ID:10029082726
+REQ_TIME:20181113225612
+SIGN:aabdncdhdbd878sbdudn898
+请求报文:
+
+无
+
+返回报文:
+ [{
+ 	"demoId": "965000",
+ 	"demoName": "测试用例",
+ 	"demoRemark": "测试说明",
+ 	"demoValue": "测试用例值",
+ 	"page": -1,
+ 	"records": 0,
+ 	"row": 0,
+ 	"statusCd": "0",
+ 	"total": 0,
+ 	"userId": "1002"
+ },{
+ 	"demoId": "902019101816650018",
+ 	"demoName": "11",
+ 	"demoRemark": "111",
+ 	"demoValue": "222",
+ 	"page": -1,
+ 	"records": 0,
+ 	"row": 0,
+ 	"statusCd": "0",
+ 	"total": 0,
+ 	"userId": "30518940136629616640"
+ }]
+
+```

+ 63 - 0
docs/document/api/demo/saveDemoConfig.md

@@ -0,0 +1,63 @@
+
+
+**1\. DEMO新增**
+###### 接口功能
+> DEMO新增	接口
+
+###### URL
+> [http://api.java110.com:8008/api/demo.saveDemoConfig](http://api.java110.com:8008/api/demo.saveDemoConfig)
+
+###### 支持格式
+> JSON
+
+###### HTTP请求方式
+> POST
+
+###### 请求参数(header部分)
+|参数名称|约束|类型|长度|描述|取值说明|
+| :-: | :-: | :-: | :-: | :-: | :-:|
+|app_id|1|String|30|应用ID|Api服务分配|
+|transaction_id|1|String|30|请求流水号|不能重复 1000000000+YYYYMMDDhhmmss+6位序列 |
+|sign|1|String|-|签名|请参考签名说明|
+|req_time|1|String|-|请求时间|YYYYMMDDhhmmss|
+
+###### 请求参数(body部分)
+|参数名称|约束|类型|长度|描述|取值说明|
+| :-: | :-: | :-: | :-: | :-: | :-: |
+|demoName|1|String|20|用例名称|-|
+|demoValue|1|String|20|用例值|-|
+
+###### 返回协议
+
+当http返回状态不为200 时请求处理失败 body内容为失败的原因
+
+当http返回状态为200时请求处理成功,body内容为返回内容
+
+
+
+###### 举例
+> 地址:[http://api.java110.com:8008/api/demo.saveDemoConfig](http://api.java110.com:8008/api/demo.saveDemoConfig)
+
+``` javascript
+请求头信息:
+Content-Type:application/json
+USER_ID:1234
+APP_ID:8000418002
+TRANSACTION_ID:10029082726
+REQ_TIME:20181113225612
+SIGN:aabdncdhdbd878sbdudn898
+请求报文:
+
+{
+	"demoRemark": "sasa",
+	"demoName": "zcc",
+	"demoValue": "test",
+	"storeId": "402019032924930007",
+	"userId": "30518940136629616640"
+}
+
+返回报文:
+
+成功
+
+```

+ 61 - 0
docs/document/api/money/payFee.md

@@ -0,0 +1,61 @@
+
+
+**1\. 缴费**
+###### 接口功能
+> 缴费接口
+
+###### URL
+> [待补充]()
+
+###### 支持格式
+> JSON
+
+###### HTTP请求方式
+> POST
+
+###### 请求参数(header部分)
+|参数名称|约束|类型|长度|描述|取值说明|
+| :-: | :-: | :-: | :-: | :-: | :-:|
+|app_id|1|String|30|应用ID|Api服务分配|
+|transaction_id|1|String|30|请求流水号|不能重复 1000000000+YYYYMMDDhhmmss+6位序列 |
+|sign|1|String|-|签名|请参考签名说明|
+|req_time|1|String|-|请求时间|YYYYMMDDhhmmss|
+
+###### 请求参数(body部分)
+|参数名称|约束|类型|长度|描述|取值说明|
+| :-: | :-: | :-: | :-: | :-: | :-: |
+|communityId|1|String|30|小区ID|-|
+|cycles|1|String|30|周期|-|
+|receivedAmount|1|decimal|7,2|实收金额|-|
+|feeId|1|String|30|费用ID|-|
+
+###### 返回协议
+
+当http返回状态不为200 时请求处理失败 body内容为失败的原因
+
+当http返回状态为200时请求处理成功,body内容为返回内容
+
+
+
+###### 举例
+> 地址:[待补充]()
+
+``` javascript
+请求头信息:
+Content-Type:application/json
+USER_ID:1234
+APP_ID:8000418002
+TRANSACTION_ID:10029082726
+REQ_TIME:20181113225612
+SIGN:aabdncdhdbd878sbdudn898
+请求报文:
+
+{
+	待补充
+}
+
+返回报文:
+
+成功
+
+```

+ 59 - 0
docs/document/api/money/queryArrearsFee.md

@@ -0,0 +1,59 @@
+
+
+**1\. 查询欠费费用**
+###### 接口功能
+> 查询欠费费用接口
+
+###### URL
+> [待补充]()
+
+###### 支持格式
+> JSON
+
+###### HTTP请求方式
+> GET
+
+###### 请求参数(header部分)
+|参数名称|约束|类型|长度|描述|取值说明|
+| :-: | :-: | :-: | :-: | :-: | :-:|
+|app_id|1|String|30|应用ID|Api服务分配                      |
+|transaction_id|1|String|30|请求流水号|不能重复 1000000000+YYYYMMDDhhmmss+6位序列 |
+|sign|1|String|-|签名|请参考签名说明|
+|req_time|1|String|-|请求时间|YYYYMMDDhhmmss|
+
+###### 请求参数(url部分)
+|参数名称|约束|类型|长度|描述|取值说明|
+| :-: | :-: | :-: | :-: | :-: | :-: |
+|communityId|1|String|30|小区ID|-|
+|feeTypeCd|1|String|12|费用类型|物业费,停车费|
+|page|1|-|-|页数|-|
+|row|1|-|-|每页行数|-|
+
+
+
+###### 返回协议
+
+当http返回状态不为200 时请求处理失败 body内容为失败的原因
+
+当http返回状态为200时请求处理成功,body内容为返回内容,
+
+
+
+###### 举例
+> 地址:[带补充]()
+
+``` javascript
+请求头信息:
+Content-Type:application/json
+USER_ID:1234
+APP_ID:8000418002
+TRANSACTION_ID:10029082726
+REQ_TIME:20181113225612
+SIGN:aabdncdhdbd878sbdudn898
+请求报文:
+
+无
+
+返回报文:
+
+```

+ 57 - 0
docs/document/api/money/queryFee.md

@@ -0,0 +1,57 @@
+
+
+**1\. 查询费用**
+###### 接口功能
+> 查询费用接口
+
+###### URL
+> [待补充]()
+
+###### 支持格式
+> JSON
+
+###### HTTP请求方式
+> GET
+
+###### 请求参数(header部分)
+|参数名称|约束|类型|长度|描述|取值说明|
+| :-: | :-: | :-: | :-: | :-: | :-:|
+|app_id|1|String|30|应用ID|Api服务分配                      |
+|transaction_id|1|String|30|请求流水号|不能重复 1000000000+YYYYMMDDhhmmss+6位序列 |
+|sign|1|String|-|签名|请参考签名说明|
+|req_time|1|String|-|请求时间|YYYYMMDDhhmmss|
+
+###### 请求参数(url部分)
+|参数名称|约束|类型|长度|描述|取值说明|
+| :-: | :-: | :-: | :-: | :-: | :-: |
+|communityId|1|String|30|小区ID|-|
+|feeTypeCd|1|String|12|费用类型|物业费,停车费|
+|roomId|1|String|30|房屋ID|-|
+
+
+###### 返回协议
+
+当http返回状态不为200 时请求处理失败 body内容为失败的原因
+
+当http返回状态为200时请求处理成功,body内容为返回内容,
+
+
+
+###### 举例
+> 地址:[带补充]()
+
+``` javascript
+请求头信息:
+Content-Type:application/json
+USER_ID:1234
+APP_ID:8000418002
+TRANSACTION_ID:10029082726
+REQ_TIME:20181113225612
+SIGN:aabdncdhdbd878sbdudn898
+请求报文:
+
+无
+
+返回报文:
+
+```

+ 68 - 0
docs/document/api/money/queryFeeConfig.md

@@ -0,0 +1,68 @@
+
+
+**1\. 查询费用配置(初始化物业费)**
+###### 接口功能
+> 查询费用接口
+
+###### URL
+> [http://api.java110.com:8008/api/fee.queryFeeConfig](http://api.java110.com:8008/api/fee.queryFeeConfig)
+
+###### 支持格式
+> JSON
+
+###### HTTP请求方式
+> GET
+
+###### 请求参数(header部分)
+|参数名称|约束|类型|长度|描述|取值说明|
+| :-: | :-: | :-: | :-: | :-: | :-:|
+|app_id|1|String|30|应用ID|Api服务分配                      |
+|transaction_id|1|String|30|请求流水号|不能重复 1000000000+YYYYMMDDhhmmss+6位序列 |
+|sign|1|String|-|签名|请参考签名说明|
+|req_time|1|String|-|请求时间|YYYYMMDDhhmmss|
+
+###### 请求参数(url部分)
+|参数名称|约束|类型|长度|描述|取值说明|
+| :-: | :-: | :-: | :-: | :-: | :-: |
+|communityId|1|String|30|小区ID|-|
+|feeTypeCd|1|String|12|费用类型|物业费,停车费|
+
+
+###### 返回协议
+
+当http返回状态不为200 时请求处理失败 body内容为失败的原因
+
+当http返回状态为200时请求处理成功,body内容为返回内容,
+
+
+
+###### 举例
+> 地址:[http://api.java110.com:8008/api/fee.queryFeeConfig?feeTypeCd=888800010001&communityId=7020181217000001](http://api.java110.com:8008/api/fee.queryFeeConfig?feeTypeCd=888800010001&communityId=7020181217000001)
+
+``` javascript
+请求头信息:
+Content-Type:application/json
+USER_ID:1234
+APP_ID:8000418002
+TRANSACTION_ID:10029082726
+REQ_TIME:20181113225612
+SIGN:aabdncdhdbd878sbdudn898
+请求报文:
+
+无
+
+返回报文:
+   {
+   	"squarePrice": "7.00",
+   	"total": 0,
+   	"feeTypeCd": "888800010001",
+   	"records": 0,
+   	"additionalAmount": "300.00",
+   	"configId": "922019060280800001",
+   	"statusCd": "0",
+   	"page": -1,
+   	"row": 0,
+   	"communityId": "7020181217000001"
+   }
+
+```

+ 55 - 0
docs/document/api/money/queryFeeDetail.md

@@ -0,0 +1,55 @@
+
+
+**1\. 查询费用明细**
+###### 接口功能
+> 查询费用明细接口
+
+###### URL
+> [待补充]()
+
+###### 支持格式
+> JSON
+
+###### HTTP请求方式
+> GET
+
+###### 请求参数(header部分)
+|参数名称|约束|类型|长度|描述|取值说明|
+| :-: | :-: | :-: | :-: | :-: | :-:|
+|app_id|1|String|30|应用ID|Api服务分配                      |
+|transaction_id|1|String|30|请求流水号|不能重复 1000000000+YYYYMMDDhhmmss+6位序列 |
+|sign|1|String|-|签名|请参考签名说明|
+|req_time|1|String|-|请求时间|YYYYMMDDhhmmss|
+
+###### 请求参数(url部分)
+|参数名称|约束|类型|长度|描述|取值说明|
+| :-: | :-: | :-: | :-: | :-: | :-: |
+|communityId|1|String|30|小区ID|-|
+|feeId|1|String|30|费用ID|-|
+
+###### 返回协议
+
+当http返回状态不为200 时请求处理失败 body内容为失败的原因
+
+当http返回状态为200时请求处理成功,body内容为返回内容,
+
+
+
+###### 举例
+> 地址:[带补充]()
+
+``` javascript
+请求头信息:
+Content-Type:application/json
+USER_ID:1234
+APP_ID:8000418002
+TRANSACTION_ID:10029082726
+REQ_TIME:20181113225612
+SIGN:aabdncdhdbd878sbdudn898
+请求报文:
+
+无
+
+返回报文:
+
+```

+ 66 - 0
docs/document/api/money/saveFeeConfig.md

@@ -0,0 +1,66 @@
+
+
+**1\. 保存费用配置(初始化物业费)**
+###### 接口功能
+> 修改费用配置接口
+
+###### URL
+> [http://api.java110.com:8008/api/fee.saveFeeConfig](http://api.java110.com:8008/api/fee.saveFeeConfig)
+
+###### 支持格式
+> JSON
+
+###### HTTP请求方式
+> POST
+
+###### 请求参数(header部分)
+|参数名称|约束|类型|长度|描述|取值说明|
+| :-: | :-: | :-: | :-: | :-: | :-:|
+|app_id|1|String|30|应用ID|Api服务分配|
+|transaction_id|1|String|30|请求流水号|不能重复 1000000000+YYYYMMDDhhmmss+6位序列 |
+|sign|1|String|-|签名|请参考签名说明|
+|req_time|1|String|-|请求时间|YYYYMMDDhhmmss|
+
+###### 请求参数(body部分)
+|参数名称|约束|类型|长度|描述|取值说明|
+| :-: | :-: | :-: | :-: | :-: | :-: |
+|communityId|1|String|30|小区ID|-|
+|squarePrice|1|decimal|7,2|每平米收取的单价|-|
+|feeTypeCd|1|String|30|费用类型|物业费,停车费|
+|additionalAmount|1|decimal|7,2|附加费用|-|
+
+
+###### 返回协议
+
+当http返回状态不为200 时请求处理失败 body内容为失败的原因
+
+当http返回状态为200时请求处理成功,body内容为返回内容
+
+
+
+###### 举例
+> 地址:[http://api.java110.com:8008/api/fee.saveFeeConfig](http://api.java110.com:8008/api/fee.saveFeeConfig)
+
+``` javascript
+请求头信息:
+Content-Type:application/json
+USER_ID:1234
+APP_ID:8000418002
+TRANSACTION_ID:10029082726
+REQ_TIME:20181113225612
+SIGN:aabdncdhdbd878sbdudn898
+请求报文:
+
+{
+	"squarePrice": "7.00",
+	"feeTypeCd": "888800010001",
+	"additionalAmount": "300.00",
+	"communityId": "7020181217000001"
+}
+
+
+返回报文:
+
+成功
+
+```

+ 67 - 0
docs/document/api/money/updateFeeConfig.md

@@ -0,0 +1,67 @@
+
+
+**1\. 修改费用配置(初始化物业费)**
+###### 接口功能
+> 修改费用配置接口
+
+###### URL
+> [http://api.java110.com:8008/api/fee.updateFeeConfig](http://api.java110.com:8008/api/fee.updateFeeConfig)
+
+###### 支持格式
+> JSON
+
+###### HTTP请求方式
+> POST
+
+###### 请求参数(header部分)
+|参数名称|约束|类型|长度|描述|取值说明|
+| :-: | :-: | :-: | :-: | :-: | :-:|
+|app_id|1|String|30|应用ID|Api服务分配|
+|transaction_id|1|String|30|请求流水号|不能重复 1000000000+YYYYMMDDhhmmss+6位序列 |
+|sign|1|String|-|签名|请参考签名说明|
+|req_time|1|String|-|请求时间|YYYYMMDDhhmmss|
+
+###### 请求参数(body部分)
+|参数名称|约束|类型|长度|描述|取值说明|
+| :-: | :-: | :-: | :-: | :-: | :-: |
+|communityId|1|String|30|小区ID|-|
+|configId|1|String|30|费用ID|-|
+|squarePrice|1|decimal|7,2|每平米收取的单价|-|
+|feeTypeCd|1|String|30|费用类型|物业费,停车费|
+|additionalAmount|1|decimal|7,2|附加费用|-|
+
+
+###### 返回协议
+
+当http返回状态不为200 时请求处理失败 body内容为失败的原因
+
+当http返回状态为200时请求处理成功,body内容为返回内容
+
+
+
+###### 举例
+> 地址:[http://api.java110.com:8008/api/fee.updateFeeConfig](http://api.java110.com:8008/api/fee.updateFeeConfig)
+
+``` javascript
+请求头信息:
+Content-Type:application/json
+USER_ID:1234
+APP_ID:8000418002
+TRANSACTION_ID:10029082726
+REQ_TIME:20181113225612
+SIGN:aabdncdhdbd878sbdudn898
+请求报文:
+
+{
+	"squarePrice": "7.00",
+	"feeTypeCd": "888800010001",
+	"configId": "922019060280800001",
+	"additionalAmount": "300.00",
+	"communityId": "7020181217000001"
+}
+
+返回报文:
+
+成功
+
+```

+ 67 - 0
docs/document/api/room/exitRoom.md

@@ -0,0 +1,67 @@
+
+
+**1\. 退房 **
+###### 接口功能
+> 退房接口
+
+###### URL
+> [http://api.java110.com:8008/api/room.exitRoom](http://api.java110.com:8008/api/room.exitRoom)
+
+###### 支持格式
+> JSON
+
+###### HTTP请求方式
+> POST
+
+###### 请求参数(header部分)
+|参数名称|约束|类型|长度|描述|取值说明|
+| :-: | :-: | :-: | :-: | :-: | :-:|
+|app_id|1|String|30|应用ID|Api服务分配                      |
+|transaction_id|1|String|30|请求流水号|不能重复 1000000000+YYYYMMDDhhmmss+6位序列 |
+|sign|1|String|-|签名|请参考签名说明|
+|req_time|1|String|-|请求时间|YYYYMMDDhhmmss|
+
+###### 请求参数(body部分)
+|参数名称|约束|类型|长度|描述|取值说明|
+| :-: | :-: | :-: | :-: | :-: | :-: |
+|communityId|1|String|30|组织ID|-|
+|ownerId|1|String|12|小区ID|-|
+|roomId|1|String|10|组织级别|-|
+|storeId|1|String|200|级别名称|-|
+
+
+
+###### 返回协议
+
+当http返回状态不为200 时请求处理失败 body内容为失败的原因
+
+当http返回状态为200时请求处理成功,body内容为返回内容,
+
+
+
+###### 举例
+> 地址:[http://api.java110.com:8008/api/room.exitRoom](http://api.java110.com:8008/api/room.exitRoom)
+
+``` javascript
+请求头信息:
+Content-Type:application/json
+USER_ID:1234
+APP_ID:8000418002
+TRANSACTION_ID:10029082726
+REQ_TIME:20181113225612
+SIGN:aabdncdhdbd878sbdudn898
+请求报文:
+
+{
+	"ownerId": "772019092517890016",
+	"communityId": "7020181217000001",
+	"storeId": "402019032924930007",
+	"userId": "30518940136629616640",
+	"roomId": "752019103088990077"
+}
+
+返回报文:
+
+成功
+
+```

+ 63 - 0
docs/document/api/room/queryRoomsByOwner.md

@@ -0,0 +1,63 @@
+
+
+**1\. 查询业主房屋**
+###### 接口功能
+> 查询业主房屋接口
+
+###### URL
+> [待补充]()
+
+###### 支持格式
+> JSON
+
+###### HTTP请求方式
+> GET
+
+###### 请求参数(header部分)
+|参数名称|约束|类型|长度|描述|取值说明|
+| :-: | :-: | :-: | :-: | :-: | :-:|
+|app_id|1|String|30|应用ID|Api服务分配                      |
+|transaction_id|1|String|30|请求流水号|不能重复 1000000000+YYYYMMDDhhmmss+6位序列 |
+|sign|1|String|-|签名|请参考签名说明|
+|req_time|1|String|-|请求时间|YYYYMMDDhhmmss|
+
+###### 请求参数(url部分)
+|参数名称|约束|类型|长度|描述|取值说明|
+| :-: | :-: | :-: | :-: | :-: | :-: |
+|ownerId|1|String|30|业主ID|-|
+|communityId|1|String|30|小区ID|-|
+
+###### 返回协议
+
+当http返回状态不为200 时请求处理失败 body内容为失败的原因
+
+当http返回状态为200时请求处理成功,body内容为返回内容,
+
+|父参数名称|参数名称|约束|类型|长度|描述|取值说明|
+| :-: | :-: | :-: | :-: | :-: | :-: | :-: |
+|-|-|-|-|-|-|-|
+
+
+
+
+###### 举例
+> 地址:[待补充]()
+
+``` javascript
+请求头信息:
+Content-Type:application/json
+USER_ID:1234
+APP_ID:8000418002
+TRANSACTION_ID:10029082726
+REQ_TIME:20181113225612
+SIGN:aabdncdhdbd878sbdudn898
+请求报文:
+
+无
+
+返回报文:
+{
+	待更新
+}
+
+```

+ 62 - 0
docs/document/api/room/queryRoomsWithSell.md

@@ -0,0 +1,62 @@
+
+
+**1\. 查询已销售的房屋信息**
+###### 接口功能
+> 查询已销售的房屋信息接口
+
+###### URL
+> [待补充]()
+
+###### 支持格式
+> JSON
+
+###### HTTP请求方式
+> GET
+
+###### 请求参数(header部分)
+|参数名称|约束|类型|长度|描述|取值说明|
+| :-: | :-: | :-: | :-: | :-: | :-:|
+|app_id|1|String|30|应用ID|Api服务分配                      |
+|transaction_id|1|String|30|请求流水号|不能重复 1000000000+YYYYMMDDhhmmss+6位序列 |
+|sign|1|String|-|签名|请参考签名说明|
+|req_time|1|String|-|请求时间|YYYYMMDDhhmmss|
+
+###### 请求参数(url部分)
+|参数名称|约束|类型|长度|描述|取值说明|
+| :-: | :-: | :-: | :-: | :-: | :-: |
+|communityId|1|String|30|小区ID|-|
+|page|1|-|-|分页|-|
+|row|1|-|-|分页|-|
+
+
+###### 返回协议
+
+当http返回状态不为200 时请求处理失败 body内容为失败的原因
+
+当http返回状态为200时请求处理成功,body内容为返回内容,
+
+|父参数名称|参数名称|约束|类型|长度|描述|取值说明|
+| :-: | :-: | :-: | :-: | :-: | :-: | :-: |
+
+
+###### 举例
+> 地址:[待补充]()
+
+``` javascript
+请求头信息:
+Content-Type:application/json
+USER_ID:1234
+APP_ID:8000418002
+TRANSACTION_ID:10029082726
+REQ_TIME:20181113225612
+SIGN:aabdncdhdbd878sbdudn898
+请求报文:
+
+无
+
+返回报文:
+{
+    待补充
+}
+
+```

+ 1 - 1
docs/document/api/room/saveRoom.md

@@ -11,7 +11,7 @@
 > JSON
 
 ###### HTTP请求方式
-> GET
+> POST
 
 ###### 请求参数(header部分)
 |参数名称|约束|类型|长度|描述|取值说明|

+ 63 - 0
docs/document/api/room/sellRoom.md

@@ -0,0 +1,63 @@
+
+
+**1\. 房屋售卖**
+###### 接口功能
+> 房屋售卖接口
+
+###### URL
+> [待更新]()
+
+###### 支持格式
+> JSON
+
+###### HTTP请求方式
+> POST
+
+###### 请求参数(header部分)
+|参数名称|约束|类型|长度|描述|取值说明|
+| :-: | :-: | :-: | :-: | :-: | :-:|
+|app_id|1|String|30|应用ID|Api服务分配                      |
+|transaction_id|1|String|30|请求流水号|不能重复 1000000000+YYYYMMDDhhmmss+6位序列 |
+|sign|1|String|-|签名|请参考签名说明|
+|req_time|1|String|-|请求时间|YYYYMMDDhhmmss|
+
+###### 请求参数
+|参数名称|约束|类型|长度|描述|取值说明|
+| :-: | :-: | :-: | :-: | :-: | :-: |
+|communityId|1|String|30|小区ID|-|
+|ownerId|1|String|30|业主ID|-|
+|roomId|1|String|30|房屋ID|-|
+|state|1|String|4|房屋状态|如房屋出售等,请查看state 表|
+|storeId|1|String|30|商户ID|-|
+
+
+###### 返回协议
+
+当http返回状态不为200 时请求处理失败 body内容为失败的原因
+
+当http返回状态为200时请求处理成功,body内容为返回内容,
+
+成功
+
+
+###### 举例
+> 地址:[]()
+
+``` javascript
+请求头信息:
+Content-Type:application/json
+USER_ID:1234
+APP_ID:8000418002
+TRANSACTION_ID:10029082726
+REQ_TIME:20181113225612
+SIGN:aabdncdhdbd878sbdudn898
+请求报文:
+
+{
+    待更新
+}
+
+返回报文:
+成功
+
+```