使用准备

通过AEP应用OpenAPI获取相关的应用数据，在接口调用前，需要准备相应的应用鉴权信息

Step 1 ： 获取应用token

每个物联网应用具有独立的数据访问token，请在物联网平台 - 我的应用- 物联网应用 中，找到对应的项目应用，获取其 应用token ;

Step 2 ：接口请求头携带对应的token

在上述第一步中获取到的token，在接口调用过程中，将token在请求头中携带，如下所示：

相关的应用接口请求接口及其内容，请查看下文各个细节：

统一的应用端接口请求地址： https://app-console.easylinkin.com/

获取设备详细信息

请求描述：获取设备详细信息

请求协议：HTTP

请求类型：POST

请求数据格式：JSON

请求地址：/api/openapi/device/get

参数名称字段类型是否必填字段说明
请求数据
idstring否空间名称
spaceIdstring否空间ID
areaPathstring否区域路径
deviceTypeIdstring否设备类型ID
areaIdstring否区域ID（查询区域包含该区域下的子区域）
queryTimeStartstring否查询开始时间
queryTimeEndstring否查询结束时间
namestring否设备名称
codestring否设备编码（等值查询）
codeLikeQuerystring否设备编码（模糊查询）
statusint否状态
onlineStateint否在线状态
projectIdstring否项目ID
deviceUnitIdstring否设备型号ID
deviceUnitVersionstring否设备型号版本
deviceUnitCodestring否设备型号编码
creatorstring否创建人
deviceUnitCodeListArrays否设备型号编码list
deviceCodeListArrays否设备编码List
返回数据(Arrays)
idstring 主键ID
namestring 设备名称
codestring 设备编码
statusstring 设备状态0:正常; 1:告警
onlineStateint 0:离线; 1:正常
remarkint 备注
indoorLocationint 室内位置
deviceUnitIdstring 设备型号ID
lastPushTimestring 上次推送时间
createTimestring 创建时间
modifyTimestring 修改时间
areaIdstring 区域ID
latitudestring 纬度
longitudestring 经度
sitestring 位置
linkthingDeletestring 在linkthing是否删除1-存在
areaPathint 区域路径
tenantIdstring 租户ID
areaNamestring 区域名称
spaceIdstring 空间ID
spaceNamestring 空间名称
deviceUnitJSONObject 设备型号数据
deviceUnitdeviceTypeNamestring 设备类型名称
deviceUnitNameint 设备型号名称
deviceUnitCode  设备型号编码
deviceTypeId  设备类型ID
deviceUnitVersion  设备型号版本号
deviceTypeJSONObject 设备类型数据
deviceTypeidstring 设备类型ID
icoPath  设备类型属性显示图标

设备属性历史数据流水查询

请求描述：设备属性历史数据流水查询

请求协议：HTTP

请求类型：POST

请求数据格式：JSON

请求地址：/api/openAPI/getHistoricDataPageFromEs

参数名称字段类型是否必填字段说明
请求参数
pageJSONObject是分页参数
pagecurrentint是当前页
sizeint是每页大小
customQueryParamsJSONObject是自定义查询参数
customQueryParamsqueryTimeStartstring否查询开始时间
queryTimeEndstring否查询结束时间
necessaryFieldListJSONArrays否设备属性值名称
deviceCodestring是设备编码
返回参数（因设备编码不同，查询到的data物模型也不同，故返回参数请查看返回示例）

请求参数示例：

{
  "page": {
    "current": 1,
    "size": 5
  },
  "customQueryParams": {
    "deviceCode": "VIR1636339501431",
    "queryTimeStart": "2021-11-01 00:00:00",
    "queryTimeEnd": "2021-11-09 23:59:59",
    "necessaryFieldList": [
      "gas_AD_value",
      "gas_reaction_medium_failure",
      "sensor_breakdown",
      "fire_alarm"
    ]
  }
}

返回参数示例：

{
  "success": true,
  "code": "success",
  "level": "info",
  "message": "操作成功",
  "data": {
    "records": [
      {
        "createTime": "2021-11-08 10:49:50",
        "specsMap": {
          "sensor_breakdown": "{\"0\":\"正常\",\"1\":\"报警\"}",
          "gas_AD_value": "{\"unit\":\"%\"}",
          "gas_reaction_medium_failure": "{\"0\":\"正常\",\"1\":\"报警\"}",
          "fire_alarm": "{\"0\":\"正常\",\"1\":\"报警\"}"
        },
        "deviceTypeName": "燃气监测（多维度标签）",
        "sensor_breakdown": 0,
        "gas_AD_value": 626,
        "deviceCode": "VIR1636339501431",
        "deviceUnitCode": "KRQTJC-NBAO-01-0055",
        "fire_alarm": 0,
        "gas_reaction_medium_failure": 0,
        "deviceName": "燃气监测（多维度标签）1431燃气监测（多维度标签）"
      }
    ],
    "total": 1,
    "size": 5,
    "current": 1,
    "orders": [],
    "searchCount": true,
    "pages": 1
  }
}

设备总数数量统计，以及在线、离线统计

请求描述：设备总数数量统计，以及在线、离线统计

请求协议：HTTP

请求类型：POST

请求数据格式：无

请求地址：/api/openAPI/datav/device/deviceCount

参数名称字段类型是否必填字段说明
请求参数
http headers信息
tokenstring是租户ID
body(无)
返回参数
deviceCountint 设备总数
onlineCountint 在线总数
offlineCountint 离线总数
onlineRatedouble 在线率（在线数/设备总数）

设备资产数据统计

请求描述：设备资产数据统计

请求协议：HTTP

请求类型：POST

请求数据格式：无

请求地址：/api/openAPI/datav/asset/assetAudit

参数名称字段类型是否必填字段说明
请求参数
http headers信息
tokenstring是租户ID
body(无)
返回参数
assetCountint 租户下的总资产数量
monthnumberint 当月创建的资产数量
daynumberint 当天创建的资产数量

查询当天的分时数据

请求描述：查询当天的分时数据

请求协议：HTTP

请求类型：POST

请求数据格式：无

请求地址：/api/openAPI/datav/getHistoricDataCurrDay

参数名称字段类型是否必填字段说明
请求参数
http headers信息
tokenstring是租户ID
body
deviceCodestring是设备编码，必传参数，但代码里面未校验,如果不传则没数据
propNamestring是属性名称
返回参数见示例

请求参数示例：

headers:token = 1

{
    "deviceCode":"34020000001323000120",
    "propName":""
}

返回参数示例：

{
    "success": true,
    "code": "success",
    "level": "info",
    "message": "操作成功",
    "data": [
        {
            "00": {
                "createTime": "2021-11-10 00:00:00",
                "deviceTypeName": "测试型号1125",
                "flvHttpsUrl": "https://stream_test1.easylinkin.com:18093/live/34020000001323000120@34020000001323000120.flv",
                "deviceCode": "34020000001323000120",
                "deviceUnitCode": "TEST-SPHF-VIDEO-0316",
                "deviceName": "工地安全帽监控摄像头1"
            }
        },
        {
            "01": {
                "createTime": "2021-11-10 01:00:00",
                "deviceTypeName": "测试型号1125",
                "flvHttpsUrl": "https://stream_test1.easylinkin.com:18093/live/34020000001323000120@34020000001323000120.flv",
                "deviceCode": "34020000001323000120",
                "deviceUnitCode": "TEST-SPHF-VIDEO-0316",
                "deviceName": "工地安全帽监控摄像头1"
            }
        },
        {
            "02": {
                "createTime": "2021-11-10 02:00:00",
                "deviceTypeName": "测试型号1125",
                "flvHttpsUrl": "https://stream_test1.easylinkin.com:18093/live/34020000001323000120@34020000001323000120.flv",
                "deviceCode": "34020000001323000120",
                "deviceUnitCode": "TEST-SPHF-VIDEO-0316",
                "deviceName": "工地安全帽监控摄像头1"
            }
        },
        {
            "03": {
                "createTime": "2021-11-10 03:00:00",
                "deviceTypeName": "测试型号1125",
                "flvHttpsUrl": "https://stream_test1.easylinkin.com:18093/live/34020000001323000120@34020000001323000120.flv",
                "deviceCode": "34020000001323000120",
                "deviceUnitCode": "TEST-SPHF-VIDEO-0316",
                "deviceName": "工地安全帽监控摄像头1"
            }
        },
        {
            "04": {
                "createTime": "2021-11-10 04:00:00",
                "deviceTypeName": "测试型号1125",
                "flvHttpsUrl": "https://stream_test1.easylinkin.com:18093/live/34020000001323000120@34020000001323000120.flv",
                "deviceCode": "34020000001323000120",
                "deviceUnitCode": "TEST-SPHF-VIDEO-0316",
                "deviceName": "工地安全帽监控摄像头1"
            }
        },
        {
            "05": {
                "createTime": "2021-11-10 05:00:00",
                "deviceTypeName": "测试型号1125",
                "flvHttpsUrl": "https://stream_test1.easylinkin.com:18093/live/34020000001323000120@34020000001323000120.flv",
                "deviceCode": "34020000001323000120",
                "deviceUnitCode": "TEST-SPHF-VIDEO-0316",
                "deviceName": "工地安全帽监控摄像头1"
            }
        },
        {
            "06": {
                "createTime": "2021-11-10 06:00:00",
                "deviceTypeName": "测试型号1125",
                "flvHttpsUrl": "https://stream_test1.easylinkin.com:18093/live/34020000001323000120@34020000001323000120.flv",
                "deviceCode": "34020000001323000120",
                "deviceUnitCode": "TEST-SPHF-VIDEO-0316",
                "deviceName": "工地安全帽监控摄像头1"
            }
        },
        {
            "07": {
                "createTime": "2021-11-10 07:00:00",
                "deviceTypeName": "测试型号1125",
                "flvHttpsUrl": "https://stream_test1.easylinkin.com:18093/live/34020000001323000120@34020000001323000120.flv",
                "deviceCode": "34020000001323000120",
                "deviceUnitCode": "TEST-SPHF-VIDEO-0316",
                "deviceName": "工地安全帽监控摄像头1"
            }
        },
        {
            "08": {
                "createTime": "2021-11-10 08:00:00",
                "deviceTypeName": "测试型号1125",
                "flvHttpsUrl": "https://stream_test1.easylinkin.com:18093/live/34020000001323000120@34020000001323000120.flv",
                "deviceCode": "34020000001323000120",
                "deviceUnitCode": "TEST-SPHF-VIDEO-0316",
                "deviceName": "工地安全帽监控摄像头1"
            }
        },
        {
            "09": {
                "createTime": "2021-11-10 09:00:00",
                "deviceTypeName": "测试型号1125",
                "flvHttpsUrl": "https://stream_test1.easylinkin.com:18093/live/34020000001323000120@34020000001323000120.flv",
                "deviceCode": "34020000001323000120",
                "deviceUnitCode": "TEST-SPHF-VIDEO-0316",
                "deviceName": "工地安全帽监控摄像头1"
            }
        },
        {
            "10": {
                "createTime": "2021-11-10 10:00:00",
                "deviceTypeName": "测试型号1125",
                "flvHttpsUrl": "https://stream_test1.easylinkin.com:18093/live/34020000001323000120@34020000001323000120.flv",
                "deviceCode": "34020000001323000120",
                "deviceUnitCode": "TEST-SPHF-VIDEO-0316",
                "deviceName": "工地安全帽监控摄像头1"
            }
        }
    ]
}

查询当天的分时数据（新）

请求描述：查询当天的分时数据（新）

请求协议：HTTP

请求类型：POST

请求数据格式：无

请求地址：/api/openAPI/datav/getHistoricDataCurrDayNew

参数名称字段类型是否必填字段说明
同上“查询当天的分时数据”

告警信息已处理、未处理数据统计

请求描述：告警信息已处理、未处理数据统计

请求协议：HTTP

请求类型：POST

请求数据格式：无

请求地址：/api/openAPI/datav/alarmInfo/alarmInfoAudit

参数名称字段类型是否必填字段说明
请求参数
http headers信息
tokenstring是租户ID
body(无)
返回参数
alarmCountint 告警总数
untreatedCountint 未处理告警数
treatedCountint 已处理告警数

近七天告警已/未处理统计整合

请求描述：近七天告警已/未处理统计整合

请求协议：HTTP

请求类型：POST

请求数据格式：无

请求地址：/api/openAPI/datav/alarmInfo/getAlarmStatisticsByStatus

参数名称字段类型是否必填字段说明
请求参数
http headers信息
tokenstring是租户ID
body(无)
返回参数
alarmCountint 告警总数
untreatedCountint 未处理告警数
treatedCountint 已处理告警数

返回数据示例：

{
    "unHandlerAlarm": [
        {
            "spaceId": "f160b6ae3d351de1870bdc0650235af2",
            "alarmTime": "2021-11-09",
            "tenantId": "1",
            "oneDayAddCount": 17,
            "status": 1
        },
        {
            "spaceId": "7e0d358584016f4dd8485e6c67cb2955",
            "alarmTime": "2021-11-08",
            "tenantId": "1",
            "oneDayAddCount": 18,
            "status": 1
        },
        {
            "spaceId": "f160b6ae3d351de1870bdc0650235af2",
            "alarmTime": "2021-11-07",
            "tenantId": "1",
            "oneDayAddCount": 18,
            "status": 1
        },
        {
            "spaceId": "7e0d358584016f4dd8485e6c67cb2955",
            "alarmTime": "2021-11-06",
            "tenantId": "1",
            "oneDayAddCount": 18,
            "status": 1
        },
        {
            "spaceId": "7e0d358584016f4dd8485e6c67cb2955",
            "alarmTime": "2021-11-05",
            "tenantId": "1",
            "oneDayAddCount": 18,
            "status": 1
        },
        {
            "spaceId": "696f176f01bcfc09f954b0c25b29e195",
            "alarmTime": "2021-11-04",
            "tenantId": "1",
            "oneDayAddCount": 17,
            "status": 1
        },
        {
            "spaceId": "a209d70e465ebb4f60d3309f36312e16",
            "alarmTime": "2021-11-03",
            "tenantId": "1",
            "oneDayAddCount": 17,
            "status": 1
        }
    ],
    "handlerAlarm": [
        {
            "spaceId": "f160b6ae3d351de1870bdc0650235af2",
            "alarmTime": "2021-11-09",
            "tenantId": "1",
            "oneDayAddCount": 140,
            "status": 2
        },
        {
            "spaceId": "a209d70e465ebb4f60d3309f36312e16",
            "alarmTime": "2021-11-08",
            "tenantId": "1",
            "oneDayAddCount": 139,
            "status": 2
        },
        {
            "spaceId": "7e0d358584016f4dd8485e6c67cb2955",
            "alarmTime": "2021-11-07",
            "tenantId": "1",
            "oneDayAddCount": 139,
            "status": 2
        },
        {
            "spaceId": "a209d70e465ebb4f60d3309f36312e16",
            "alarmTime": "2021-11-06",
            "tenantId": "1",
            "oneDayAddCount": 139,
            "status": 2
        },
        {
            "spaceId": "a209d70e465ebb4f60d3309f36312e16",
            "alarmTime": "2021-11-05",
            "tenantId": "1",
            "oneDayAddCount": 139,
            "status": 2
        },
        {
            "spaceId": "a209d70e465ebb4f60d3309f36312e16",
            "alarmTime": "2021-11-04",
            "tenantId": "1",
            "oneDayAddCount": 139,
            "status": 2
        },
        {
            "spaceId": "183f205dd557a8597431bb305ec08c8e",
            "alarmTime": "2021-11-03",
            "tenantId": "1",
            "oneDayAddCount": 139,
            "status": 2
        }
    ]
}

近七天设备在/离线统计整合

请求描述：近七天设备在/离线统计整合

请求协议：HTTP

请求类型：POST

请求数据格式：无

请求地址：/api/openAPI/datav/device/getStatisticsDeviceCount

参数名称字段类型是否必填字段说明
请求参数
http headers信息
tokenstring是租户ID
body(无)
返回参数
onlineStatisticsMapmap 近7天内设备在线数
offlineStatisticsMapmap 近7天内设备离线数

返回数据示例：

{
    "offlineStatisticsMap": [
        {
            "createTime": "2021-11-09",
            "tenantId": "1",
            "oneDayAddCount": 245,
            "onlineState": 0
        },
        {
            "createTime": "2021-11-08",
            "tenantId": "1",
            "oneDayAddCount": 242,
            "onlineState": 0
        },
        {
            "createTime": "2021-11-07",
            "tenantId": "1",
            "oneDayAddCount": 245,
            "onlineState": 0
        },
        {
            "createTime": "2021-11-06",
            "tenantId": "1",
            "oneDayAddCount": 245,
            "onlineState": 0
        },
        {
            "createTime": "2021-11-05",
            "tenantId": "1",
            "oneDayAddCount": 244,
            "onlineState": 0
        },
        {
            "createTime": "2021-11-04",
            "tenantId": "1",
            "oneDayAddCount": 242,
            "onlineState": 0
        },
        {
            "createTime": "2021-11-03",
            "tenantId": "1",
            "oneDayAddCount": 243,
            "onlineState": 0
        }
    ],
    "onlineStatisticsMap": [
        {
            "createTime": "2021-11-09",
            "tenantId": "1",
            "oneDayAddCount": 187,
            "onlineState": 1
        },
        {
            "createTime": "2021-11-08",
            "tenantId": "1",
            "oneDayAddCount": 190,
            "onlineState": 1
        },
        {
            "createTime": "2021-11-07",
            "tenantId": "1",
            "oneDayAddCount": 185,
            "onlineState": 1
        },
        {
            "createTime": "2021-11-06",
            "tenantId": "1",
            "oneDayAddCount": 185,
            "onlineState": 1
        },
        {
            "createTime": "2021-11-05",
            "tenantId": "1",
            "oneDayAddCount": 186,
            "onlineState": 1
        },
        {
            "createTime": "2021-11-04",
            "tenantId": "1",
            "oneDayAddCount": 186,
            "onlineState": 1
        },
        {
            "createTime": "2021-11-03",
            "tenantId": "1",
            "oneDayAddCount": 185,
            "onlineState": 1
        }
    ]
}

根据设备属性做统计

请求描述：根据设备属性做统计，就是在原有的设备监控高级查询上做了一些扩展：支持设备型号来查询，不必要写死设备属性id和设备型号id

请求协议：HTTP

请求类型：POST

请求数据格式：JSON

请求地址：/api/openAPI/datav/device/getDeviceMaintainCount

参数名称字段类型是否必填字段说明
请求参数
http headers信息
tokenstring是租户ID
body(无)
pageJSONObject是分页参数
pagecurrentint是当前页
sizeint是每页大小
customQueryParamsJSONObject是自定义查询参数
customQueryParamsmoniterCommonQuerystring是设备型号编码
propertyExpressionsJSONArrays是设备属性数据
propertyExpressionsdeviceAttributeName是需要统计的设备属性名称
calculateSign是运算表达式
value是计算值
其他见示例...
返回参数（见示例）

请求数据示例：

{
  "page": {
    "current": 1,
    "size": 12
  },
  "customQueryParams": {
    "propertyExpressions": [
      {
        "deviceAttributeName": "告警状态",
        "calculateSign": "==",
        "value": "3",
        "logicCode": "",
        "sortNo": "",
        "subPropList": [],
        "unit": "enum",
        "specs": {
          "0": "正常",
          "1": "预警",
          "2": "报警",
          "3": "维护"
        }
      }
    ],
    "moniterCommonQuery": "YYXT-SERVER-APP-001"
  }
}

返回数据示例：

{
    "success": true,
    "code": "success",
    "level": "info",
    "message": "操作成功",
    "data": {
        "records": [
            {
                "id": "bd792c334f6a0e9eb00af42e8a6088fe",
                "code": "2851298793",
                "codeLikeQuery": null,
                "name": "城东区校苑公安牛肉",
                "status": 0,
                "deleteState": 1,
                "onlineState": 1,
                "deviceUnitId": "18e5e5e059623b1cf8e3eae3874df3d3",
                "lastPushTime": "2021-11-10 10:40:03",
                "areaPath": "荆州",
                "tenantId": "e4f5ab9584f47cbabb4a12b5a014dec9",
                "deviceTypeName": "油烟监测器",
                "deviceUnitName": null,
                "deviceUnitCode": "YYXT-SERVER-APP-001",
                "deviceUnitVersion": "2.1",
                "deviceAttributeStatusList": [
                    {
                        "id": "80ca671ba2f52ac367147a809007350c",
                        "deviceCode": "2851298793",
                        "deviceName": null,
                        "propName": "油烟浓度",
                        "propCode": "smoke_density",
                        "propUnit": null,
                        "unit": "float",
                        "propValue": "0",
                        "deviceUnitId": "18e5e5e059623b1cf8e3eae3874df3d3",
                        "sortNo": 0,
                        "isShow": true,
                        "specs": "{\"unit\":\"mg/m3\"}"
                    },
                    {
                        "id": "40fd2a5f7d8fb4b342aa02b05e220af1",
                        "deviceCode": "2851298793",
                        "deviceName": null,
                        "propName": "告警状态",
                        "propCode": "alarm_status",
                        "unit": "enum",
                        "propValue": "3",
                        "deviceUnitId": "18e5e5e059623b1cf8e3eae3874df3d3",
                        "sortNo": 4,
                        "isShow": true,
                        "specs": "{\"0\":\"正常\",\"1\":\"预警\",\"2\":\"报警\",\"3\":\"维护\"}"
                    },
                    {
                        "id": "28d1d74d53c09ecd6948f35ef42d6487",
                        "deviceCode": "2851298793",
                        "deviceName": null,
                        "propName": "纬度",
                        "propCode": "latitude",
                        "unit": "double",
                        "propValue": "30.357511949185",
                        "deviceUnitId": "18e5e5e059623b1cf8e3eae3874df3d3",
                        "sortNo": 5,
                        "isShow": true
                    },
                    {
                        "id": "a370890303bf18b0cb6357813c72f6a1",
                        "deviceCode": "2851298793",
                        "propName": "经度",
                        "propCode": "longtitude",
                        "unit": "double",
                        "propValue": "112.2146492744",
                        "deviceUnitId": "18e5e5e059623b1cf8e3eae3874df3d3",
                        "sortNo": 6
                    },
                    {
                        "id": "3806d1d8a94eeca648c3e7805a96d7ab",
                        "deviceCode": "2851298793",
                        "propName": "vocs",
                        "propCode": "vocs",
                        "unit": "float",
                        "propValue": "0",
                        "deviceUnitId": "18e5e5e059623b1cf8e3eae3874df3d3",
                        "sortNo": 7,
                        "isShow": true,
                        "specs": "{\"unit\":\"mg/m3\"}"
                    },
                    {
                        "id": "b42679e523657b2c5a70b38f85513168",
                        "deviceCode": "2851298793",
                        "deviceName": null,
                        "propName": "油烟总浓度",
                        "propCode": "smokeall",
                        "propUnit": null,
                        "unit": "float",
                        "propValue": "0",
                        "deviceUnitId": "18e5e5e059623b1cf8e3eae3874df3d3"
                    },
                    {
                        "id": "72c423aec8b0d706b15d2780dd1e6f14",
                        "deviceCode": "2851298793",
                        "deviceName": null,
                        "propName": "点位地址",
                        "propCode": "address",
                        "propUnit": null,
                        "unit": "string",
                        "propValue": "城东区荆东路29号",
                        "deviceUnitId": "18e5e5e059623b1cf8e3eae3874df3d3"
                    }
                ]            }
        ],
        "total": 46,
        "size": 12,
        "current": 1,
        "orders": [],
        "searchCount": true,
        "pages": 4
    }
}

根据设备类型名称统计各个类型的设备数量

请求描述：根据设备类型名称统计各个类型的设备数量

请求协议：HTTP

请求类型：POST

请求数据格式：无

请求地址：/api/openAPI/datav/device/getStatisticsByType

参数名称字段类型是否必填字段说明
请求参数
http headers信息
tokenstring是租户ID
body(无)
返回参数(见示例)

返回数据示例：

{
    "total": 432,
    "IP设备类型": 1,
    "LoRa单相电表-CN470": 26,
    "LoRa烟雾报警器-CN470": 2,
    "RS485转4G通信模块": 2,
    "三相智能断路器": 5,
    "三相电表": 46,
    "人员定位器": 15,
    "人脸打卡": 2,
    "人脸识别2": 1,
    "单相智能断路器": 10,
    "单相电表": 2,
    "手动报警器": 2,
    "智能开关接收器": 22,
    "智能按键": 19,
    "智能门锁": 2,
    "气体检测器": 1,
    "水表": 18,
    "灯控网关": 1,
    "烟雾报警器": 1,
    "燃气监测（多维度标签）": 20,
    "电气火灾监测器": 2,
    "空调控制": 1,
    "空调控制器": 86,
    "窗帘控制器": 40,
    "线路保护装置": 16,
    "网关测试类型": 1,
    "门窗监测器": 2,
    "阿里接入": 1
}

根据城市获取天气信息

请求描述：根据城市获取天气信息

请求协议：HTTP

请求类型：POST

请求数据格式：application/x-www-form-urlencoded

请求地址：/api/openAPI/getWeather

参数名称字段类型是否必填字段说明
请求参数
cityKeystring是城市名称，示例：北京
返回数据（见示例）

返回数据示例：

{
    "data": {
        "yesterday": {
            "date": "9日星期二",
            "high": "高温 11℃",
            "fx": "西北风",
            "low": "低温 1℃",
            "fl": "<![CDATA[4级]]>",
            "type": "晴"
        },
        "city": "北京",
        "forecast": [
            {
                "date": "10日星期三",
                "high": "高温 14℃",
                "fengli": "<![CDATA[4级]]>",
                "low": "低温 2℃",
                "fengxiang": "西北风",
                "type": "晴"
            },
            {
                "date": "11日星期四",
                "high": "高温 11℃",
                "fengli": "<![CDATA[3级]]>",
                "low": "低温 -1℃",
                "fengxiang": "西北风",
                "type": "多云"
            },
            {
                "date": "12日星期五",
                "high": "高温 12℃",
                "fengli": "<![CDATA[2级]]>",
                "low": "低温 -1℃",
                "fengxiang": "西北风",
                "type": "晴"
            },
            {
                "date": "13日星期六",
                "high": "高温 11℃",
                "fengli": "<![CDATA[2级]]>",
                "low": "低温 0℃",
                "fengxiang": "西北风",
                "type": "晴"
            },
            {
                "date": "14日星期天",
                "high": "高温 12℃",
                "fengli": "<![CDATA[2级]]>",
                "low": "低温 -1℃",
                "fengxiang": "西北风",
                "type": "晴"
            }
        ],
        "ganmao": "感冒易发期，外出请适当调整衣物，注意补充水分。",
        "wendu": "11"
    },
    "status": 1000,
    "desc": "OK"
}

根据城市代码和时间条件获取天气信息

请求描述：根据城市代码和时间条件获取天气信息

请求协议：HTTP

请求类型：POST

请求数据格式：JSON

请求地址：/api/openAPI/getWeatherAll

参数名称字段类型是否必填字段说明
请求参数
cityCodestring否城市代码，示例：101200103（黄陂）
quertStartTimedate否查询开始时间
quertEndTimedate否查询结束时间
返回参数（查看返回数据示例）

返回数据示例：

{
    "success": true,
    "code": "success",
    "level": "info",
    "message": "操作成功",
    "data": [
        {
            "id": "5f0cbc0cb9654b3eaf58fde1cb926afa",
            "city": "黄陂",
            "cityCode": "101200103",
            "shidu": "60%",
            "fengli": "2级",
            "fengxiang": "西风",
            "wendu": "13",
            "high": "高温 17℃",
            "low": "低温 5℃",
            "nightType": "多云",
            "dayType": "晴",
            "updatetime": "10:46",
            "createtime": "2021-11-10 11:15:54",
            "quertStartTime": null,
            "quertEndTime": null
        },
        {
            "id": "9333bad1af7b4da6bafcf04236b24c2f",
            "city": "黄陂",
            "cityCode": "101200103",
            "shidu": "60%",
            "fengli": "2级",
            "fengxiang": "西风",
            "wendu": "13",
            "high": "高温 17℃",
            "low": "低温 5℃",
            "nightType": "多云",
            "dayType": "晴",
            "updatetime": "10:46",
            "createtime": "2021-11-10 11:12:06",
            "quertStartTime": null,
            "quertEndTime": null
        },
        {
            "id": "ff0536720c9b4543ac2b909b68dbdf60",
            "city": "黄陂",
            "cityCode": "101200103",
            "shidu": "78%",
            "fengli": "2级",
            "fengxiang": "南风",
            "wendu": "13",
            "high": "高温 17℃",
            "low": "低温 10℃",
            "nightType": "阴",
            "dayType": "多云",
            "updatetime": "10:31",
            "createtime": "2021-10-18 10:50:41",
            "quertStartTime": null,
            "quertEndTime": null
        }
    ]
}

dataV大屏显示当日数据

请求描述：dataV大屏显示当日数据

请求协议：HTTP

请求类型：POST

请求数据格式：JSON

请求地址：/api/openAPI/datav/getHistoricDataPageFromEsDataV

参数名称字段类型是否必填字段说明
请求参数
http headers信息
tokenstring是租户ID
typeint否

查询类型：

null/0/6 : 今日；

1：本周；

2：本月；

3：本年；

4：昨日；

5：前天；

body
pageJSONObject是分页参数
pagecurrentint是当前页
sizeint是每页大小
customQueryParamsJSONObject是自定义查询参数
customQueryParamsqueryTimeStartstring否查询开始时间
queryTimeEndstring否查询结束时间
necessaryFieldListJSONArrays是设备属性值名称
deviceCodestring是设备编码
返回结果参考示例

请求数据示例：

{
  "page": {
    "current": 1,
    "size": 5
  },
  "customQueryParams": {
    "deviceCode": "VIR1636339501431",
    "queryTimeStart": "2021-11-01 00:00:00",
    "queryTimeEnd": "2021-11-10 23:59:59",
    "necessaryFieldList": [
      "gas_AD_value",
      "gas_reaction_medium_failure",
      "sensor_breakdown",
      "fire_alarm"
    ]
  }
}

返回数据示例：

{
    "success": true,
    "code": "success",
    "level": "info",
    "message": "操作成功",
    "data": {
        "records": [
            {
                "createTime": "2021-11-08 10:49:50",
                "deviceTypeName": "燃气监测（多维度标签）",
                "sensor_breakdown": 0,
                "gas_AD_value": 626,
                "deviceCode": "VIR1636339501431",
                "deviceUnitCode": "KRQTJC-NBAO-01-0055",
                "fire_alarm": 0,
                "gas_reaction_medium_failure": 0,
                "deviceName": "燃气监测（多维度标签）1431燃气监测（多维度标签）"
            }
        ],
        "total": 1,
        "size": 5,
        "current": 1,
        "orders": [],
        "searchCount": true,
        "pages": 1
    }
}

results matching ""

    No results matching ""