睿智云平台主数据API

说明： 睿智云平台主数据的前身请参见：主数据PI ， 本API集部分API来源于主数据PI ， 如两者有重复的地方，请以本API为准 。 由于部分接口延用了之前的API, 故返回结果需要严格按照实际的结果处理。

相关的SQL语句：

https://confluence.mideazy.com/pages/viewpage.action?pageId=222625816

http://arch.smartmideazy.com/apidoc/main-entry/any-pay.html 文档已更新 @李小勇

主数据API列表

1 项目管理

1.1 项目地址新增/修改

说明： 项目地址新增接口也可以达到项目地址修改的效果。建议使用此接口完成项目地址的新增和修改。

描述 新增项目地址, 一个小区空间(space_type=COMMUNITY)对应一个地址信息

请求信息

URL：/v1/iot/main/spacelocation/add

METHOD： POST

body: JSON格式约定

请求示例：

{ "msgId":"ca181c23-03be-22a4-7c95-33502a3962f2","province":"广东省","city":"佛山市","district":"顺德区","lon":113.187862,"lat":22.892,"detail":"广东省佛山市顺德区北滘镇三江线test","area":110,"space_id":86597, "shift_times_json":  [ {"begin_time": "09:00",  "end_time": "12:00"  }],  "contact_tels_json":  [ {"area_no": "0757",  "tel": "28102910"  },  {"area_no": "0757",  "tel": "28102911"  }] }

返回示例：

{
  "code": "200",
  "message": "成功",
  "version": null,
  "returnExceptionData": false,
  "result": {
    "id": 86598,
    "province": "广东省",
    "city": "佛山市",
    "district": "顺德区",
    "detail": "广东省佛山市顺德区北滘镇三江线test",
    "lon": 113.187862,
    "lat": 22.892,
    "space_id": 86597,
    "ico": null,

    "contact_tels_json": [
      {
        "area_no": "0757",
        "tel": "28102910"
      },
      {
        "area_no": "0757",
        "tel": "28102911"
      }
    ],
    "shift_times_json": [
      {
        "begin_time": "09:00",
        "end_time": "12:00"
      }
    ]
  },
  "data": null
}

1.2 项目地址修改

描述 修改项目地址, 一个小区空间(space_type=COMMUNITY)对应一个地址信息。 此接品即将作废。

请求信息

URL：/v1/iot/main/spacelocation/edit

METHOD： POST

body: JSON格式约定

请求示例：

{"id": 123, space_id": 3429, "province": "AA", "city": "BB" , "district": "12333", "lon": 123.46, "lat": 123.56 , "detail": "AAC"， "shift_times_json":  [ {"start_time": "09:00",  "end_time": "12:00"  },   "contact_tels_json":  [ {"area_no": "0757",  "tel": "28102910"  },  {"area_no": "0757",  "tel": "28102910"  }, ...  ]

返回示例：

{
  "code":"200",
  "message": "成功",
  "result": {
    "id": 8825,
    "province": "AA",
    "city": "BB",
    "district": "12333",
    "detail": "AAC",
    "lon": 123.46,
    "lat": 123.56,
    "space_id": 3429,
    "ico":"dfdjkd"， 
     "contact_tels_json":  [ {"area_no": "0757",  "tel": "28102910"  },  {"area_no": "0757",  "tel": "28102910"  }, ...  ],

    "shift_times_json":  [ {"start_time": "09:00",  "end_time": "12:00"  },  {"start_time":    "14:00",  "end_time": "17:00"  }, ...  ]
  }
}

1.3 项目详情

描述 由项目ID加载出项目的详情，用于编辑加载或详情展示

请求信息

本接口更新后返回值多出 contact_tels_json， shift_times_json 两个字段。

URL：/v1/iot/main/space/detail/community/{id}

METHOD： POST

body: 空

路径参数：

id : 空间主键ID

返回：

1.3 新增、修改员工

请求信息

URL：/v1/iot/main/admin/update

Method: POST

body: JSON格式约定

2 客户管理

2.1 由业务组织org_code获取所有的项目列表

请求信息

URL：/v1/iot/main/customer/house/relation/query/communitys

Method: POST

body: JSON格式约定

请求示例：

{
    "org_code":"901",
    "space_name":"花园"
}

返回示例：

{
  "code":"200",
  "message": "成功",
  "result": [
    {
      "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
       "create_by": null,
      "update_by": null,
      "create_time": "2020-11-06T09:11:55.000+0000",
      "update_time": null,
      "directZoneNums": 0, //片区数量
    },
    ...
    ],

   "pageNo": 1,
  "totalPage": 96,
  "total": 1919,
  "pageSize": 20,
  "type": null
}

或

{
    "code":"200",
    "message": "成功",
    "result": [
        {
            "create_by": null,
            "update_by": null,
            "create_time": "2020-11-07T10:21:57.000+0000",
            "update_time": "2020-11-11T05:59:25.000+0000",
            "id": 9885,
            "parentid": null,
            "space_id": null,
            "parent_space_id": null,
            "community_id": null,
            "space_name": "简岸花园",
            "full_space_name": "简岸花园",
            "parent_code": null,
            "space_code": "1000",
            "space_type": "COMMUNITY",
            "space_sort": "COMMUNITY",
            "src": 1,
            "org_id": 9103,
            "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
        },
        {
            "create_by": null,
            "update_by": null,
            "create_time": "2020-11-07T10:21:57.000+0000",
            "update_time": "2020-11-11T05:59:25.000+0000",
            "id": 9887,
            "parentid": null,
            "space_id": null,
            "parent_space_id": null,
            "community_id": null,
            "space_name": "海岸花园",
            "full_space_name": "海岸花园",
            "parent_code": null,
            "space_code": "1002",
            "space_type": "COMMUNITY",
            "space_sort": "COMMUNITY",
            "src": 1,
            "org_id": 9104,
            "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
        }
    ],
    "pageNo": 0,
    "pageSize": 0,
    "total": 0,
    "totalPage": 0
}

2.2 由小区ID查询一棵空间树

描述 ： 根据空间节点的主键ID返回一个树型JSON

请求信息

URL：/v1/iot/main/space/tree/{id}

METHOD： POST

路径参数：

请求示例：

/v1/iot/main/space/tree/17

返回示例：

{
  "code":"200",
  "message": "成功",
  "result": [
    {
      "create_time": null,
      "create_by": null,
      "update_time": null,
      "update_by": null,
      "id": 17,
      "parentid": null,
      "space_id": null,
      "space_name": "美的君兰江山",
      "full_space_name": "美的君兰江山",
      "parent_code": null,
      "space_code": "1000",
      "space_type": "COMMUNITY",
      "src": 1,
      "children": [
        {
          "create_time": null,
          "create_by": null,
          "update_time": null,
          "update_by": null,
          "id": 18,
          "parentid": 17,
          "space_id": null,
          "space_name": "美的君兰江山一期A",
          "full_space_name": "美的君兰江山/美的君兰江山一期A",
          "parent_code": "1000",
          "space_code": "10001001",
          "space_type": "COMMUNITY",
          "src": 1,
          "children": null,
          "parent_name": null
        }
      ],
      "parent_name": null
    }
  ],
  "pageNo": 0,
  "totalPage": 0,
  "total": 0,
  "pageSize": 0
}

2.3 客户信息列表

描述 ： 此接口已调整，请注意。

请求信息

URL：/v1/iot/main/customer/houseAndCustomers

Method: POST

body: JSON格式约定

入参dto：

请求示例：

{"org_code": "100000001100000000", "pageSize": 25}

返回示例：

{
  "code": "200",
  "data": {
    "result": [
      {
        "id": 87759,
        "customer_name": "肖扬",
        "customer_phone": "18819450802",
        "identity": "410100198809040802",
        "space_name": "201",
        "sex": null,
        "identity_type": 1,
        "customer_properties": 1,
        "type": 1,
        "sex_trans": null,
        "identity_type_trans": null,
        "customer_properties_trans": null,
        "type_trans": null
      },
      {
        "id": 21814,
        "customer_name": "66666",
        "customer_phone": "13455666666",
        "identity": "666666199008086666",
        "space_name": "501",
        "sex": 1,
        "identity_type": 1,
        "customer_properties": 1,
        "type": 1,
        "sex_trans": null,
        "identity_type_trans": null,
        "customer_properties_trans": null,
        "type_trans": null
      },
      {
        "id": 21814,
        "customer_name": "66666",
        "customer_phone": "13455666666",
        "identity": "666666199008086666",
        "space_name": "车位1",
        "sex": 1,
        "identity_type": 1,
        "customer_properties": 1,
        "type": 2,
        "sex_trans": null,
        "identity_type_trans": null,
        "customer_properties_trans": null,
        "type_trans": null
      },
      {
        "id": 21814,
        "customer_name": "66666",
        "customer_phone": "13455666666",
        "identity": "666666199008086666",
        "space_name": "302",
        "sex": 1,
        "identity_type": 1,
        "customer_properties": 1,
        "type": 1,
        "sex_trans": null,
        "identity_type_trans": null,
        "customer_properties_trans": null,
        "type_trans": null
      },
      {
        "id": 21814,
        "customer_name": "66666",
        "customer_phone": "13455666666",
        "identity": "666666199008086666",
        "space_name": "203",
        "sex": 1,
        "identity_type": 1,
        "customer_properties": 1,
        "type": 1,
        "sex_trans": null,
        "identity_type_trans": null,
        "customer_properties_trans": null,
        "type_trans": null
      },
      {
        "id": 21814,
        "customer_name": "66666",
        "customer_phone": "13455666666",
        "identity": "666666199008086666",
        "space_name": "104",
        "sex": 1,
        "identity_type": 1,
        "customer_properties": 1,
        "type": 1,
        "sex_trans": null,
        "identity_type_trans": null,
        "customer_properties_trans": null,
        "type_trans": null
      },
      {
        "id": 21814,
        "customer_name": "66666",
        "customer_phone": "13455666666",
        "identity": "666666199008086666",
        "space_name": "101",
        "sex": 1,
        "identity_type": 1,
        "customer_properties": 1,
        "type": 1,
        "sex_trans": null,
        "identity_type_trans": null,
        "customer_properties_trans": null,
        "type_trans": null
      },
      {
        "id": 21814,
        "customer_name": "66666",
        "customer_phone": "13455666666",
        "identity": "666666199008086666",
        "space_name": "401",
        "sex": 1,
        "identity_type": 1,
        "customer_properties": 1,
        "type": 1,
        "sex_trans": null,
        "identity_type_trans": null,
        "customer_properties_trans": null,
        "type_trans": null
      },
      {
        "id": 21814,
        "customer_name": "66666",
        "customer_phone": "13455666666",
        "identity": "666666199008086666",
        "space_name": "202",
        "sex": 1,
        "identity_type": 1,
        "customer_properties": 1,
        "type": 1,
        "sex_trans": null,
        "identity_type_trans": null,
        "customer_properties_trans": null,
        "type_trans": null
      },
      {
        "id": 21814,
        "customer_name": "66666",
        "customer_phone": "13455666666",
        "identity": "666666199008086666",
        "space_name": "301",
        "sex": 1,
        "identity_type": 1,
        "customer_properties": 1,
        "type": 1,
        "sex_trans": null,
        "identity_type_trans": null,
        "customer_properties_trans": null,
        "type_trans": null
      },
      {
        "id": 21814,
        "customer_name": "66666",
        "customer_phone": "13455666666",
        "identity": "666666199008086666",
        "space_name": "102",
        "sex": 1,
        "identity_type": 1,
        "customer_properties": 1,
        "type": 1,
        "sex_trans": null,
        "identity_type_trans": null,
        "customer_properties_trans": null,
        "type_trans": null
      },
      {
        "id": 21814,
        "customer_name": "66666",
        "customer_phone": "13455666666",
        "identity": "666666199008086666",
        "space_name": "305",
        "sex": 1,
        "identity_type": 1,
        "customer_properties": 1,
        "type": 1,
        "sex_trans": null,
        "identity_type_trans": null,
        "customer_properties_trans": null,
        "type_trans": null
      },
      {
        "id": 21814,
        "customer_name": "66666",
        "customer_phone": "13455666666",
        "identity": "666666199008086666",
        "space_name": "101",
        "sex": 1,
        "identity_type": 1,
        "customer_properties": 1,
        "type": 1,
        "sex_trans": null,
        "identity_type_trans": null,
        "customer_properties_trans": null,
        "type_trans": null
      },
      {
        "id": 21814,
        "customer_name": "66666",
        "customer_phone": "13455666666",
        "identity": "666666199008086666",
        "space_name": "306",
        "sex": 1,
        "identity_type": 1,
        "customer_properties": 1,
        "type": 1,
        "sex_trans": null,
        "identity_type_trans": null,
        "customer_properties_trans": null,
        "type_trans": null
      },
      {
        "id": 21814,
        "customer_name": "66666",
        "customer_phone": "13455666666",
        "identity": "666666199008086666",
        "space_name": "201",
        "sex": 1,
        "identity_type": 1,
        "customer_properties": 1,
        "type": 1,
        "sex_trans": null,
        "identity_type_trans": null,
        "customer_properties_trans": null,
        "type_trans": null
      },
      {
        "id": 21814,
        "customer_name": "66666",
        "customer_phone": "13455666666",
        "identity": "666666199008086666",
        "space_name": "103",
        "sex": 1,
        "identity_type": 1,
        "customer_properties": 1,
        "type": 1,
        "sex_trans": null,
        "identity_type_trans": null,
        "customer_properties_trans": null,
        "type_trans": null
      },
      {
        "id": 21427,
        "customer_name": "王翦",
        "customer_phone": "18900222333",
        "identity": "889977333312234444",
        "space_name": "2E",
        "sex": 2,
        "identity_type": 1,
        "customer_properties": 1,
        "type": 1,
        "sex_trans": null,
        "identity_type_trans": null,
        "customer_properties_trans": null,
        "type_trans": null
      },
      {
        "id": 21427,
        "customer_name": "王翦",
        "customer_phone": "18900222333",
        "identity": "889977333312234444",
        "space_name": "zt102",
        "sex": 2,
        "identity_type": 1,
        "customer_properties": 1,
        "type": 2,
        "sex_trans": null,
        "identity_type_trans": null,
        "customer_properties_trans": null,
        "type_trans": null
      },
      {
        "id": 21411,
        "customer_name": "李静",
        "customer_phone": "13344552211",
        "identity": "445533444211223333",
        "space_name": "203",
        "sex": null,
        "identity_type": 1,
        "customer_properties": 1,
        "type": 1,
        "sex_trans": null,
        "identity_type_trans": null,
        "customer_properties_trans": null,
        "type_trans": null
      },
      {
        "id": 21409,
        "customer_name": "哈哈哈",
        "customer_phone": "13222338884",
        "identity": "445533222211223333",
        "space_name": "测试产权车位",
        "sex": 1,
        "identity_type": 1,
        "customer_properties": 1,
        "type": 2,
        "sex_trans": null,
        "identity_type_trans": null,
        "customer_properties_trans": null,
        "type_trans": null
      },
      {
        "id": 21405,
        "customer_name": "王莽",
        "customer_phone": "13455665544",
        "identity": "112233111111112222",
        "space_name": "203",
        "sex": 2,
        "identity_type": 1,
        "customer_properties": 1,
        "type": 1,
        "sex_trans": null,
        "identity_type_trans": null,
        "customer_properties_trans": null,
        "type_trans": null
      },
      {
        "id": 20277,
        "customer_name": "良良",
        "customer_phone": "13100000008",
        "identity": "450881200002206020",
        "space_name": "103",
        "sex": 1,
        "identity_type": 1,
        "customer_properties": 1,
        "type": 1,
        "sex_trans": null,
        "identity_type_trans": null,
        "customer_properties_trans": null,
        "type_trans": null
      },
      {
        "id": 20277,
        "customer_name": "良良",
        "customer_phone": "13100000008",
        "identity": "450881200002206020",
        "space_name": "203",
        "sex": 1,
        "identity_type": 1,
        "customer_properties": 1,
        "type": 1,
        "sex_trans": null,
        "identity_type_trans": null,
        "customer_properties_trans": null,
        "type_trans": null
      },
      {
        "id": 20277,
        "customer_name": "良良",
        "customer_phone": "13100000008",
        "identity": "450881200002206020",
        "space_name": "1A",
        "sex": 1,
        "identity_type": 1,
        "customer_properties": 1,
        "type": 1,
        "sex_trans": null,
        "identity_type_trans": null,
        "customer_properties_trans": null,
        "type_trans": null
      },
      {
        "id": 20277,
        "customer_name": "良良",
        "customer_phone": "13100000008",
        "identity": "450881200002206020",
        "space_name": "202",
        "sex": 1,
        "identity_type": 1,
        "customer_properties": 1,
        "type": 1,
        "sex_trans": null,
        "identity_type_trans": null,
        "customer_properties_trans": null,
        "type_trans": null
      }
    ],
    "total": 25,
    "pageNo": 1,
    "totalPage": 1,
    "pageSize": 25
  },
  "message": "success"
}

2.3 客户信息新增、修改

https://biz-admin-sit.smartmideazy.com/v1/iot/main/customer/updateCustomerAndHouses

method: POST

请求body

客户关联的产权对象CustomerHouseRel 属性如下：

业务组织对象customerOrgRel 属性如下：

2.4 客户信息加载

一次性加载出用户的基础信息和所关联的业务组织、所认证的产权。对于已信息认证的产权，前端不允许修改。

https://biz-admin-sit.smartmideazy.com/v1/iot/main/customer/customerAndHouses/load/{id}?type=edit

method: GET

路径参数：

id: customer 客户表的主键ID

请求参数：type: 当type=edit表示编辑接口，type为空代表详情加载。 详情加载时返回客户所所有的房产信息，包括迁出状态的房产；ype=edit表示编辑接口时，返回的房产信息不会包括迁出状态的房产。

返回数据及字段：

产权对象CustomerHouseRel 属性如下：

注: 若在修改客户资料时，此值为空集合，代表解除客户与房产已有的关联关系。

业务组织对象customerOrgRel 属性如下：

2.5 由手机号查询社区APP用户和客户信息

https://biz-admin-sit.smartmideazy.com/v1/iot/main/customer/getUserInfo

method: POST

请求body

返回：

{

    "code": "200",

   "essage":"success",

   "data": {

         "app_user": {"id":xxx, ....  },

       "customers": [{"id":XXX, "customer_phone" :XXX, "customer_properties":XX,  ... }, ...             {"id":XXX,  "customer_phone" :XXX, "customer_properties":XX,  ... }  ]

   }



}

返回字段：

app_user: 返回一条手机号对应的APP用户信息

customers: 返回同一手机号对应的多条客户集合， 以下是必须展示字段

2.6 信息认证

说明 ： 信息认证即保存客户、产权（房屋或车位）、和社区APP三者的关联关系 。

https://biz-admin-sit.smartmideazy.com/v1/iot/main/customer/custHouseApp/rel/update

method: POST

请求body

返回 ：

{

​ "code":"200",

​ "message":"success"

}

2.7 查询产权是否已被信息认证

说明 ：

https://biz-admin-sit.smartmideazy.com/v1/iot/main/customer/auth/status

method: POST

请求body

已认证：如果已认证，返回true

返回 ：

{

​ "code":"200",

​ "message":"success",

​ "data": true

}

3 租户管理

3.1 新增租户

/v1/iot/main/house/lease/saveOrUpdate

method: POST

请求body

入参dto：

说明：

请求示例：

{
 "house_id":"房屋id",
 "customer_id":"客户id",
 "person_name":"承租人",
 "contact_phone":"联系电话",
 "start_time":"承租开始时间",
 "end_time":"承租结束时间",
 "operater":"操作人",
 "lease_status":"承租状态 1承租2退租",
 "remark":"备注"
}

退租示例:

{
  "id": 89551,
  "lease_status": 2
}

返回示例：

{
    "code": 200,
    "data": {
        "id": 89551,
        "house_id": 1000,
        "customer_id": 10001,
        "person_name": "承租人",
        "contact_phone": "1800000001",
        "start_time": 1636675200000,
        "end_time": 1639267200000,
        "operater": "操作人",
        "lease_status": 1,
        "remark": "备注备注备注备注备注备注备注备注备注",
        "created_by": null,
        "created_time": null,
        "updated_by": null,
        "updated_time": null
    },
    "message": "success"
}

3.2 查询租户

/v1/iot/main/house/lease/get/{id}

method: GET

请求body

入参dto：

说明：

请求示例：

返回示例：

{
    "code": 200,
    "data": {
        "id": 89551,
        "house_id": 1000,
        "customer_id": 10001,
        "person_name": "承租人",
        "contact_phone": "1800000001",
        "start_time": 1636675200000,
        "end_time": 1639267200000,
        "operater": "操作人",
        "lease_status": 1,
        "remark": "备注备注备注备注备注备注备注备注备注",
        "created_by": null,
        "created_time": null,
        "updated_by": null,
        "updated_time": null
    },
    "message": "success"
}

3.3 租户列表

/v1/iot/main/house/lease/list

method: POST

请求body

入参dto：

说明：

请求示例：

{ 
    "id": 89551,
    "house_id": 1000,
    "customer_id": 10001,
    "person_name": "承租人",
    "contact_phone": "1800000001",
    "start_time": 1636646400000,
    "end_time": 1639238400000,
    "operater": "操作人",
    "lease_status": 1,
    "remark": "备注备注备注备注备注备注备注备注备注",
    "created_by": null,
    "created_time": null,
    "updated_by": null,
    "updated_time": null
}

返回示例：

{
    "code": 200,
    "data": {
        "result": [
            {
                "id": 89551,
                "house_id": 1000,
                "customer_id": 10001,
                "person_name": "承租人",
                "contact_phone": "1800000001",
                "start_time": 1636646400000,
                "end_time": 1639238400000,
                "operater": "操作人",
                "lease_status": 1,
                "remark": "备注备注备注备注备注备注备注备注备注",
                "created_by": null,
                "created_time": null,
                "updated_by": null,
                "updated_time": null
            }
        ]
    },
    "message": "success"
}

3.4 租户删除

/v1/iot/main/house/lease/delete/{id}

method: DELETE

请求body

入参dto：

说明：

请求示例：

返回示例：

{
    "code": 200,
    "data": {

    },
    "message": "success"
}

3.5 租户分页

/v1/iot/main/house/lease/page/{pageNo}/{pageSize}

method: POST

请求body

入参dto：

说明：

请求示例：

{
                "id": 89551,
                "house_id": 1000,
                "customer_id": 10001,
                "person_name": "承租人",
                "contact_phone": "1800000001",
                "start_time": 1636646400000,
                "end_time": 1639238400000,
                "operater": "操作人",
                "lease_status": 1,
                "remark": "备注备注备注备注备注备注备注备注备注",
                "created_by": null,
                "created_time": null,
                "updated_by": null,
                "updated_time": null
            }

返回示例：

{
    "code": 200,
    "data": {
        "total": "100",
        "result": [
            {
                "id": 89551,
                "house_id": 1000,
                "customer_id": 10001,
                "person_name": "承租人",
                "contact_phone": "1800000001",
                "start_time": 1636646400000,
                "end_time": 1639238400000,
                "operater": "操作人",
                "lease_status": 1,
                "remark": "备注备注备注备注备注备注备注备注备注",
                "created_by": null,
                "created_time": null,
                "updated_by": null,
                "updated_time": null
            }
        ]
    },
    "message": "success"
}

3.6 批量新增租户

/v1/iot/main/house/lease/batch/saveOrUpdate

method: POST

请求body

入参dto：

说明：

请求示例：

[{
 "house_id":"房屋id",
 "customer_id":"客户id",
 "person_name":"承租人",
 "contact_phone":"联系电话",
 "start_time":"承租开始时间",
 "end_time":"承租结束时间",
 "operater":"操作人",
 "lease_status":"承租状态 1承租2退租",
 "remark":"备注",
 "attachment": "[{}]"
}]

退租示例:

[{
  "id": 89551,
  "lease_status": 2
}]

返回示例：

{
    "code": 200,
    "data": {

    },
    "message": "success"
}

3.7 由员工查所有的角色

URL: /platform/org/roles/{admin_id}

method: GET

路径变量：

admin_id: 长整型 ，员工表主键ID

返回值 ：

{
   "code":"200",
   "message":"success",

    "data": {

        "result": [
            {"role_id": 99, "role_name": "技术人员",  "full_org_name":"美的置业/智慧生活研究院/软件开发部"}, ...


        ]


    }




}

4 入伙管理

4.1 入伙新增/修改

/v1/iot/main/customer/join

method: POST

请求body

list集合中的JSONObject属性如下 ：

返回示例 ：

 {
 "code":"200",
 "message":"success",
 "data":  {

      "result": [{客户房产关系记录对象}, {}]

 }




 }

4.2 房产迁出

/v1/iot/main/customer/move

method: POST

请求body

返回示例 ：

 {
 "code":"200",
 "message":"success",
 "data":  {

      "result": [{客户房产关系记录对象}, {}]

 }




 }

4.3 房产过户

/v1/iot/main/customer/transfer

method: POST

请求body

新业主对象customer

请求示例 ：

{"house_id":1109, "list":[ {"customer_id":1102,  "transfer_date":"2021-12-09"},   {"customer_id":1109,  "transfer_date":"2021-12-09"}, .....  ]}

4.2 房产详情

URL: /v1/iot/main/customer/join/history/{house_id}

描述 ： 根据房产ID查询房产信息及历史客户信息

method: GET

路径参数

返回示例 ：

{
  "code": "200",
  "data": {

    "list": [
      {
        "customer_type": 2,
        "housing_status": 1000,
        "full_space_name": "万科水晶城1/一级空间小区/建筑物/04金碧/第一单元/19/1901",
        "customer_phone": "13570496384",
        "transfer_date": null,
        "move_date": null,
        "space_name": "1901",
        "customer_name": "老立",
        "customer_id": 110414,
        "update_by": null,
        "space_id": 96627,
        "notify_date": null
      }
    ],
    "house": {
      "space_name": "1901",
      "full_space_name": "万科水晶城1/一级空间小区/建筑物/04金碧/第一单元/19/1901",
      "join_status": 1,
      "space_id": 96627
    }
  },
  "message": "成功"
}

房屋信息 house参见下表：

历史业主集合list 各字段参见：

当 history = true时 list集合代表历史的业主集合；

当 history = false 时 list集合代表非历史的业主集合；

4.3 搜索客户信息

/v1/iot/main/house/join/customer/search

描述 ： 数据实现多租户隔离，全局切换业务组织必填，平台将实现数据鉴权。如：只能搜索出用户所在的顶级业务组织下的客户。

method: PUT

请求body

list集合中的JSONObject属性如下 ：

4.4 出租管理附件上传

见： http://arch.smartmideazy.com/apidoc/common/file-service.html#16

5 生日提醒 - 由项目ID查询当天生日的社区用户

URL: /v1/iot/main/platform/app/birthday/users

描述：

Method: PUT

Body 属性：

返回 ：示例

{
  "code": "200",
  "data": {
    "result": [
      { 用户信息 }, ...

         ]
    }
  }