1 客户与产权关系

1.1 通过客户ID列表获取产权信息

URL： /v1/iot/main/customer/cust_house_rel/by/cust_id

方法：POST

请求参数

名称 位置 类型 必填 描述
cust_id body string y 客户ID,数组用逗号隔开
community_id body string n 项目ID,数组用逗号隔开

请求Body描述(非Form表单数据)

{
    "cust_id": "9343",
    "community_id": "9888"
}

返回信息

返回参数类型

JSON

返回参数

字段 字段类型 是否必填 说明
space_id string y 空间ID
space_type string y 空间类型
space_code String y 最深层级空间code
customer_name String y 产权人名
customer_phone String y 产权人电话
full_space_name String y 产权空间全路径名称
customer_type Integer y 客户类型(1业主 ；2业主成员；3租客；4租客成员)
main_flag Integer y 主业主标示(0非主业;主1主业主)
housing_status Integer y 客户住房状态(1000在住，1001暂离，1003迁出 ，1004注销)
type Integer y 产权类型1房屋；2车位
customer_id Long y 客户id（产权人Id）
build_id Long n 楼栋ID
unit_id Long n 单元ID

返回示例：

{
    "resCode": "0",
    "resMsg": "成功",
    "result": [
        {
            "space_code": "100000021100000000100000000100000000100000000100000000100000001",
            "space_name": "302",
            "customer_type": 1,
            "community_name": "时代大厦",
            "space_id": 19957,
            "housing_status": 1000,
            "e_community_id": null,
            "type": 1,
            "create_time": 1608021458000,
            "park_no": null,
            "update_time": null,
            "customer_id": 20075,
            "full_space_name": "时代大厦/第一片区/建筑物/A/第一单元/3/302",
            "build_id": 19949,
            "e_cus_hou_rel_id": null,
            "update_by": null,
            "area": null,
            "create_by": "system",
            "src": 1,
            "id": 20094,
            "e_space_id": null,
            "unit_id": 19952,
            "community_code": "100000021",
            "main_flag": 0,
            "community_id": 19936,
            "e_customer_id": null
        }
    ],
    "pageNo": 0,
    "pageSize": 0,
    "total": 0,
    "totalPage": 0
}

1.2 通过空间ID获取客户列表（含产权信息）

URL： /v1/iot/main/customer/cust_house_rel/by/space_id

body: JSON格式约定

方法：POST

请求参数

名称 位置 类型 必填 描述
ids body array 否 客户id列表
identity body String 否 证件号码
customer_name body String 是 客户名称
customer_phone body String 否 电话号码
status body Integer 否 客户状态：1:有效 ;2:无效 默认是1
identity_type body Integer 否 证件类型, 1:身份证, 2:护照,3:组织机构代码(针对政府), 4:统一社会信用代码(针对企业),5:港澳台身份证
customer_properties body Integer 否 客户性质 1:个人客户；2:政企客户
pageNo body Integer 否 第几页
pageSize body Integer 否 每页大小
communityId body Long 否 小区id：用户做数据权限控制的
orgList body List 否 业务组织集合：用户做数据权限控制的
space_id body string y 空间ID
spaceIds body Array n 空间ID列表
space_type body string y 空间类型
isCustRelInnerSpace body int n 是否查询在空间内的产权关系 1是，0否
pageNo body int 是 body参数；页码
pageSize body int 是 body参数；每页显示记录条数 
空间类型, COMMUNITY：小区（项目）、ZONE：片区、BUILDING：楼宇、UNIT：单元、FLOOR：楼层、HOUSE：房屋；PUBLIC:公共区域、PARKING:停车场, PARKING_DISTRICT:车场区域, PARKING: 车位; 此字段不可为空

communityId，orgList均可用于做数据隔离，两者的目的均是获取业务组织，根据业务组织框定客户的数据范围。两种者不能同时生效。
优先级由到到低依次为：communityId，orgList

请求Body描述(非Form表单数据)

{

}

返回信息

返回参数类型

JSON

返回参数

字段 字段类型 是否必填 说明
identity String n 证件号码
customer_name String y 客户名称
customer_phone String n 电话号码
status Integer n 客户状态：1:有效 ;2:无效 默认是1
identity_type Integer n 证件类型, 1:身份证, 2:护照,3:组织机构代码(针对政府), 4:统一社会信用代码(针对企业),5:港澳台身份证
customer_properties Integer n 客户性质 1:个人客户；2:政企客户
space_id string y 空间ID
space_type string y 空间类型
space_code String y 最深层级空间code
customer_name String y 产权人名
customer_phone String y 产权人电话
full_space_name String y 产权空间全路径名称
customer_type Integer y 客户类型(1业主 ；2业主成员；3租客；4租客成员)
main_flag Integer y 主业主标示(0非主业;主1主业主)
housing_status Integer y 客户住房状态(1000在住，1001暂离，1003迁出 ，1004注销)
type Integer y 产权类型1房屋；2车位
customer_id Long y 客户id（产权人Id）

返回示例：

{
    "resCode": "0",
    "resMsg": "成功",
    "result": [
        {
            "id": 9853,
            "top_org_id": 8829,
            "top_org_code": "901",
            "customer_properties": 1,
            "identity_type": 1,
            "identity": "440802199508150819",
            "customer_name": "黄琛策",
            "sex": 1,
            "customer_phone": "15602255455",
            "status": 1,
            "src": 2,
            "customerHouseRels": [
                {
                    "update_by": "system",
                    "update_time": 1605862978000,
                    "id": 10922,
                    "type": 1,
                    "space_id": 5704,
                    "space_code": "39831024100010061001",
                    "space_name": "3栋_1单元_701",
                    "full_space_name": "美的君兰江山（北滘）/3栋/1单元/7/3栋_1单元_701",
                    "community_name": "美的君兰江山（北滘）-同步",
                    "community_id": 10264,
                    "community_code": "4889",
                    "customer_id": 9853,
                    "customer_type": 1,
                    "main_flag": 1,
                    "housing_status": 1000,
                    "e_cus_hou_rel_id": 501726,
                    "e_customer_id": 410097,
                    "e_space_id": 2699099,
                    "e_community_id": 610,
                    "src": 2
                }
            ]
        }
    ],
    "pageNo": 1,
    "pageSize": 10,
    "total": 124,
    "totalPage": 13
}

1.3 新增(修改)客户，同时新增(修改)产权-微服务之间调用

请求信息

URL：/v1/iot/main/inner/customer/customerHouseRel/save

Method: POST

body: JSON格式约定

入参dto：

字段 字段类型 是否必填（默认否） 是否唯一（默认否） 说明
identity_type Integer 是 证件类型, 1:身份证 （先固定传1）
identity String 是 证件号码
customer_name String 是 客户名称
customer_phone String 是 电话号码
customer_properties Integer 否 '客户性质 1:个人客户；2:政企客户'，默认个人客户
sex Integer 否 性别，1:女，2:男，默认为null
face_ico String 否 人脸, 存储图片相对路径，默认为null
space_type Integer 是 '产权类型1房屋；2车位
space_id Long 是 空间id（房屋id/车位id）
customer_type Integer 是 客户类型(2业主，3业主成员，14租户，15租户成员)
housing_status Integer 是 客户住房状态(1000在住，1001暂离，1003注销 ，1004迁出)

请求示例：

{
    "identity_type":1,
    "identity":430421199307280051,
    "customer_name":"客户51_修改",
    "customer_phone":"13418770051",
    "space_type":1,
    "space_id":111,
    "customer_type":2,
    "housing_status":1000
}

返回：

{
        "id": 9867,
        "top_org_id": 8829, //顶级组织
        "top_org_code": "901",//顶级组织id
        "customer_properties": 1,
        "identity_type": 1,
        "identity": "430421199307280051",
        "customer_name": "客户51_修改",
        "sex": 1,
        "customer_phone": "13418770051",
        "face_ico": "iejdj51",
        "status": 1,
        "src": 1
}

1.4 根据员工id查询员工详情和员工关联的小区对象集合-微服务之间调用

请求信息

URL：/v1/iot/main/inner/admin/list/community/byAdminId

Method: POST

body: JSON格式约定

入参dto：

字段 字段类型 是否必填（默认否） 是否唯一（默认否） 说明
id Long 是 员工id

出参dto：

字段 字段类型 位置 说明
id Long 顶级 员工id
org_id Long 顶级 行政组织ID，smart_cmty_org 外键
org_code String 顶级 行政组织编码
mobile String 顶级 手机号
src Integer 顶级 帐号来源，1：自研系统,2:4A
name String 顶级 姓名
sex Integer 顶级 性别1为女，2为男
status Integer 顶级 状态: 1为正常、2为注销
is_effective Integer 顶级 账号是否有效 1为启用、2为禁用
face_ico String 顶级 人脸, 存储图片相对路径
identity String 顶级 身份证
type Integer 顶级 1:物管用户，4:商户用户,8:平台管理用户
communitys List 顶级 小区集合
id Long communitys 空间id
space_code String communitys 空间编码
space_type Integer communitys 空间类型(细分类)： COMMUNITY：小区、ZONE：片区、STRUCTURE:建筑物、BUILDING：楼栋、UNIT：单元、FLOOR：楼层、HOUSE：房屋、 PARK:车场、PARK_NAME：车场名称、PARK_AREA:车场区域、PARK_SPACE:车位、 PUBLIC_AREA:公共区域、PRIMARY_AREA:一级区域、SECONDARY_AREA:二级区域、THIRD_AREA:三级区域
space_name String communitys 空间名
full_space_name String communitys 空间全路径名
src Integer communitys 数据来源，1：自研系统，2：4A系统
org_id Long communitys 关联的业务组织id
top_org_id Long communitys 顶级业务组织id
status Integer communitys 空间状态：1:有效 ;2:无效
business_type Integer communitys 空间业务类型：'1:智慧小区, 2: 智慧工业园, 3: 智慧养老院, 4: 智慧医院, 5: 智慧政务

请求示例：

{
    "id":23324
}

返回：

{
    "create_by": "system_insert",
    "update_by": null,
    "create_time": 1609975309000,
    "update_time": null,
    "id": 23324,
    "user_id": null,
    "org_id": 21896,
    "mobile": "13477889900",
    "org_code": "100000149",
    "src": 1,
    "nickname": "客户000040",
    "ico": null,
    "job_number": "zhuhy666",
    "pwd": "{bcrypt}$2a$10$Qzac5zlBH3VOAPY1lFO77ODhc19AzAKmEF6ZNhM8gQC.v3vDg3YH2",
    "name": "zhuhy666",
    "sex": null,
    "email": "13477889900@163.com",
    "identity": "430899199307289999",
    "type": 1,
    "status": 1,
    "last_login_time": null,
    "pwd_modify_time": null,
    "lock_time": null,
    "login_fail_times": null,
    "birthday": null,
    "last_login": null,
    "staff_no": "zhuhy666",
    "position": "java",
    "is_supper": 1,
    "face_ico": "",
    "is_effective": 1,
    "roleNames": null,
    "groupNames": null,
    "ids": null,
    "userIds": null,
    "relationId": null,
    "relationIds": null,
    "groupId": null,
    "adminOrgCodes": null,
    "adminIds": null,
    "pageNo": null,
    "pageSize": null,
    "client_id": null,
    "client_secret": null,
    "orgName": null,
    "fullOrgName": null,
    "org_type": null,
    "rel_org_id": null,
    "authOrgId": null,
    "communityId": null,
    "oldFlag": null,
    "communitys": [
        {
            "create_by": null,
            "update_by": null,
            "create_time": 1609380241000,
            "update_time": 1609865352000,
            "id": 21906,
            "parentid": null,
            "space_id": null,
            "parent_space_id": null,
            "community_id": null,
            "space_name": "领贤公馆",
            "full_space_name": "领贤公馆",
            "parent_code": null,
            "space_code": "100001027",
            "space_type": "COMMUNITY",
            "space_sort": "COMMUNITY",
            "org_code": "100000150100000000100000000",
            "business_type": 1,
            "src": 1,
            "org_id": 21909,
            "top_org_id": 21897,
            "top_org_code": "100000150",
            "status": 2,
            "area": null,
            "fee_area": null,
            "top_org_name": null,
            "hasRelated": null,
            "province": null,
            "city": null,
            "district": null,
            "detail": null,
            "lon": 0.0,
            "lat": 0.0,
            "children": null,
            "parent_name": null,
            "org_ids": null,
            "pageNo": 0,
            "pageSize": 0,
            "list": null,
            "org_id_name": null,
            "orgName": null,
            "authOrg": null,
            "orderby": null,
            "directChildrenNums": 0,
            "directZoneNums": 0,
            "directPhysicalSpaceNums": 0,
            "is_super": null,
            "orgCode": null,
            "_only_sub": true
        }
    ],
    "upperOrgAdmin": false
}

1.4 根据员工信息查询员工详情-微服务之间调用

请求信息

URL：/v1/iot/main/inner/admin/findByCondition

Method: POST

body: JSON格式约定

入参dto：

字段 字段类型 是否必填（默认否） 是否唯一（默认否） 说明
id Long 否 员工id
job_number String 否 账号

出参dto：

字段 字段类型 说明
id Long 员工id
org_id Long 行政组织ID，smart_cmty_org 外键
org_code String 行政组织编码
mobile String 手机号
src Integer 帐号来源，1：自研系统,2:4A
name String 姓名
sex Integer 性别1为女，2为男
status Integer 状态: 1为正常、2为注销
is_effective Integer 账号是否有效 1为启用、2为禁用
face_ico String 人脸, 存储图片相对路径
identity String 身份证
type Integer 1:物管用户，4:商户用户,8:平台管理用户
nickname String 昵称
ico String 头像
job_number String 账号
email String 邮箱
identity String 证件号
staff_no String 工号
position String 职务

请求示例：

{
    "id":23324
}

返回：

{
    "create_by": "system_insert",
    "update_by": null,
    "create_time": 1609975309000,
    "update_time": null,
    "id": 23324,
    "user_id": null,
    "org_id": 21896,
    "mobile": "13477889900",
    "org_code": "100000149",
    "src": 1,
    "nickname": "客户000040",
    "ico": null,
    "job_number": "zhuhy666",
    "pwd": "{bcrypt}$2a$10$Qzac5zlBH3VOAPY1lFO77ODhc19AzAKmEF6ZNhM8gQC.v3vDg3YH2",
    "name": "zhuhy666",
    "sex": null,
    "email": "13477889900@163.com",
    "identity": "430899199307289999",
    "type": 1,
    "status": 1,
    "last_login_time": null,
    "pwd_modify_time": null,
    "lock_time": null,
    "login_fail_times": null,
    "birthday": null,
    "last_login": null,
    "staff_no": "zhuhy666",
    "position": "java",
    "is_supper": 1,
    "face_ico": "",
    "is_effective": 1,
    "roleNames": null,
    "groupNames": null,
    "ids": null,
    "userIds": null,
    "relationId": null,
    "relationIds": null,
    "groupId": null,
    "adminOrgCodes": null,
    "adminIds": null,
    "pageNo": null,
    "pageSize": null,
    "client_id": null,
    "client_secret": null,
    "orgName": null,
    "fullOrgName": null,
    "org_type": null,
    "rel_org_id": null,
    "authOrgId": null,
    "communityId": null,
    "oldFlag": null
    "upperOrgAdmin": false
}

1.5获取权限范围（指定业务组织）内可得到项目空间集合--微服务调用

请求信息

服务名：iot-main-entry

URL： /v1/iot/main/inner/space/query/communitys

Method: POST

body: JSON格式约定

入参dto：

字段 字段类型 是否必填（默认否） 说明
org_code String 是 业务组织编码，用户数据权限控制的
status Integer 否 小区有效状态 1:有效 ;2:无效，默认为不根据status过滤

请求示例：

{
    "org_code":"901",
    "status":1
}

返回示例：

[
    {
      "id": 3280, //空间id 小区id
      "parentid": 1572, //空间父节点id
      "space_id": null, //4格系统空间id
      "parent_space_id": null,
      "community_id": null,//4格(小区)表主键
      "space_name": "16栋_1单元_2602", //空间名
      "full_space_name": "美的君兰江山（北滘）/16栋/1单元/26/16栋_1单元_2602", //空间全路径名称
      "parent_code": "1000101410001024",//父节点空间编码
      "space_code": "10001014100010241001",//空间编码
      "space_type": "HOUSE", //'空间类型(细分类)： COMMUNITY：小区、ZONE：片区、STRUCTURE:建筑物、BUILDING：楼栋、UNIT：单元、FLOOR：楼层、HOUSE：房屋、\r\nPARK:车场、PARK_NAME：车场名称、PARK_AREA:车场区域、PARK_SPACE:车位、PUBLIC_AREA:公共区域、PRIMARY_AREA:一级区域、SECONDARY_AREA:二级区域、THIRD_AREA:三级区域'
      "src": 1, //数据来源：1:自研平台，2：四格
      "org_id": null,//空间对应的 业务组织ID
      "status":1 ,//1:有效 ;2:无效
       "create_by": null,
      "update_by": null,
      "create_time": "2020-11-06T09:11:55.000+0000",
      "update_time": null,
    },
    ...
    ]

1.6 获取指定空间下指定类型空间集合--微服务调用

请求信息

服务名：iot-main-entry

URL： /v1/iot/main/inner/space/list/byIdAndType

Method: POST

body: JSON格式约定

入参dto：

字段 字段类型 是否必填（默认否） 说明
space_id Long 是 空间id
space_type String 是 '空间类型(细分类)： COMMUNITY：小区、ZONE：片区、STRUCTURE:建筑物、BUILDING：楼栋、UNIT：单元、FLOOR：楼层、HOUSE：房屋、\r\nPARK:车场、PARK_NAME：车场名称、PARK_AREA:车场区域、PARK_SPACE:车位、PUBLIC_AREA:公共区域、PRIMARY_AREA:一级区域、SECONDARY_AREA:二级区域、THIRD_AREA:三级区域',

请求示例：

{
"space_id":1003,
"space_type":"ZONE"
}

返回示例：

[
{
"full_space_name": "万锦熙岸花园/第一片区/建筑物/1座/第一单元/1",
"id": 22450,//空间id
"parent_code": "100001031100000000100000000100000000100000000",
"parentid": 22438,//父空间id
"space_code": "100001031100000000100000000100000000100000000100000000", //空间编码
"space_name": "1" //空间名
"space_sort": "STRUCTURE"//空间大分类
"space_type": "FLOOR",//空间细分类
"src": 1,//数据来源1：自研系统，2：4A系统'
"status": 1 //'空间状态：1:有效 ;2:无效'
}
]

1.7 获取指定房屋id集合的空间详细信息--微服务调用

请求信息

服务名：iot-main-entry

URL： /v1/iot/main/inner/space/detail/byIds

Method: POST

body: JSON格式约定

入参dto：

字段 字段类型 是否必填（默认否） 说明
space_ids List 是 房屋id集合

请求示例：

{
"space_ids":[1003,1002]
}

返回示例：

[
{
"communityId": 21441118,
"communityName": "领贤体验馆02",
"zoneId":1,
"zoneName":"片区1"
"buildId": 50410653,
"buildName":"1栋",
"unitId": 50410663,
"unit": "1单元",
"floorId": 50410665,
"floor": 2,
"houseId": 35650626,
"roomNo": "201",
"createTime": "2019-10-19T07:28:08.000+0000",
"name": "1栋_1单元_201",
"updateTime": "2020-12-30T06:36:19.000+0000",
"status": 1
}
]

1.8 获取当前用户的家庭列表以及家庭成员 --微服务调用

描述

请求信息

服务名：iot-app-service

HTTP协议：HTTP,HTTPS

uri：/v1/iot/app/inner/family/list

方法：POST

请求参数

名称 位置 类型 必填 描述
userId BODY LONG 是 用户id
houseId BODY LONG 否 房屋id
includeMember BODY STRING 否 是否展示家庭成员(1=是，其他值则不展示)

请求Body描述(非Form表单数据)

{
    "userId":15815,
    "houseId": 22492,
    "includeMember":1

}

返回信息

返回参数类型

JSON

返回参数

名称 位置 类型 描述
familys data JSONArray 响应数据对象
familyId data.familys[] LONG 家庭Id
familyName data.familys[] STRING 家庭名称
property data.familys[] STRING 关联产权房屋
rentStatus data.familys[] STRING 租赁状态
roleTag data.familys[] STRING 家庭角色:2业主，3业主成员，14租户，15租户成员
houseId data.familys[] STRING 房屋ID
houseName data.familys[] STRING 房屋名
custId data.familys[] LONG 客户id
communityId data.familys[] STRING 社区ID
communityName data.familys[] STRING 社区名称
status data.familys[] STRING 认证状态（1：已申请；2：已拒绝；3：迁出；4：认证成功）
realName data.familys[] STRING 用户真实名称
userId data.familys[] LONG 用户id
phone data.familys[] STRING 用户手机号
smartHomeHouseId data.familys[] LONG 智慧家居houseId
members data.familys[] JSONArray 家庭成员
profilePhoto members[] STRING 头像
userId members[] LONG 用户ID
userName members[] STRING 用户名（手机号）
realName members[] STRING 用户真实名
profilePhoto members[] STRING 用户头像
roleTag members[] STRING 家庭角色:2业主，3业主成员，14租户，15租户成员
nickName members[] STRING 用户昵称
mobile members[] STRING 用户手机号码
status members[] STRING 认证状态（1：已申请；2：已拒绝；3：迁出；4：认证成功）

返回结果示例

{
    "familys": [
        {
            "houseId": 22492,
            "userId": 15815,
            "familyId": 10589,
            "rentStatus": "normal",
            "houseName": "6A",
            "realName": "老朱",
            "createBy": 15788,
            "roleTag": 2,
            "phone": "13489993999",
            "familyName": "万锦熙岸花园万锦熙岸花园/第一片区/建筑物/1座/第一单元/6A",
            "members": [
                {
                    "realName": "怡珊",
                    "profilePhoto": "",
                    "roleTag": 2,
                    "nickName": "小美77946",
                    "mobile": "13620202020",
                    "userName": "13620202020",
                    "userId": 15788,
                    "status": "4"
                },
                {
                    "realName": "林松",
                    "profilePhoto": "",
                    "roleTag": 2,
                    "nickName": "小美74288",
                    "mobile": "13433443304",
                    "userName": "13433443304",
                    "userId": 15790,
                    "status": "4"
                }
            ],
            "property": "万锦熙岸花园/第一片区/建筑物/1座/第一单元/6A",
            "custId": 23021,
            "communityName": "万锦熙岸花园",
            "smartHomeHouseId": 323581,
            "communityId": 22372,
            "status": "4"
        }
    ]
}

1.9 根据用户id集合获取用户对象 --微服务调用

描述

请求信息

服务名：iot-app-service

HTTP协议：HTTP,HTTPS

uri：/v1/iot/app/inner/user/list/byIds

方法：POST

请求参数

名称 位置 类型 必填 描述
userIds BODY List 是 用户id集合

请求Body描述(非Form表单数据)

{
    "userIds":[15815,15839]
}

返回信息

返回参数类型

JSON

返回参数

返回结果示例

{
    "userInfos": [
        {
            "id": 15815,
            "mobile": "13489993999",
            "realName": "老朱",
            "nickName": "小美81104",
            "gender": null,
            "status": 1,
            "userDesc": null,
            "profilePhoto": null,
            "userName": "13489993999",
            "password": "41904bf0233e734b70c0915291edda0a4896c081f63c92d728836de9d61b7016393cb1c53eef6a0303c04c212465deda",
            "appId": "1120",
            "certiType": "",
            "certiNbr": "430421196902109999",
            "cancellTime": null,
            "typeCode": null,
            "userSrc": "smartCommunity",
            "outFlag": null,
            "src": 1,
            "createBy": "",
            "updateBy": "",
            "createTime": 1609839008000,
            "updateTime": 1609839008000
        },
        {
            "id": 15839,
            "mobile": "18988998801",
            "realName": "张嘉译",
            "nickName": "小美65411",
            "gender": null,
            "status": 1,
            "userDesc": null,
            "profilePhoto": null,
            "userName": "18988998801",
            "password": "6f0782303d769032b990e7d92515c7dcd3614ada7890e9d3ad8e5140ed7ef741393cb1c53eef6a0303c04c212465deda",
            "appId": "1120",
            "certiType": "",
            "certiNbr": "996633121212128888",
            "cancellTime": null,
            "typeCode": null,
            "userSrc": "smartCommunity",
            "outFlag": null,
            "src": 1,
            "createBy": "",
            "updateBy": "",
            "createTime": 1610071957000,
            "updateTime": 1610071957000
        }
    ]
}

2.0 根据用户id或者手机号+appId获取用户对象 --微服务调用

描述

请求信息

服务名：iot-app-service

HTTP协议：HTTP,HTTPS

uri：/v1/iot/app/inner/user/get/byCondition

方法：POST

请求参数

名称 位置 类型 必填 描述
userId BODY Long 否 用户id集合【和手机号+appId不可同时为空】
mobile BODY String 否 手机号【用户id为空时，手机号和appId均不能为空】
appId BODY String 否 appId【用户id为空时，手机号和appId均不能为空】

请求Body描述(非Form表单数据)

{
    "mobile":"13489993999",
    "appId":"1120"
}

返回信息

返回参数类型

JSON

返回参数

返回结果示例

{
    "id": 15815,
    "mobile": "13489993999",
    "realName": "老朱",
    "nickName": "小美81104",
    "gender": null,
    "status": 1,
    "userDesc": null,
    "profilePhoto": null,
    "userName": "13489993999",
    "password": "41904bf0233e734b70c0915291edda0a4896c081f63c92d728836de9d61b7016393cb1c53eef6a0303c04c212465deda",
    "appId": "1120",
    "certiType": "",
    "certiNbr": "430421196902109999",
    "cancellTime": null,
    "typeCode": null,
    "userSrc": "smartCommunity",
    "outFlag": null,
    "src": 1,
    "createBy": "",
    "updateBy": "",
    "createTime": 1609839008000,
    "updateTime": 1609839008000
}

2.1 根据空间id集合和空间类型查询指定空间下所有用户的认证通过的认证记录 --微服务调用

描述

请求信息

服务名：iot-app-service

HTTP协议：HTTP,HTTPS

uri：/v1/iot/app/inner/propertyauth/passed/list/bySpaceIdsAndSpaceType

方法：POST

请求参数

名称 位置 类型 必填 描述
spaceIds BODY List 是 空间id集合
spaceType BODY String 是 '空间类型(细分类)： COMMUNITY：小区、ZONE：片区、STRUCTURE:建筑物、BUILDING：楼栋、UNIT：单元、FLOOR：楼层、HOUSE：房屋、\r\nPARK:车场、PARK_NAME：车场名称、PARK_AREA:车场区域、PARK_SPACE:车位、PUBLIC_AREA:公共区域、PRIMARY_AREA:一级区域、SECONDARY_AREA:二级区域、THIRD_AREA:三级区域',
appId BODY Integer 是 appId
authTypes BODY List 否 家庭成员角色类型：2业主，3业主成员，14租户，15租户成员

请求Body描述(非Form表单数据)

{
    "spaceIds":[22438,23606,21916],
    "appId":1120,
    "spaceType":"UNIT",
    "authTypes":[2,3]
}

返回信息

返回参数类型

JSON

返回参数

返回结果示例

[
    15809,
    15810,
    15811,
    15812,
    15813,
    15814,
    15815,
    15816,
    15818,
    15819,
    15822,
    15823,
    15826,
    15764,
    15828,
    15831,
    15832,
    15833,
    15771,
    15772,
    15836,
    15837,
    15774,
    15646,
    15842,
    15843,
    15845,
    15850,
    15786,
    15788,
    15790,
    15792,
    15793,
    15794,
    15795,
    15860,
    15608,
    15611,
    15869
]

2.2 根据分组id查询该分组下的人员 --微服务调用

描述

请求信息

服务名：iot-main-entry

HTTP协议：HTTP,HTTPS

uri：/v1/iot/main/inner/admin/list/byGroupId

方法：POST

请求参数

名称 位置 类型 必填 描述
groupId BODY Long 是 分组id

请求Body描述(非Form表单数据)

{
    "groupId":1
}

返回信息

返回参数类型

JSON

返回参数

返回结果示例

[
     {
            "create_by": null,
            "update_by": null,
            "create_time": null,
            "update_time": null,
            "id": 8843,//员工id
            "user_id": 1,
            "org_id": 6419,//员工所属行政组织数据
            "mobile": "13418778765",//员工手机号
            "org_code": "101",//员工所属行政组织编码
            "src": 2,//数据来源 ，1：自研系统,2:4A
            "nickname": "依依1",//昵称
            "ico": "ico_url",//头像
            "job_number": "zhuhy51",//员工登陆账号
            "pwd": "111111",//员工登陆密码
            "name": "易依依",//员工名
            "sex": 1,//性别1为女，2为男
            "email": "13418777777@163.com",//邮件
            "identity": "430421199307280011",//证件号
            "type": 1,//用户类型: 1:物管用户，4:商户用户,8:平台管理用户
            "status": 1,//状态: 1为正常、2为注销
            "staff_no": "20351134",//工号
            "position": "java开发",//岗位
            "is_supper": 0
     },
     {...}
]

2.3 根据分组id查询该分组 --微服务调用

描述

请求信息

服务名：iot-main-entry

HTTP协议：HTTP,HTTPS

uri：/v1/iot/main/inner/admin/findGroup

方法：POST

请求参数

名称 位置 类型 必填 描述
groupId BODY Long 是 分组id

请求Body描述(非Form表单数据)

{
    "groupId":27478
}

返回信息

返回参数类型

JSON

返回参数

返回结果示例

{
    "create_by": "system",
    "update_by": null,
    "create_time": 1610754741000,
    "update_time": null,
    "id": 27478,
    "group_name": "云景清洁队",
    "business_org_id": 26211,
    "business_org_code": "100000150100000000100000003100000005",
    "pageNo": null,
    "pageSize": null,
    "communityId": null
}

results matching ""

    No results matching ""