跳到主要内容

数据查询

什么是数据查询？​

由 第三方 主动向 本平台 查询所需数据信息。

我想要查询其它数据怎么办？​

建议直接联系平台方负责人，由负责人评估后没问题即提供。

TOKEN获取方式​

第1步 登录北向平台​

第2步 获取应用id与密钥​

第3步 请求TOKEN​

  • 接口路径：https://www.lian-yun.cn/smkgw/inorthmanageservice/api/v1.0.0/northreport/open/token/import
  • 请求方法：POST
  • 请求头：无
  • 请求参数(multipart/form-data)：
参数名称参数类型必填说明
appIdstring是应用ID
appSecretstring是密钥
  • 返回结果：
参数名称参数类型必填说明
codestring是错误码，200表示成功，其它表示失败
messagestring否错误描述
access_tokenstring否token串，有效期2小时

接口列表​

1. 查询报警分析统计​

  • 接口路径： https://www.lian-yun.cn/smkgw/inorthmanageservice/api/v1.0.0/northreport/open/query/alarm/type/analyse/import
  • 接口调用频率限制：200次/分
  • 请求方法：GET
  • 请求头：
参数名称参数类型必填说明内容
Authorizationstring是头部校验串Basic:{access_token}
  • 请求参数(multipart/form-data):
参数名称参数类型必填说明
deviceTypestring是设备类型，如：smoke-烟感，gas-燃气
deviceNosstring否查询多个设备统计，多个设备以逗号分隔：1,2,3,4,5
datestring否日期统计，格式为yyyy-MM查询某月的统计，格式为yyyy-MM-dd查询某日的统计
  • 返回结果：
参数名称参数类型必填说明
codestring是错误码，200表示成功，其它表示失败
messagestring否错误描述
datajsonArray否数据体：
value-数量
key-报警类型
name-报警类型中文描述
样例

{ "code": 200, "message": "操作成功", "data": [ { "value": 0, "key": "sensorFault", "name": "传感器故障" }, { "value": 0, "key": "temp", "name": "温度报警" }, { "value": 0, "key": "test", "name": "测试报警" }, { "value": 0, "key": "fault", "name": "故障报警" }, { "value": 0, "key": "fire", "name": "火警" }, { "value": 0, "key": "infrared", "name": "红外报警" }, { "value": 0, "key": "open", "name": "拆开报警" }, { "value": 0, "key": "lowPower", "name": "低电报警" } ] }

2. 查询账号下的设备​

  • 接口路径： https://www.lian-yun.cn/smkgw/inorthmanageservice/api/v1.0.0/northreport/open/query/device/list/import
  • 接口调用频率限制：200次/分
  • 请求方法：GET
  • 请求头：
参数名称参数类型必填说明内容
Authorizationstring是头部校验串Basic:{access_token}
  • 请求参数(multipart/form-data):
参数名称参数类型必填说明
deviceTypestring否设备类型，如：smoke-烟感，gas-燃气
startint是分页下标，从1开始，每页+1
limitint是每页数量，最大100
  • 返回结果：
参数名称参数类型必填说明
codestring是错误码，200表示成功，其它表示失败
messagestring否错误描述
dataobject否数据体：
pageNum-当前页
pageSize-当页数量
totalPage-总页数
total-总行数
list-行数据
参数说明

deviceId 设备平台唯一编码
imei 设备号
deviceName 设备名称
deviceLocation 安装位置
deviceType 设备类型
deviceTypeDesc 设备类型描述
ICCID 设备ICCID
online 在线状态 0离线 1在线
alarm 报警状态 0正常 1报警
disable 禁用状态 0正常 1禁用
placeName 安装场所名称
placeLocation 安装场所位置
resident 安装场所负责人
placePoint 安装场所经纬度(高德坐标)
expirationDate 平台服务到期时间
updateTime 设备最后一次心跳时间
registerTime 设备平台注册时间

3. 查询某台设备的详细信息​

  • 接口路径： https://www.lian-yun.cn/smkgw/inorthmanageservice/api/v1.0.0/northreport/open/query/device/detail/import
  • 接口调用频率限制：2000次/分
  • 请求方法：GET
  • 请求头：
参数名称参数类型必填说明内容
Authorizationstring是头部校验串Basic:{access_token}
  • 请求参数(multipart/form-data):
参数名称参数类型必填说明
deviceTypestring是设备类型，如：smoke-烟感，gas-燃气
deviceIdstring是设备平台编码
  • 返回结果：
参数名称参数类型必填说明
codestring是错误码，200表示成功，其它表示失败
messagestring否错误描述
dataobject否数据体
参数说明

deviceId 设备平台唯一编码
imei 设备号
deviceName 设备名称
deviceLocation 安装位置
deviceType 设备类型
deviceTypeDesc 设备类型描述
ICCID 设备ICCID
online 在线状态 0离线 1在线
alarm 报警状态 0正常 1报警
disable 禁用状态 0正常 1禁用
placeName 安装场所名称
placeLocation 安装场所位置
resident 安装场所负责人
placePoint 安装场所经纬度(高德坐标)
expirationDate 平台服务到期时间
updateTime 设备最后一次心跳时间
registerTime 设备平台注册时间
imgPath1 安装图片
imgPath2 安装图片
imgPath3 安装图片
imgPath4 安装图片
imgPath5 安装图片
imgPath6 安装图片
imgPath7 安装图片
imgPath8 安装图片
orgId 所属行政区划代码
orgName 所属行政区划名称
serviceMode 平台服务模式
serviceModeDesc 平台服务模式描述

4. 查询某台空开的所有开关​

  • 接口路径： https://www.lian-yun.cn/smkgw/inorthmanageservice/api/v1.0.0/northreport/open/query/switch/list/import
  • 接口调用频率限制：2000次/分
  • 请求方法：GET
  • 请求头：
参数名称参数类型必填说明内容
Authorizationstring是头部校验串Basic:{access_token}
  • 请求参数(multipart/form-data):
参数名称参数类型必填说明
deviceIdstring是设备平台编码
  • 返回结果：
参数名称参数类型必填说明
codestring是错误码，200表示成功，其它表示失败
messagestring否错误描述
dataarray[object]否数据体
参数说明

lineId 开关平台唯一编码
lineName 开关名称
lineNumber 开关编号
modelName 模组型号/名称
modelType 模组类型
version 版本
sort 序号，数字越小越靠前
np 1-1P,2-2P,3-3P,4-4P;其它表示未上报
address 安装位置
createdTime 生成时间
updateTime 最后一次心跳时间
chargeStatus 电瓶车充电报警状态 0-正常 1-报警
switchState 分合闸状态，0分闸 1合闸
totalElec 总用电量 kwh
todayElec 今日用电量 kwh
powerFactor 功率因数
frequency 频率 hz
leakage 漏电流 mA
voltA A相电压 V
voltB B相电压 V
voltC C相电压 V
currA A相电流 A
currB B相电流 A
currC C相电流 A
powerA A相功率 W
powerB B相功率 W
powerC C相功率 W
tempA A相温度 °C
tempB B相温度 °C
tempC C相温度 °C
tempN A相温度 °C

5. 查询账号下未处理的报警​

  • 接口路径： https://www.lian-yun.cn/smkgw/inorthmanageservice/api/v1.0.0/northreport/open/query/alarm/list/import
  • 接口调用频率限制：200次/分
  • 请求方法：GET
  • 请求头：
参数名称参数类型必填说明内容
Authorizationstring是头部校验串Basic:{access_token}
  • 请求参数(multipart/form-data):
参数名称参数类型必填说明
deviceTypestring否设备类型，如：smoke-烟感，gas-燃气
deviceIdstring否设备平台编码
startint是分页下标，从1开始，每页+1
limitint是每页数量，最大100
  • 返回结果：
参数名称参数类型必填说明
codestring是错误码，200表示成功，其它表示失败
messagestring否错误描述
dataobject否数据体：
pageNum-当前页
pageSize-当页数量
totalPage-总页数
total-总行数
list-行数据
参数说明

alarmId 平台报警记录ID
alarmType 报警类型
alarmTypeDesc 报警类型描述
deviceType 设备类型
deviceTypeDesc 设备类型描述
alarmTrigger 报警处理状态 0-未处理 1-已处理
alarmContent 报警内容(需自行解析)
alarmTime 报警时间
deviceId 设备平台唯一编码
imei 设备号
deviceName 设备名称
deviceLocation 设备安装位置

6. 查询账号下已处理的报警​

  • 接口路径： https://www.lian-yun.cn/smkgw/inorthmanageservice/api/v1.0.0/northreport/open/query/alarm/process/list/import
  • 接口调用频率限制：200次/分
  • 请求方法：GET
  • 请求头：
参数名称参数类型必填说明内容
Authorizationstring是头部校验串Basic:{access_token}
  • 请求参数(multipart/form-data):
参数名称参数类型必填说明
monthstring是查询月份，需指定月份查询，格式：yyyyMM
deviceTypestring否设备类型，如：smoke-烟感，gas-燃气
deviceIdstring否设备平台编码
startint是分页下标，从1开始，每页+1
limitint是每页数量，最大100
  • 返回结果：
参数名称参数类型必填说明
codestring是错误码，200表示成功，其它表示失败
messagestring否错误描述
dataobject否数据体：
pageNum-当前页
pageSize-当页数量
totalPage-总页数
total-总行数
list-行数据
参数说明

alarmId 平台报警记录ID
alarmType 报警类型
alarmTypeDesc 报警类型描述
deviceType 设备类型
deviceTypeDesc 设备类型描述
alarmTrigger 报警处理状态 0-未处理 1-已处理
alarmContent 报警内容(需自行解析)
alarmTime 报警时间
deviceId 设备平台唯一编码
imei 设备号
deviceName 设备名称
deviceLocation 设备安装位置
alarmClearType 报警处理方式
alarmClearTypeDesc 报警处理方式描述
clearRemark 报警处理说明
operateUser 报警处理人
alarmClearTime 报警处理时间