优化 接口协议文档

java110

2020-06-18 2439080634387c21e46c30b88490369d619e6c63

优化 接口协议文档

 docs/document/_sidebar.md

@@ -11,11 +11,9 @@

  * [接口清单](api/Readme.md)
  * [调用流程](api/apiStart.md)
  * [资产类接口](api/community/index.md)
  * [小区商户类接口](api/community/index.md)
  * [资产类接口](api/capital/index.md)
  * [用户类接口](api/user/index.md)
  * [访客登记](api/user/saveVisit.md)
  * [访客登记变更](api/user/updateVisit.md)
  * [访客记录查询](api/user/listVisits.md)
  * [上传业主照片](api/user/uploadOwnerPhoto.md)
  * [保存商户](api/store/saveStore.md)
  * [删除用户权限](api/privilege/deleteStaffPrivilege.md)
@@ -23,7 +21,6 @@
  * [查询未入驻的小区](api/community/queryNoEnterCommunity.md)
  * [查询小区商户](api/community/listStoresByCommunity.md)
  * [小区审核](api/community/auditCommunity.md)
  * [删除小区](api/community/deleteCommunity.md)
  * [更新小区](api/community/updateCommunity.md)
  * [添加小区](api/community/saveCommunity.md)
  * [查询小区](api/community/listCommunitys.md)
@@ -64,22 +61,6 @@
  * [查看报修](api/repair/queryRepair.md)
  * [报修结案](api/repair/closeRepairDispatch.md)
  * [报修派单](api/repair/repairDispatchStep.md)
  * [删除组织](api/organization/deleteOrg.md)
  * [查询组织](api/organization/listOrgs.md)
  * [查询上级组织](api/organization/listParentOrgs.md)
  * [保存组织](api/organization/saveOrg.md)
  * [修改组织](api/organization/updateOrg.md)
  * [通过用户ID查询组织](api/organization/store.byuser.md)
  * [新增员工](api/staff/addStaff.md)
  * [删除员工](api/staff/deleteStaff.md)
  * [编辑员工](api/staff/editStaff.md)
  * [搜索员工](api/staff/searchStaff.md)
  * [保存广告](api/Advert/saveAdvert.md)
  * [查询广告项](api/Advert/listAdvertItems.md)
  * [查询广告图片视频](api/Advert/listAdvertPhotoAndVedios.md)
  * [查询广告](api/Advert/listAdverts.md)
  * [修改广告](api/Advert/updateAdvert.md)
  * [删除广告](api/Advert/deleteAdvert.md)
  * [停车费清单](api/money/getParkingSpacen.md)
  * [物业费清单](api/money/getPropertyPayFee.md)
  * [支付确认通知](api/money/payFeeConfirm.md)
@@ -89,13 +70,9 @@
  * [查询费用明细](api/money/queryFeeDetail.md)
  * [根据停车位查询费用](api/money/queryFeeByParkingSpace.md)
  * [查询费用](api/money/queryFee.md)
  * [修改费用配置-初始化物业费](api/money/updateFeeConfig.md)
  * [查询费用配置-初始化物业费](api/money/queryFeeConfig.md)
  * [保存费用配置-初始化物业费](api/money/saveFeeConfig.md)
  * [申请访客密码](api/applicationKey/applyVisitorApplicationKey.md)
  * [手机端申请钥匙](api/applicationKey/applyApplicationKey.md)
  * [查询活动](api/activities/listActivitiess.md)
  * [根据对象ID查询文件信息](api/file/getFileByObjId.md)
  * [保存文件](api/file/saveFile.md)
  * [查询文件](api/file/getFile.md)
  * [采购管理-删除审核人员](api/purchase/deleteAuditUser.md)
@@ -106,50 +83,11 @@
  * [采购管理-编辑资源(物品)](api/resource/updateResourceStore.md)
  * [采购管理-删除资源(物品)](api/resource/deleteResourceStore.md)
  * [采购管理-保存资源(物品)](api/resource/saveResourceStore.md)
  * [查询服务提供](api/service/listServiceProvides.md)
  * [编辑服务提供](api/service/updateServiceProvide.md)
  * [删除服务提供](api/service/deleteServiceProvide.md)
  * [开发服务提供](api/service/saveServiceProvide.md)
  * [查询服务实现](api/service/listServiceImpls.md)
  * [修改服务实现](api/service/updateServiceImpl.md)
  * [删除服务实现](api/service/deleteServiceImpl.md)
  * [添加服务实现](api/service/saveServiceImpl.md)
  * [删除服务注册](api/service/deleteServiceRegister.md)
  * [编辑服务注册](api/service/updateServiceRegister.md)
  * [查询服务注册](api/service/listServiceRegisters.md)
  * [绑定服务](api/service/bindingService.md)
  * [删除服务](api/service/deleteService.md)
  * [更新服务](api/service/updateService.md)
  * [添加服务](api/service/saveService.md)
  * [查询服务](api/service/listServices.md)
  * [查询映射](api/mapping/listMappings.md)
  * [删除映射](api/mapping/deleteMapping.md)
  * [修改映射](api/mapping/updateMapping.md)
  * [新增映射](api/mapping/saveMapping.md)
  * [配置菜单](api/menu/configMenu.md)
  * [删除菜单](api/menu/deleteMenu.md)
  * [修改菜单](api/menu/updateMenu.md)
  * [查询菜单](api/menu/listMenus.md)
  * [查询基础权限](api/basePrivilege/listBasePrivileges.md)
  * [删除基础权限](api/basePrivilege/deleteBasePrivilege.md)
  * [编辑基础权限](api/basePrivilege/updateBasePrivilege.md)
  * [添加基础权限](api/basePrivilege/saveBasePrivilege.md)
  * [查询菜单组](api/menu/listMenuGroups.md)
  * [删除权限组](api/menu/deleteMenuGroup.md)
  * [添加菜单组](api/menu/saveMenuGroup.md)
  * [编辑菜单组](api/menu/updateMenuGroup.md)
  * [删除通知](api/notice/deleteNotice.md)
  * [查询通知](api/notice/notice.md)
  * [更新通知](api/notice/updateNotice.md)
  * [添加通知](api/notice/saveNotice.md)
  * [查询通知](api/notice/listNotices.md)
  * [删除应用](api/app/deleteApp.md)
  * [更新应用](api/app/updateApp.md)
  * [添加应用](api/app/saveApp.md)
  * [查询应用](api/app/listApps.md)
  * [查询首页统计信息](api/count/queryIndexStatistic.md)
  * [DEMO查询](api/demo/queryDemoConfig.md)
  * [DEMO新增](api/demo/saveDemoConfig.md)
  * [删除车位信息](api/parkingSpace/deleteParkingSpace.md)
  * [编辑车位信息](api/parkingSpace/editParkingSpace.md)
  * [保存车位信息](api/parkingSpace/saveParkingSpace.md)

 docs/document/api/capital/index.md

New file
@@ -0,0 +1,341 @@
## 说明

资产类接口主要包括小区内的资产信息，如果楼栋 单元 房屋等信息

## 添加楼栋

未整理

## 修改楼栋

未整理

## 添加单元

未整理

## 修改单元

未整理

## 添加房屋

#### 接口说明

#### 请求地址及方式

>https://ip:port/api/room.saveRoom

>http post

#### 请求参数说明
|参数名称|约束|类型|长度|描述|取值说明|
| :-: | :-: | :-: | :-: | :-: | :-: |
|unitPrice|1|String|4|房屋单价|-|
|section|1|String|4|房间数|-|
|remark|1|String|200|备注|-|
|userId|1|String|30|用户ID|-|
|communityId|1|String|30|小区ID|-|
|layer|1|String|30|房屋楼层|-|
|builtUpArea|1|String|30|建筑面积| 如 97.98|
|roomNum|1|String|12|房间编号|1123|
|unitId|1|String|30|小区单元ID|-|
|state|1|String|12|房屋状态|2002 空闲状态|
|apartment|1|String|4|户型|1010 一室一厅 1020 一室两厅 2010 两室一厅 2020 两室两厅 3020 三室两厅|

###### 返回协议

当http返回状态不为200 时请求处理失败 body内容为失败的原因

当http返回状态为200时请求处理成功，body内容为返回内容，

成功


###### 举例
> 地址：[http://api.java110.com:8008/api/room.saveRoom](http://api.java110.com:8008/api/room.saveRoom)

``` javascript
请求头信息：
Content-Type:application/json
USER_ID:1234
APP_ID:8000418002
TRANSACTION_ID:10029082726
REQ_TIME:20181113225612
SIGN:aabdncdhdbd878sbdudn898
请求报文：

{
    "communityId":"小区ID",
    "unitPrice":"填写具体值",
    "section":"填写具体值",
    "remark":"填写具体值",
    "layer":"填写具体值",
    "builtUpArea":"填写具体值",
    "roomNum":"填写具体值",
    "unitId":"填写具体值",
    "apartment":"填写具体值"
}

返回报文：
成功

```


## 修改房屋

#### 接口说明

#### 请求地址及方式

>https://ip:port/api/room.updateRoom

>http get

#### 请求参数说明
|参数名称|约束|类型|长度|描述|取值说明|
| :-: | :-: | :-: | :-: | :-: | :-: |
|roomId|1|String|30|房间ID|12312313|
|unitPrice|1|String|4|房屋单价|-|
|section|1|String|4|房间数|-|
|remark|1|String|200|备注|-|
|userId|1|String|30|用户ID|-|
|communityId|1|String|30|小区ID|-|
|layer|1|String|30|房屋楼层|-|
|builtUpArea|1|String|30|建筑面积| 如 97.98|
|roomNum|1|String|12|房间编号|1123|
|unitId|1|String|30|小区单元ID|-|
|apartment|1|String|4|户型|1010 一室一厅 1020 一室两厅 2010 两室一厅 2020 两室两厅 3020 三室两厅|

###### 返回协议

当http返回状态不为200 时请求处理失败 body内容为失败的原因

当http返回状态为200时请求处理成功，body内容为返回内容，

成功


###### 举例
> 地址：[http://api.java110.com:8008/api/room.updateRoom](http://api.java110.com:8008/api/room.updateRoom)

``` javascript
请求头信息：
Content-Type:application/json
USER_ID:1234
APP_ID:8000418002
TRANSACTION_ID:10029082726
REQ_TIME:20181113225612
SIGN:aabdncdhdbd878sbdudn898
请求报文：

{
    "roomId":"12313",
    "communityId":"小区ID",
    "unitPrice":"填写具体值",
    "section":"填写具体值",
    "remark":"填写具体值",
    "layer":"填写具体值",
    "builtUpArea":"填写具体值",
    "roomNum":"填写具体值",
    "unitId":"填写具体值",
    "apartment":"填写具体值"
}

返回报文：
成功

```

## 房屋业主关系绑定


#### 接口说明

#### 请求地址及方式

>https://ip:port/api/room.updateRoom

>http get

###### 请求参数
|参数名称|约束|类型|长度|描述|取值说明|
| :-: | :-: | :-: | :-: | :-: | :-: |
|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

请求报文：

返回报文：


```


## 房屋业主关系解绑


#### 接口说明

#### 请求地址及方式

>https://ip:port/api/room.exitRoom

>http get

###### 请求参数
|参数名称|约束|类型|长度|描述|取值说明|
| :-: | :-: | :-: | :-: | :-: | :-: |
|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"
}

返回报文：

成功

```

## 查询房屋

#### 接口说明

#### 请求地址及方式

>https://ip:port/api/room.queryRooms

>http get

###### 请求参数
|参数名称|约束|类型|长度|描述|取值说明|
| :-: | :-: | :-: | :-: | :-: | :-: |
|communityId|1|String|30|小区ID|-|
|page|1|-|-|分页|-|
|row|1|-|-|分页|-|


###### 返回协议

当http返回状态不为200 时请求处理失败 body内容为失败的原因

当http返回状态为200时请求处理成功，body内容为返回内容
###### 举例
> 地址：[http://api.java110.com:8008/api/room.queryRooms?page=1&row=10&communityId=7020181217000001](http://api.java110.com:8008/api/room.queryRooms?page=1&row=10&communityId=7020181217000001)

``` javascript
请求报文：

无

返回报文：
{
    "page": 0,
    "records": 3,
    "rooms": [{
        "apartment": "10102",
        "apartmentName": "一室两厅",
        "builtUpArea": "94.56",
        "floorId": "732019092566800002",
        "floorNum": "501",
        "layer": "1",
        "roomId": "752019092595400003",
        "roomNum": "1013",
        "section": "1",
        "state": "2001",
        "unitId": "742019092594570007",
        "unitNum": "1",
        "unitPrice": "1000.00",
        "userName": "wuxw"
    },{
        "apartment": "1010",
        "builtUpArea": "94.56",
        "floorId": "732019100967710004",
        "floorNum": "1",
        "layer": "1",
        "roomId": "752019103084230076",
        "roomNum": "1013",
        "section": "1",
        "state": "2001",
        "unitId": "742019103065850047",
        "unitNum": "1",
        "unitPrice": "1000.00",
        "userName": "wuxw"
    }, {
        "apartment": "1010",
        "builtUpArea": "94.56",
        "floorId": "732019100967710004",
        "floorNum": "1",
        "layer": "1",
        "roomId": "752019103088990077",
        "roomNum": "1014",
        "section": "1",
        "state": "2001",
        "unitId": "742019103065850047",
        "unitNum": "1",
        "unitPrice": "1000.00",
        "userName": "wuxw"
    }],
    "rows": 0,
    "total": 28
}
```

## 查询绑定业主房屋


## 查询未绑定业主房屋

## 查询业主房屋

 docs/document/api/community/index.md

@@ -1,229 +1,74 @@
## 说明

资产类接口主要包括小区内的资产信息，如果楼栋 单元 房屋等信息
小区商户类接口 主要包含 小区添加 审核 商户入驻审核等功能接口

## 添加楼栋
## 添加小区

未整理

## 修改楼栋
## 查询未审核小区

未整理
## 审核小区

## 添加单元
## 查询小区

未整理
## 商户入驻小区

## 修改单元
## 商户入驻审核

未整理
## 查询小区商户

## 添加房屋
## 查询组织

#### 接口说明
###### 接口功能
> 用户通过web端或APP查询组织信息接口

#### 请求地址及方式
###### URL
> [http://api.java110.com:8008/api/org.listOrgs](http://api.java110.com:8008/api/org.listOrgs)

>https://ip:port/api/room.saveRoom
###### 支持格式
> JSON

>http post
###### 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部分)
|参数名称|约束|类型|长度|描述|取值说明|
| :-: | :-: | :-: | :-: | :-: | :-: |
|unitPrice|1|String|4|房屋单价|-|
|section|1|String|4|房间数|-|
|remark|1|String|200|备注|-|
|userId|1|String|30|用户ID|-|
|communityId|1|String|30|小区ID|-|
|layer|1|String|30|房屋楼层|-|
|builtUpArea|1|String|30|建筑面积| 如 97.98|
|roomNum|1|String|12|房间编号|1123|
|unitId|1|String|30|小区单元ID|-|
|state|1|String|12|房屋状态|2002 空闲状态|
|apartment|1|String|4|户型|1010 一室一厅 1020 一室两厅 2010 两室一厅 2020 两室两厅 3020 三室两厅|

###### 返回协议

当http返回状态不为200 时请求处理失败 body内容为失败的原因

当http返回状态为200时请求处理成功，body内容为返回内容，

成功


###### 举例
> 地址：[http://api.java110.com:8008/api/room.saveRoom](http://api.java110.com:8008/api/room.saveRoom)

``` javascript
请求头信息：
Content-Type:application/json
USER_ID:1234
APP_ID:8000418002
TRANSACTION_ID:10029082726
REQ_TIME:20181113225612
SIGN:aabdncdhdbd878sbdudn898
请求报文：

{
    "communityId":"小区ID",
    "unitPrice":"填写具体值",
    "section":"填写具体值",
    "remark":"填写具体值",
    "layer":"填写具体值",
    "builtUpArea":"填写具体值",
    "roomNum":"填写具体值",
    "unitId":"填写具体值",
    "apartment":"填写具体值"
}

返回报文：
成功

```


## 修改房屋

#### 接口说明

#### 请求地址及方式

>https://ip:port/api/room.updateRoom

>http get

#### 请求参数说明
|参数名称|约束|类型|长度|描述|取值说明|
| :-: | :-: | :-: | :-: | :-: | :-: |
|roomId|1|String|30|房间ID|12312313|
|unitPrice|1|String|4|房屋单价|-|
|section|1|String|4|房间数|-|
|remark|1|String|200|备注|-|
|userId|1|String|30|用户ID|-|
|communityId|1|String|30|小区ID|-|
|layer|1|String|30|房屋楼层|-|
|builtUpArea|1|String|30|建筑面积| 如 97.98|
|roomNum|1|String|12|房间编号|1123|
|unitId|1|String|30|小区单元ID|-|
|apartment|1|String|4|户型|1010 一室一厅 1020 一室两厅 2010 两室一厅 2020 两室两厅 3020 三室两厅|

###### 返回协议

当http返回状态不为200 时请求处理失败 body内容为失败的原因

当http返回状态为200时请求处理成功，body内容为返回内容，

成功


###### 举例
> 地址：[http://api.java110.com:8008/api/room.updateRoom](http://api.java110.com:8008/api/room.updateRoom)

``` javascript
请求头信息：
Content-Type:application/json
USER_ID:1234
APP_ID:8000418002
TRANSACTION_ID:10029082726
REQ_TIME:20181113225612
SIGN:aabdncdhdbd878sbdudn898
请求报文：

{
    "roomId":"12313",
    "communityId":"小区ID",
    "unitPrice":"填写具体值",
    "section":"填写具体值",
    "remark":"填写具体值",
    "layer":"填写具体值",
    "builtUpArea":"填写具体值",
    "roomNum":"填写具体值",
    "unitId":"填写具体值",
    "apartment":"填写具体值"
}

返回报文：
成功

```

## 房屋业主关系绑定


#### 接口说明

#### 请求地址及方式

>https://ip:port/api/room.updateRoom

>http get

###### 请求参数
|参数名称|约束|类型|长度|描述|取值说明|
| :-: | :-: | :-: | :-: | :-: | :-: |
|communityId|1|String|30|小区ID|-|
|ownerId|1|String|30|业主ID|-|
|roomId|1|String|30|房屋ID|-|
|state|1|String|4|房屋状态|如房屋出售等，请查看state 表|
|page|1|int|-|页数|-|
|row|1|int|-|每页显示的行数|不能超过50条|
|storeId|1|String|30|商户ID|-|


###### 返回协议

当http返回状态不为200 时请求处理失败 body内容为失败的原因

当http返回状态为200时请求处理成功，body内容为返回内容，

成功
|父参数名称|参数名称|约束|类型|长度|描述|取值说明|
| :-: | :-: | :-: | :-: | :-: | :-: | :-: |
|-|description|1|String|200|组织描述|-|
|-|orgId|1|String|30|组织ID|-|
|-|orgLevel|1|String|10|组织级别|-|
|-|orgLevelName|1|String|200|级别名称|-|
|-|orgName|1|String|200|组织名称|-|
|-|parentOrgId|1|String|30|上级组织ID|-|
|-|parentOrgName|1|String|30|上级组织名称|-|





###### 举例
>

``` javascript

请求报文：

返回报文：


```


## 房屋业主关系解绑


#### 接口说明

#### 请求地址及方式

>https://ip:port/api/room.exitRoom

>http get

###### 请求参数
|参数名称|约束|类型|长度|描述|取值说明|
| :-: | :-: | :-: | :-: | :-: | :-: |
|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)
> 地址：[http://api.java110.com:8008/api/org.listOrgs?storeTypeCd=800900000003&storeId=402019032924930007&userName=wuxw&userId=30518940136629616640&page=1&row=10&class=class](http://api.java110.com:8008/api/org.listOrgs?storeTypeCd=800900000003&storeId=402019032924930007&userName=wuxw&userId=30518940136629616640&page=1&row=10&class=class)

``` javascript
请求头信息：
@@ -233,109 +78,535 @@
TRANSACTION_ID:10029082726
REQ_TIME:20181113225612
SIGN:aabdncdhdbd878sbdudn898
请求报文：

{
    "ownerId": "772019092517890016",
    "communityId": "7020181217000001",
    "storeId": "402019032924930007",
    "userId": "30518940136629616640",
    "roomId": "752019103088990077"
}

返回报文：

成功

```

## 查询房屋

#### 接口说明

#### 请求地址及方式

>https://ip:port/api/room.queryRooms

>http get

###### 请求参数
|参数名称|约束|类型|长度|描述|取值说明|
| :-: | :-: | :-: | :-: | :-: | :-: |
|communityId|1|String|30|小区ID|-|
|page|1|-|-|分页|-|
|row|1|-|-|分页|-|


###### 返回协议

当http返回状态不为200 时请求处理失败 body内容为失败的原因

当http返回状态为200时请求处理成功，body内容为返回内容
###### 举例
> 地址：[http://api.java110.com:8008/api/room.queryRooms?page=1&row=10&communityId=7020181217000001](http://api.java110.com:8008/api/room.queryRooms?page=1&row=10&communityId=7020181217000001)

``` javascript
请求报文：

无

返回报文：
{
    "page": 0,
    "records": 3,
    "rooms": [{
        "apartment": "10102",
        "apartmentName": "一室两厅",
        "builtUpArea": "94.56",
        "floorId": "732019092566800002",
        "floorNum": "501",
        "layer": "1",
        "roomId": "752019092595400003",
        "roomNum": "1013",
        "section": "1",
        "state": "2001",
        "unitId": "742019092594570007",
        "unitNum": "1",
        "unitPrice": "1000.00",
        "userName": "wuxw"
    },{
        "apartment": "1010",
        "builtUpArea": "94.56",
        "floorId": "732019100967710004",
        "floorNum": "1",
        "layer": "1",
        "roomId": "752019103084230076",
        "roomNum": "1013",
        "section": "1",
        "state": "2001",
        "unitId": "742019103065850047",
        "unitNum": "1",
        "unitPrice": "1000.00",
        "userName": "wuxw"
    "orgs": [{
        "description": "总公司",
        "orgId": "123",
        "orgLevel": "1",
        "orgLevelName": "公司级",
        "orgName": "java110工作室",
        "parentOrgId": "123",
        "parentOrgName": "java110工作室"
    }, {
        "apartment": "1010",
        "builtUpArea": "94.56",
        "floorId": "732019100967710004",
        "floorNum": "1",
        "layer": "1",
        "roomId": "752019103088990077",
        "roomNum": "1014",
        "section": "1",
        "state": "2001",
        "unitId": "742019103065850047",
        "unitNum": "1",
        "unitPrice": "1000.00",
        "userName": "wuxw"
        "description": "萨基打工撒谎发AFJasgfhASdfaSKl1",
        "orgId": "842019120765720013",
        "orgLevel": "2",
        "orgLevelName": "分公司级",
        "orgName": "奥利给工作室",
        "parentOrgId": "123",
        "parentOrgName": "java110工作室"
    }, {
        "description": "阿打发dAD",
        "orgId": "842019120749040014",
        "orgLevel": "3",
        "orgLevelName": "部门级",
        "orgName": "阿迪敬爱的",
        "parentOrgId": "842019120765720013",
        "parentOrgName": "奥利给工作室"
    }],
    "page": 0,
    "records": 1,
    "rows": 0,
    "total": 28
    "total": 3
}

```

## 查询绑定业主房屋
## 添加组织

###### 接口功能
> 用户通过web端或APP保存组织接口

###### URL
> [http://api.java110.com:8008/api/org.saveOrg](http://api.java110.com:8008/api/org.saveOrg)

###### 支持格式
> 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部分)
|参数名称|约束|类型|长度|描述|取值说明|
| :-: | :-: | :-: | :-: | :-: | :-: |
|storeId|1|String|30|商户ID|-|
|communityId|1|String|12|小区ID|-|
|orgLevel|1|String|10|组织级别|-|
|description|1|String|200|组织描述|-|
|orgName|1|String|200|组织名称|-|
|parentOrgId|1|String|30|上级组织ID|-|
|parentOrg|-|-|-|上级组织对象|包含上诉字段具体格式请看下面举例|


## 查询未绑定业主房屋
###### 返回协议

## 查询业主房屋
当http返回状态不为200 时请求处理失败 body内容为失败的原因

当http返回状态为200时请求处理成功，body内容为返回内容，



###### 举例
> 地址：[http://api.java110.com:8008/api/org.saveOrg](http://api.java110.com:8008/api/org.deleteOrg)

``` javascript
请求头信息：
Content-Type:application/json
USER_ID:1234
APP_ID:8000418002
TRANSACTION_ID:10029082726
REQ_TIME:20181113225612
SIGN:aabdncdhdbd878sbdudn898
请求报文：

{
    "orgName": "ddadad",
    "parentOrgId": "123",
    "description": "eqeqqeqe",
    "orgLevel": "2",
    "parentOrg": [{
        "orgName": "java110工作室",
        "parentOrgId": "123",
        "description": "总公司",
        "orgLevelName": "公司级",
        "orgLevel": "1",
        "parentOrgName": "java110工作室",
        "orgId": "123"
    }],
    "communityId": "7020181217000001",
    "storeId": "402019032924930007"
}

返回报文：

成功

```

## 编辑组织

###### 接口功能
> 用户通过web端或APP编辑组织接口

###### URL
> [http://api.java110.com:8008/api/org.updateOrg](http://api.java110.com:8008/api/org.updateOrg)

###### 支持格式
> 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部分)
|参数名称|约束|类型|长度|描述|取值说明|
| :-: | :-: | :-: | :-: | :-: | :-: |
|orgId|1|String|30|组织ID|-|
|storeId|1|String|30|商户ID|-|
|communityId|1|String|12|小区ID|-|
|orgLevel|1|String|10|组织级别|-|
|description|1|String|200|组织描述|-|
|parentOrgId|1|String|30|上级组织ID|-|
|orgName|1|String|200|组织名称|-|
|parentOrg|1|-|-|上级组织对象|包含上诉字段格式请看下面举例|


###### 返回协议

当http返回状态不为200 时请求处理失败 body内容为失败的原因

当http返回状态为200时请求处理成功，body内容为返回内容，



###### 举例
> 地址：[http://api.java110.com:8008/api/org.updateOrg ](http://api.java110.com:8008/api/org.updateOrg )

``` javascript
请求头信息：
Content-Type:application/json
USER_ID:1234
APP_ID:8000418002
TRANSACTION_ID:10029082726
REQ_TIME:20181113225612
SIGN:aabdncdhdbd878sbdudn898
请求报文：

{
    "orgName": "奥利给工作室",
    "parentOrgId": "123",
    "description": "2121212",
    "orgLevel": "2",
    "parentOrg": [{
        "orgName": "java110工作室",
        "parentOrgId": "123",
        "description": "总公司",
        "orgLevelName": "公司级",
        "orgLevel": "1",
        "parentOrgName": "java110工作室",
        "orgId": "123"
    }],
    "communityId": "7020181217000001",
    "storeId": "402019032924930007",
    "orgId": "842019120765720013"
}

返回报文：

成功

```

## 删除组织

###### 接口功能
> 用户通过web端或APP编辑组织接口

###### URL
> [http://api.java110.com:8008/api/org.deleteOrg](http://api.java110.com:8008/api/org.deleteOrg)

###### 支持格式
> 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部分)
|参数名称|约束|类型|长度|描述|取值说明|
| :-: | :-: | :-: | :-: | :-: | :-: |
|orgId|1|String|30|组织ID|-|
|communityId|1|String|12|小区ID|-|
|orgLevel|1|String|10|组织级别|-|
|orgLevelName|1|String|200|级别名称|-|
|description|1|String|200|组织描述|-|
|parentOrgId|1|String|30|上级组织ID|-|
|orgName|1|String|200|组织名称|-|
|parentOrgId|1|String|30|上级组织ID|-|


###### 返回协议

当http返回状态不为200 时请求处理失败 body内容为失败的原因

当http返回状态为200时请求处理成功，body内容为返回内容，

###### 举例
> 地址：[http://api.java110.com:8008/api/org.deleteOrg](http://api.java110.com:8008/api/org.deleteOrg)

``` javascript
请求头信息：
Content-Type:application/json
USER_ID:1234
APP_ID:8000418002
TRANSACTION_ID:10029082726
REQ_TIME:20181113225612
SIGN:aabdncdhdbd878sbdudn898
请求报文：

{
    "orgName": "阿迪敬爱的",
    "parentOrgId": "842019120765720013",
    "description": "阿打发dAD",
    "orgLevelName": "部门级",
    "orgLevel": "3",
    "communityId": "7020181217000001",
    "storeId": "402019032924930007",
    "parentOrgName": "奥利给工作室",
    "orgId": "842019120749040014"
}

返回报文：

成功

```

## 添加员工

###### 接口功能
> 用户通过web端或APP添加添加员工信息接口

###### URL
> [http://api.java110.com:8008/api/user.staff.add](http://api.java110.com:8008/api/user.staff.add)

###### 支持格式
> 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部分)
|参数名称|约束|类型|长度|描述|取值说明|
| :-: | :-: | :-: | :-: | :-: | :-: |
|name|1|String|50|名称|-|
|email|1|String|30|邮箱地址|-|
|tel|1|String|11|电话|-|
|orgId|1|String|200|备注|-|
|address|1|String|300|现居住地址|-|
|sex|1|String|1|小区ID|0表示男孩 1表示女孩|
|relCd|1|String|30|关系角色|10000 普通员工， 20000部门经理 查看t_dict表|


###### 返回协议

当http返回状态不为200 时请求处理失败 body内容为失败的原因

当http返回状态为200时请求处理成功，body内容为返回内容，


###### 举例
> 地址：[http://api.java110.com:8008/api/floor.saveFloor](http://api.java110.com:8008/api/floor.saveFloor)

``` javascript
请求头信息：
Content-Type:application/json
USER_ID:1234
APP_ID:8000418002
TRANSACTION_ID:10029082726
REQ_TIME:20181113225612
SIGN:aabdncdhdbd878sbdudn898
请求报文：

{
    "address": "13131",
    "storeTypeCd": "800900000003",
    "sex": "0",
    "name": "31313",
    "tel": "1331313",
    "storeId": "402019032924930007",
    "orgId": "842019122030120003",
    "email": "121184950@qq.com",
    "username": "31313",
    "relCd": "10000"
}


返回报文：

```


## 删除员工

###### 接口功能
> 用户通过web端或APP添加添加员工信息接口

###### URL
> [http://api.java110.com:8008/api/user.staff.delete](http://api.java110.com:8008/api/user.staff.delete)

###### 支持格式
> 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部分)
|参数名称|约束|类型|长度|描述|取值说明|
| :-: | :-: | :-: | :-: | :-: | :-: |
|storeId|1|String|30|商户ID|-|
|userId|1|String|30|用户ID|-|



###### 返回协议

当http返回状态不为200 时请求处理失败 body内容为失败的原因

当http返回状态为200时请求处理成功，body内容为返回内容，


###### 举例
> 地址：[http://api.java110.com:8008/api/user.staff.delete](http://api.java110.com:8008/api/user.staff.delete)

``` javascript
请求头信息：
Content-Type:application/json
USER_ID:1234
APP_ID:8000418002
TRANSACTION_ID:10029082726
REQ_TIME:20181113225612
SIGN:aabdncdhdbd878sbdudn898
请求报文：

{
    "address": "13131",
    "age": 0,
    "sex": "0",
    "name": "31313",
    "orgName": "高速反辐射",
    "tel": "1331313",
    "email": "121184950@qq.com",
    "username": "302019122019140002",
    "userId": "31313"
}


返回报文：

## 查询员工

###### 接口功能
> 用户通过web端或APP搜索员工信息接口

###### URL
> [http://api.java110.com:8008/api/query.staff.infos?rows=10&storeId=402019032924930007&page=1&row=10](http://api.java110.com:8008/api/query.myCommunity.byMember)

###### 支持格式
> 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部分)
|参数名称|约束|类型|长度|描述|取值说明|
| :-: | :-: | :-: | :-: | :-: | :-: |
|page|-|-|30|页数|-|
|row|-|-|30|行数|-|
|storeId|1|String|30|商户ID|-|

###### 返回协议

当http返回状态不为200 时请求处理失败 body内容为失败的原因

当http返回状态为200时请求处理成功，body内容为返回内容，

|父参数名称|参数名称|约束|类型|长度|描述|取值说明|
| :-: | :-: | :-: | :-: | :-: | :-: | :-: |
|email|1|String|30|邮箱地址|-|
|username|1|String|50|名称|-|
|name|1|String|50|名称|-|
|tel|1|String|11|电话|-|
|errorInfo|1|String|-|错误信息|-|
|userId|1|String|30|用户ID|-|
|address|1|String|300|现居住地址|-|
|sex|1|String|1|小区ID|0表示男孩 1表示女孩|
|age|1|int|-|年龄|-|
|orgName|1|String|30|组织名称|-|





###### 举例
> 地址：[http://api.java110.com:8008/api/query.staff.infos?rows=10&storeId=402019032924930007&page=1&row=10](http://api.java110.com:8008/api/query.staff.infos?rows=10&storeId=402019032924930007&page=1&row=10)

``` javascript
请求头信息：
Content-Type:application/json
USER_ID:1234
APP_ID:8000418002
TRANSACTION_ID:10029082726
REQ_TIME:20181113225612
SIGN:aabdncdhdbd878sbdudn898
请求报文：

无

返回报文：
 {
        "page": 0,
        "records": 1,
        "rows": 0,
        "staffs": [{
            "address": "3131",
            "age": 0,
            "email": "121184950@qq.com",
            "name": "31313",
            "orgName": "高速反辐射",
            "sex": "0",
            "tel": "15178831314",
            "userId": "302019122019140002",
            "userName": "31313"
        }, {
            "address": "31313",
            "age": 0,
            "email": "121184950@qq.com",
            "name": "3131",
            "orgName": "高速反辐射",
            "sex": "0",
            "tel": "31313",
            "userId": "302019122023920001",
            "userName": "3131"
        }, {
            "address": "123467",
            "age": 0,
            "email": "928255095@qq.com",
            "name": "gsfa",
            "orgName": "研发部",
            "sex": "1",
            "tel": "18909782345",
            "userId": "302019101771430001",
            "userName": "gsfa"
        }, {
            "address": "11",
            "age": 0,
            "email": "1@qq.cn",
            "name": "11",
            "orgName": "研发部",
            "sex": "0",
            "tel": "17111111111",
            "userId": "302019101636810001",
            "userName": "11"
        }],
        "total": 4
    }

```







 docs/document/api/organization/deleteOrg.md

File was deleted

 docs/document/api/organization/listOrgs.md

File was deleted

 docs/document/api/organization/saveOrg.md

File was deleted

 docs/document/api/organization/updateOrg.md

File was deleted

 docs/document/api/staff/deleteStaff.md

@@ -65,3 +65,7 @@
返回报文：

```

## 查询员工