1. 设备台账管理API

API列表

API调用

1.0: 加载参数及部件信息

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：/v1/iot/device/stock/load/info

方法：POST

请求参数

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

{
    typeId:'123',
    spaceCode:'12233'
}

返回信息

返回参数类型

JSON

返回参数

返回结果示例

{
    "code": 200,
    "data": {
        "typeName": "测试090989",
        "updateTime": null,
        "dir": "279-280-304",
        "params": [
            {
                "fieldName": "电机大小种类",
                "notNull": 1,
                "selectValue": "",
                "id": 2,
                "fieldType": "text",
                "orgId": "1",
                "fieldId": 2
            }
        ],
        "name": "风扇鑫111",
        "orgId": "50541",
        "typeCode": "CSYRENAME-`CS1.1RENAME-3",
        "createBy": null,
        "unit": "个",
        "createTime": "2021-10-13 08:53:19",
        "updateBy": null,
        "domainSystem": "测试一rename-`测试1.1rename",
        "figureType": 1,
        "parts": [],
        "id": 46,
        "settingId": 304
    },
    "message": "success"
}

API调用

1.1: 新增台账

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：/v1/iot/device/stock/new

方法：POST

请求参数

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

{
  typeId:,
  typeName:“生活水泵”,
  spacePos:"1栋1单元1层",
  spacePosCode:'11011011010101010122',
  orgId : "123",
  netPos:"中国电信广东",
spaceName:'1号公馆',
spaceCode:'11110222',
  posMark:"xxx",  
  name:"风扇",
"brand": "品牌1",
"model":"型号a",
"figureType", 1,
"count": 23,
  startTime : '2020-01-02',
  expireTime : '2023-01-02',
    params:[{
            "fieldId":"11",
            "paramValue":"xx牌水泵",
            "fieldName":"品牌"
            },{
            "fieldId":"11",
            "paramValue":"2021-5-4",
            "fieldName":"日期"
            },{
            "fieldId":"11",
            "paramValue":"低耗",
            "fieldName":"能耗"
            }],
  parts:[
    {
      "partName":"定子绕组" ,
      "partValue":"参数文案"
    }, {
       "partName":"质量",
        "partValue":"参数文案"
    }]
}

返回信息

返回参数类型

JSON

返回参数

返回结果示例

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

1.2: 台账更新

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：/v1/iot/device/stock/edit

方法：POST

请求参数

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

{
    id:12,
    version:12,
  startTime : '2020-01-02',
  expireTime : '2023-01-02',
  spacePos:"1栋1单元1层",
  spacePosCode:'11011011010101010122',
  "brand": "品牌1",
  "model":"型号a",
  "figureType", 1,
  "count": 23,
    params:[{
            "id":36,
            "typeId":"11",
            "fieldName":"品牌",
            "fieldType":"text", 
            "notNull":"2",
            "paramValue":"xx牌水泵"
            },{
            "id":13,
            "typeId":"11",
            "fieldName":"启动日期",
            "fieldType":"date", 
            "notNull":"1",
            "paramValue":"2021-5-4"
            },{
            "id":14,
            "typeId":"11",
            "fieldName":"耗能",
            "fieldType":"select", 
            "select":"低耗,高耗",
            "paramValue":"低耗",
            "notNull":"1"
            }],
  parts:[
    {
      "id":54,
      "partName":"定子绕组" ,
      "partValue":"参数文案"
    }, {
        "id":44,
       "partName":"质量",
        "partValue":"参数文案"
    }]
}

返回信息

返回参数类型

JSON

返回参数

返回结果示例

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

1.3: 台账分页查询

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：/v1/iot/device/stock/page-list

方法：POST

请求参数

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

{
    pageNo:1,
    pageSize:10,
    orgId : "123",
    deviceStatus: [1, 2, 3],
    name: "xx电梯",
    spaceName:"xx项目",
    figureType:1,
    spaceCode:"1232",
    spacePos:"1栋2层4号",
    typeId:12
}

返回信息

返回参数类型

JSON

返回参数

返回结果示例

{
  "code": "200",
  "message": "success",
  "data": {
    page:2,
    size:10,
    total:200,
    records:[
        {
            id:11,
            version:12,
            stockCode:"BJ-XAA-ZZZ-01",
            deviceStatus:1,
            area:"华北",    
            spaceName:'王府一号',
            spaceCode:'123',
            name:"x水泵",
            spacePos:"1栋1单元1层",
            domainSystem:"给排水-给水系统",
            "brand": "品牌1",
            "model":"型号a",
            "figureType", 1,
            "count": 23,
        }
]}
}

1.4: 台账明细

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：/v1/iot/device/stock/detail

方法：POST

请求参数

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

{
 id:1
}

返回信息

返回参数类型

JSON

返回参数

返回结果示例

{
  code:200,
  message:"success",
  data:{
        id:11,
        stockCode:"BJ-XAA-ZZZ-01",
        deviceStatus:1,
        spaceName:'王府一号',
        name:"x水泵",
        version:12,
        spacePos:"1栋1单元1层",
        area:"华北",    
        netPos:"中国电信广东",
          posMark:"xxx",  
        quitTime:"2021-7-6 :10:00:00",
        quitMark:"设备无法运行",
        isSmart: "2",
          "brand": "品牌1",
          "model":"型号a",
          "figureType", 1,
          "count": 23,
        params:[{
                "typeId":"11",
                "fieldName":"品牌",
                "fieldType":"text",  
                "paramValue":"xx牌水泵"
                },{
                "typeId":"11",
                "fieldName":"启动日期",
                "fieldType":"date",  
                "paramValue":"2021-5-4"
                },{
                "typeId":"11",
                "fieldName":"耗能",
                "fieldType":"select", 
                "select":"低耗,高耗",
                "paramValue":"低耗", 
                }]
    parts:[
        {
        "partName":"定子绕组" ,
        "partValue":"参数文案"
        }, {
        "partName":"质量",
            "partValue":"参数文案"
        }]

  }
}

1.5: 台账报停

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：/v1/iot/device/stock/quit

方法：POST

请求参数

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

{ 
    id:"12",
    quitTime:"2020-12-12 10:00:00",
    startTime:"2021-12-12 10:00:00",
    version:12,
    quitReason:"用不了"
}

返回信息

返回参数类型

JSON

返回参数

返回结果示例

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

1.6: 台账批量报停

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：/v1/iot/device/stock/bat-quit

方法：POST

请求参数

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

{  
    quitTime:"2020-12-12 10:00:00",
    startTime:"2021-12-12 10:00:00", 
    quitReason:"用不了"
    records:[{
        id:11,
        version:12
    },{
        id:12,
        version:13
    }]
}

返回信息

返回参数类型

JSON

返回参数

返回结果示例

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

1.7: 台账报废

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：/v1/iot/device/stock/scrap

方法：POST

请求参数

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

{ 
    id:"12", 
    scrapApprPos:"xxx岗位",
    version:12,
    scrapReason:"用不了"
}

返回信息

返回参数类型

JSON

返回参数

返回结果示例

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

1.8: 台账批量报废

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：/v1/iot/device/stock/bat-scrap

方法：POST

请求参数

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

{  
    scrapApprPos:"xxx岗位", 
    scrapReason:"用不了",
    records:[{
        id:11,
        version:12
    },{
        id:12,
        version:13
    }]
}

返回信息

返回参数类型

JSON

返回参数

返回结果示例

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

2.0: 台账导出

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：/v1/iot/device/stock/export

方法：POST

请求参数

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

{
    orgId : "123",
    spaceName:"xx项目",
    spacePos:"1栋2层4号",
    typeId:12
}

返回信息

返回参数类型

JSON

返回参数

返回excel文件字节流

返回结果示例

{
  "code": "200",
  "message": "success",
  "data": {
    page:2,
    size:10,
    total:200,
    records:[
        {
            id:11,
            version:12,
            stockCode:"BJ-XAA-ZZZ-01",
            deviceStatus:1,
            area:"华北",    
            spaceName:'王府一号',
            name:"x水泵",
            spacePos:"1栋1单元1层",
            domainSystem:"给排水-给水系统"
        }
]}
}

2.1: 台账删除

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：/v1/iot/device/stock/remove

方法：POST

请求参数

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

{ 
    id:"12", 
    version:12
}

返回信息

返回参数类型

JSON

返回参数

返回结果示例

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

2.2: 台账恢复

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：/v1/iot/device/stock/revert

方法：POST

请求参数

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

{ 
    id:"12", 
    version:12
}

返回信息

返回参数类型

JSON

返回参数

返回结果示例

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

2.3: 项目选项框

描述

请求信息

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

Method: POST

body: JSON格式约定

入参dto：

请求示例：

{
    "org_code":"901"
}

返回示例：

{
    "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
        },
        {
            "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
        }
    ],
    "pageNo": 0,
    "pageSize": 0,
    "total": 0,
    "totalPage": 0
}

2.4: 空间位置

描述

请求信息

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

Method: POST

body: JSON格式约定

入参dto：

请求示例：

{
"space_code":"1003",
"space_type":"ZONE"
}
或
{
"space_code":"1003",
"space_type":"STRUCTURE"
}
或
{
"space_code":"1003",
"space_type":"BUILDING"
}
或
{
"space_code":"1003",
"space_type":"HOUSE"
}

返回示例：

{
    "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": 9890,
            "parentid": 9889,
            "space_id": null,
            "parent_space_id": null,
            "community_id": null,
            "space_name": "8栋",
            "full_space_name": "简岸花园-建筑物8-8栋",
            "parent_code": "1005",
            "space_code": "100010051006",
            "space_type": "BUILDING",
            "space_sort": "STRUCTURE",
            "src": 1,
            "org_id": 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
        }
    ],
    "pageNo": 0,
    "pageSize": 0,
    "total": 0,
    "totalPage": 0
}

2.5: 台账启动

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：/v1/iot/device/stock/start

方法：POST

请求参数

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

{ 
    id:"12", 
    startTime:'2020-1-2',
    version:12
}

返回信息

返回参数类型

JSON

返回参数

返回结果示例

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

2.6: 分类树形列表

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：/v1/iot/device/setting/tree

方法：POST

请求参数

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

{
"orgId":"111"
}

返回信息

返回参数类型

JSON

返回参数

返回结果示例

{
  code:200,
  message:"success",
  data:[
    {
      id:1,
      name:"给排水",
      grade:1,
      children:[
          {
            id:22,
            pid:1,
            name:"给水系统"，
            grade:2,
            children:[
                {
                id:33,
                 pid:22,
                name: "A1生活水泵",
                grade:3,
                typeId : 1122
                }
              ]
          },{
            id:23,
             pid:22,
            name:"排水系统"，
            grade:2,
            type:[...]
          }
          ...
      ]
    } , 
    {
      id:2,
      name: "消防",
      grade :2,
      system:[...],
    }
    ...
  ]
}