API接入

clientId：登录http://www.1weilian.com/平台后后在 用户管理--->个人信息 处查看

请求方式 ：POST

Content-Type: application/json;charset=UTF-8

设备类型对应表

deviceTypes ：如：‘’1000000000000010”

一共16位 ，第几位为1代表设备有该功能。

告警信息对应表

公共返回参数

添加、修改、删除 标准的返回参数。

返回参数**

返回示例

{
  "code": 0,
  "msg": "成功！"
}

添加设备

URL: http://www.1weilian.com:8750/mtInterface/device/addDevice

body参数

请求示例

xxxxxxxxxx
{
  "clientId": "XXXXXXXXXXXXXXXXXXXXXX",
  "sn": "xxxxxxxxxxxx",
  "timeCode": "01"
}

返回参数

标准返回参数

删除设备

URL: http://www.1weilian.com:8750/mtInterface/device/deleteDevice

body参数

请求示例

xxxxxxxxxx
{
  "clientId": "XXXXXXXXXXXXXXXXXXXXXX",
  "sn": "xxxxxxxxxxxx",
  "timeCode": "01"
}

返回参数

标准返回参数

修改设备配置

URL: http://www.1weilian.com:8750/mtInterface/device/updateDeviceConfig

body参数

请求示例

xxxxxxxxxx
{
  "sn":"xxxxxx",
  "clientId": "XXXXXXXXXXXXXXXXXXXXXX",
    ...
    ...
    ...
    ...
    ...
}

返回参数

标准返回参数

查询设备列表（分页）

URL: http://www.1weilian.com:8750/mtInterface/device/getDevices

body参数

请求示例

xxxxxxxxxx
{
  "clientId": "XXXXXXXXXXXXXXXXXXXXXX",
  "page": 0,
  "rows": 10
}

返回参数

data

DeviceInfo

返回示例

xxxxxxxxxx
{
  "code": 0,
  "msg": "成功！",
  "data": {
    "rows": 10,
    "page": 0,
    "count": 15,
    "dataList": [
      {
        "sn": "80022010111",
        "deviceTypes": "1000000000000010",
        "timeCode": "01"
      },
      {
        "sn": "C00211223344",
        "deviceTypes": "1100000000000010",
        "timeCode": "01"
      }
      .....................................
    ]
  }
}

查询设备列表含配置信息（分页）

URL: http://www.1weilian.com:8750/mtInterface/device/getDeciveConfigs

body参数

请求示例

xxxxxxxxxx
{
  "sn":"xxxxxx",
  "clientId": "XXXXXXXXXXXXXXXXXXXXXX",
  "page": 0,
  "rows": 10
}

返回参数

data

InterConfigDate

返回示例

xxxxxxxxxx
{
  "code": 0,
  "msg": "成功！",
  "data": {
    "rows": 10,
    "page": 0,
    "count": 15,
    "dataList": [
      {
        "sn": "XXXXXXXXX",
        "reportingInterval": 10,
        "recordInterval": 10,
        "historyReportTime": "00:30",
        "historyInterval": 24,
        "do1Type": 1,
        "do2Type": 1,
        "do1Associated": "1,2",
        "do2Associated": "3,4",
        "do1Status": 0,
        "do2Status": 0,
        "temperatureHigh": 35,
        "temperatureLow": 0,
        "temperatureBuffer": 0.1,
        "humidityHigh": 80,
        "humidityLow": 10,
        "humidityBuffer": 0.1,
        "formaldehydeAlarm": 0.08,
        "tvocAlarm": 0.05,
        "pm25Alarm": 100,
        "pm10Alarm": 100,
        "pm100Alarm": 100,
        "carbonDioxideHigh": 320,
        "carbonDioxideLow": 50,
        "ammoniaAlarm": 20,
        "lightHigh": 80,
        "lightLow": 0,
        "pressureHigh": 110,
        "pressureLow": 30,
        "phHigh": 1.4,
        "phLow": 0.7,
        "timeCode": "01",
        "userId": 1316,
        "deviceTypes": "1000000000000010",
        "di1High": "",
        "di1Low": "",
        "di2High": "",
        "di2Low": "",
        "holdTime": 6
      }
        .................
    ]
  }
}

查询DO可关联告警状态

根据SN号查询

URL: http://www.1weilian.com:8750/mtInterface/device/getWarningStatus

body参数

请求示例

xxxxxxxxxx
{
  "sn":"xxxxxx",
  "clientId": "XXXXXXXXXXXXXXXXXXXXXX"
}

返回参数

WarningBase

参考告警信息

返回示例

xxxxxxxxxx
{
  "code": 0,
  "msg": "成功！",
  "data": [
    {
      "wrId": 1,
      "content": "高温告警"
    },
    {
      "wrId": 2,
      "content": "低温告警"
    }
      ............
  ]
}

查询设备实时数据（分页）

记录的是设备最后一次上报的数据

返回值为-999.0 是未读取探头数据

URL: http://www.1weilian.com:8750/mtInterface/realTime/getRealTime

body参数

请求示例

xxxxxxxxxx
{
  "snList": [  "XXXXXX", "XXXXXX"],
  "clientId": "XXXXXXXXXXXXXXXXXXXXXX",
  "page": 0,
  "rows": 10
}

返回参数

data

RealTimeData

包含功能的设备才会有参数返回。

返回示例

xxxxxxxxxx
{
  "code": 0,
  "msg": "成功！",
  "data": {
    "rows": 10,
    "page": 0,
    "count": 23,
    "dataList": [
      {
        "sn": "C00311223347",
        "deviceTypes": "1100000000000010",
        "electricity": 0,
        "temperature": "-999.0",
        "humidity": "-999.0",
        "do1": 0,
        "do2": 0,
        "status": 1,
        "warning": "1,3",
        "date": "2020-06-06 19:05:25",
        "di1": "",
        "di2": ""
      },
        ....
        ....
        ....
        {
        "sn": "FFF711223355",
        "deviceTypes": "1111111111110111",
        "electricity": 4,
        "temperature": "28.6",
        "humidity": "58.2",
        "formaldehyde": "0.123",
        "tvoc": "0.001",
        "pm25": "5.0",
        "pm10": "2.0",
        "pm100": "1.0",
        "carbonDioxide": "11.0",
        "ammonia": "0.2",
        "light": "1.23456",
        "pressure": "10.0",
        "ph": "7.1",
        "do1": 0,
        "do2": 0,
        "status": 1,
        "warning": "21",
        "date": "2020-05-04 20:50:14"
      }
    ]
  }
}

查询设备最近1440个数据（分页）

可以用作画曲线图

返回值为-999.0 是未读取探头数据

URL: http://www.1weilian.com:8750/mtInterface/realTime/getRealTimeCurve

body参数

请求示例

xxxxxxxxxx
{
  "snList": [  "XXXXXX", "XXXXXX"],
  "clientId": "XXXXXXXXXXXXXXXXXXXXXX",
  "page": 0,
  "rows": 10
}

返回参数

data

DataList

包含功能的设备才会有参数返回。

返回示例

​x
​
{
  "code": 0,
  "msg": "成功！",
  "data": {
    "rows": 10,
    "page": 0,
    "count": 11,
    "dataList": [
         {
        "sn": "C0022000025E",
        "deviceTypes": "1100000000000010",
        "temperatureList": [
          27.2,
          27.3
        ],
        "humidityList": [
          60,
          62.6
        ],
        "dateList": [
          "2020-05-10 00:30:32",
          "2020-05-30 17:17:03"
        ]
      }
        ...
        ...
        ...
      {
        "sn": "FFF711223355",
        "deviceTypes": "1111111111110111",
        "temperatureList": [
          28.5,
          28.5,
             ...
        ],
        "humidityList": [
          73.4,
          72.9,
             ...
        ],
        "dateList": [
          "2020-04-27 15:10:27",
          "2020-04-27 15:10:30",
             ...
        ],
        "formaldehydeList": [
          0.123,
          0.123,
             ...
        ],
        "tvocList": [
          0.001,
          0.001,
             ...
        ],
        "pm25List": [
          5,
          5,
             ...
        ],
        "pm10List": [
          2,
          2,
         ...
        ],
        "pm100List": [
          1,
          1,
             ...
        ],
        "carbonDioxideList": [
          11,
          11,
             ...
        ],
        "ammoniaList": [
          0.2,
          0.2,
             ...
        ],
        "lightList": [
          1.23456,
          1.23456
             ...
        ],
        "pressureList": [
          100,
          100,
             ...
        ],
        "phList": [
          7.1,
          7.1,
             ...
        ]
      }
    ]
  }
}

控制续电器DO

URL: http://www.1weilian.com:8750/mtInterface/realTime/doControl

body参数

请求示例

xxxxxxxxxx
{
  "sn":"",,
  "clientId": "XXXXXXXXXXXXXXXXXXXXXX",
  "doNum": 1,
  "doControl": 1
}

返回参数

标准返回参数

查询历史数据统计信息

URL: http://www.1weilian.com:8750/mtInterface/history/getHistorySts

body参数

请求示例

xxxxxxxxxx
{
  "sn":"xxxxxx",
  "clientId": "XXXXXXXXXXXXXXXXXXXXXX",
  "startTime":"2020-01-01 11:11:11",
  "endTime": "2020-02-01 11:11:11"
}

返回参数

data

dataSts

返回示例

xxxxxxxxxx
{
  "code": 0,
  "msg": "成功！",
  "data": {
    "title": "易维联环境监控",
    "count": 131,
    "sn": "FFF711223355",
    "printStsList": [
      {
        "averageValue": "28.4",
        "maxValue": "30.6",
        "minValue": "26.2",
        "text": "温度℃",
        "key": "temperature"
      },
      {
        "averageValue": "66.6",
        "maxValue": "79.8",
        "minValue": "55.3",
        "text": "湿度%RH",
        "key": "humidity"
      },
      {
        "averageValue": "0.123",
        "maxValue": "0.123",
        "minValue": "0.123",
        "text": "甲醛mg/m3",
        "key": "formaldehyde"
      },
      {
        "averageValue": "0.001",
        "maxValue": "0.001",
        "minValue": "0.001",
        "text": "TOVC-ppm",
        "key": "tvoc"
      },
      {
        "averageValue": "5.0",
        "maxValue": "5.0",
        "minValue": "5.0",
        "text": "PM2.5ug/m3",
        "key": "pm25"
      },
      {
        "averageValue": "2.0",
        "maxValue": "2.0",
        "minValue": "2.0",
        "text": "PM1.0ug/m3",
        "key": "pm10"
      },
      {
        "averageValue": "1.0",
        "maxValue": "1.0",
        "minValue": "1.0",
        "text": "PM10ug/m3",
        "key": "pm100"
      },
      {
        "averageValue": "11.0",
        "maxValue": "11.0",
        "minValue": "11.0",
        "text": "二氧化碳ppm",
        "key": "carbonDioxide"
      },
      {
        "averageValue": "0.2",
        "maxValue": "0.2",
        "minValue": "0.2",
        "text": "氨气ppm",
        "key": "ammonia"
      },
      {
        "averageValue": "56.6",
        "maxValue": "120.01",
        "minValue": "0.00",
        "text": "气压hpa",
        "key": "pressure"
      },
      {
        "averageValue": "5.9",
        "maxValue": "7.1",
        "minValue": "0.0",
        "text": "PH",
        "key": "ph"
      }
    ]
  }
}

查询历史数据（分页）

返回值为-999.0 是未读取探头数据

URL: http://www.1weilian.com:8750/mtInterface/history/getHistoryData

body参数

请求示例

xxxxxxxxxx
{
  "sn":"xxxxxx",
  "clientId": "XXXXXXXXXXXXXXXXXXXXXX",
  "page": 0,
  "rows": 10,
  "startTime":"2020-01-01 11:11:11",
  "endTime": "2020-02-01 11:11:11"
}

返回参数

data

HistoryInfo

包含功能的设备才会有参数返回。

返回示例

xxxxxxxxxx
{
  "code": 0,
  "msg": "成功！",
  "data": {
    "rows": 10,
    "page": 0,
    "count": 131,
    "deviceTypes": "1111111111110111"
    "dataList": [
      {
        "id": 4399,
        "sn": "FFF711223355",
        "temperature": "28.6",
        "humidity": "58.2",
        "formaldehyde": "0.123",
        "tvoc": "0.001",
        "pm25": "5.0",
        "pm10": "2.0",
        "pm100": "1.0",
        "carbonDioxide": "11.0",
        "ammonia": "0.2",
        "light": "1.23456",
        "pressure": "10.00",
        "ph": "7.1",
        "date": "2020-05-04 20:50:00"
      }，
        ...
        ...
      {
        "id": 2962,
        "sn": "FFF711223355",
        "temperature": "30.2",
        "humidity": "60.5",
        "formaldehyde": "0.123",
        "tvoc": "0.001",
        "pm25": "5.0",
        "pm10": "2.0",
        "pm100": "1.0",
        "carbonDioxide": "11.0",
        "ammonia": "0.2",
        "light": "0.57900",
        "pressure": "10.00",
        "ph": "7.1",
        "date": "2020-05-04 19:49:00"
      }
    ]
  }
}

查询历史记录曲线图数据

可以用作画曲线图

返回值为-999.0 是未读取探头数据

URL: http://www.1weilian.com:8750/mtInterface/history/historyCurveData

body参数

请求示例

xxxxxxxxxx
{
  "sn":"xxxxxx",
  "clientId": "XXXXXXXXXXXXXXXXXXXXXX",
  "startTime":"2020-01-01 11:11:11",
  "endTime": "2020-02-01 11:11:11"
}

返回参数

data

包含功能的设备才会有参数返回。

返回示例

xxxxxxxxxx
{
  "code": 0,
  "msg": "成功！",
  "data": {
    "rows": 10,
    "page": 0,
    "count": 11,
    "dataList": [
         {
        "sn": "C0022000025E",
        "deviceTypes": "1100000000000010",
        "temperatureList": [
          27.2,
          27.3
        ],
        "humidityList": [
          60,
          62.6
        ],
        "dateList": [
          "2020-05-10 00:30:32",
          "2020-05-30 17:17:03"
        ]
      }
        ...
        ...
        ...
      {
        "sn": "FFF711223355",
        "deviceTypes": "1111111111110111",
        "temperatureList": [
          28.5,
          28.5,
             ...
        ],
        "humidityList": [
          73.4,
          72.9,
             ...
        ],
        "dateList": [
          "2020-04-27 15:10:27",
          "2020-04-27 15:10:30",
             ...
        ],
        "formaldehydeList": [
          0.123,
          0.123,
             ...
        ],
        "tvocList": [
          0.001,
          0.001,
             ...
        ],
        "pm25List": [
          5,
          5,
             ...
        ],
        "pm10List": [
          2,
          2,
         ...
        ],
        "pm100List": [
          1,
          1,
             ...
        ],
        "carbonDioxideList": [
          11,
          11,
             ...
        ],
        "ammoniaList": [
          0.2,
          0.2,
             ...
        ],
        "lightList": [
          1.23456,
          1.23456
             ...
        ],
        "pressureList": [
          100,
          100,
             ...
        ],
        "phList": [
          7.1,
          7.1,
             ...
        ]
      }
    ]
  }
}

查询告警记录（分页）

返回值为-999.0 是未读取探头数据

URL: http://www.1weilian.com:8750/mtInterface/warning/getWarningData

body参数

请求示例

xxxxxxxxxx
{
  "sn":"xxxxxx",
  "clientId": "XXXXXXXXXXXXXXXXXXXXXX",
  "type": 1,
  "page": 0,
  "rows": 10,
  "startTime":"2020-01-01 11:11:11",
  "endTime": "2020-02-01 11:11:11"
}

返回参数

data

WarningData

包含功能的设备才会有参数返回。

返回示例

xxxxxxxxxx
{
  "code": 0,
  "msg": "成功！",
  "data": {
    "rows": 10,
    "page": 0,
    "count": 49,
    "identifier": 0,
    "dataList": [
      {
        "id": 71,
        "sn": "FFF711223355",
        "wrId": 113,
        "date": "2020-06-01 10:40:00",
        "content": "通讯恢复"
      },
        ...
        ...
      {
        "id": 45,
        "sn": "FFF711223355",
        "wrId": 1,
        "wrData": 3.5,
        "date": "2020-04-27 15:17:01",
        "content": "高温告警"
      }
    ]
  }
}

查询设备百度地图当前坐标信息

URL: http://www.1weilian.com:8750/mtInterface/realTime/getBaiduGps

body参数

请求示例

xxxxxxxxxx
{
  "sn":"xxxxxx",
  "clientId": "XXXXXXXXXXXXXXXXXXXXXX"
}

返回参数

data

返回示例

x
{
  "code": 0,
  "msg": "成功！",
  "data": {
    "sn": "FFF711223355",
    "gps": "121.35727,30.987236",
    "longitude": 121.368432399016870,
    "latitude": 30.9910265233820090
  }
}

附录

返回Code说明