数据查询
什么是数据查询?
由 第三方 主动向 本平台 查询所需数据信息。
我想要查询其它数据怎么办?
建议直接联系平台方负责人,由负责人评估后没问题即提供。
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):
参数名称 | 参数类型 | 必填 | 说明 |
---|---|---|---|
appId | string | 是 | 应用ID |
appSecret | string | 是 | 密钥 |
- 返回结果:
参数名称 | 参数类型 | 必填 | 说明 |
---|---|---|---|
code | string | 是 | 错误码,200表示成功,其它表示失败 |
message | string | 否 | 错误描述 |
access_token | string | 否 | token串,有效期2小时 |
接口列表
1. 查询报警分析统计
- 接口路径: https://www.lian-yun.cn/smkgw/inorthmanageservice/api/v1.0.0/northreport/open/query/alarm/type/analyse/import
- 接口调用频率限制:200次/分
- 请求方法:GET
- 请求头:
参数名称 | 参数类型 | 必填 | 说明 | 内容 |
---|---|---|---|---|
Authorization | string | 是 | 头部校验串 | Basic:{access_token} |
- 请求参数(multipart/form-data):
参数名称 | 参数类型 | 必填 | 说明 |
---|---|---|---|
deviceType | string | 是 | 设备类型,如:smoke-烟感,gas-燃气 |
deviceNos | string | 否 | 查询多个设备统计,多个设备以逗号分隔:1,2,3,4,5 |
date | string | 否 | 日期统计,格式为yyyy-MM查询某月的统计,格式为yyyy-MM-dd查询某日的统计 |
- 返回结果:
参数名称 | 参数类型 | 必填 | 说明 |
---|---|---|---|
code | string | 是 | 错误码,200表示成功,其它表示失败 |
message | string | 否 | 错误描述 |
data | jsonArray | 否 | 数据体: 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
- 请求头:
参数名称 | 参数类型 | 必填 | 说明 | 内容 |
---|---|---|---|---|
Authorization | string | 是 | 头部校验串 | Basic:{access_token} |
- 请求参数(multipart/form-data):
参数名称 | 参数类型 | 必填 | 说明 |
---|---|---|---|
deviceType | string | 否 | 设备类型,如:smoke-烟感,gas-燃气 |
start | int | 是 | 分页下标,从1开始,每页+1 |
limit | int | 是 | 每页数量,最大100 |
- 返回结果:
参数名称 | 参数类型 | 必填 | 说明 |
---|---|---|---|
code | string | 是 | 错误码,200表示成功,其它表示失败 |
message | string | 否 | 错误描述 |
data | object | 否 | 数据体: 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
- 请求头:
参数名称 | 参数类型 | 必填 | 说明 | 内容 |
---|---|---|---|---|
Authorization | string | 是 | 头部校验串 | Basic:{access_token} |
- 请求参数(multipart/form-data):
参数名称 | 参数类型 | 必填 | 说明 |
---|---|---|---|
deviceType | string | 是 | 设备类型,如:smoke-烟感,gas-燃气 |
deviceId | string | 是 | 设备平台编码 |
- 返回结果:
参数名称 | 参数类型 | 必填 | 说明 |
---|---|---|---|
code | string | 是 | 错误码,200表示成功,其它表示失败 |
message | string | 否 | 错误描述 |
data | object | 否 | 数据体 |
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
- 请求头:
参数名称 | 参数类型 | 必填 | 说明 | 内容 |
---|---|---|---|---|
Authorization | string | 是 | 头部校验串 | Basic:{access_token} |
- 请求参数(multipart/form-data):
参数名称 | 参数类型 | 必填 | 说明 |
---|---|---|---|
deviceId | string | 是 | 设备平台编码 |
- 返回结果:
参数名称 | 参数类型 | 必填 | 说明 |
---|---|---|---|
code | string | 是 | 错误码,200表示成功,其它表示失败 |
message | string | 否 | 错误描述 |
data | array[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
- 请求头:
参数名称 | 参数类型 | 必填 | 说明 | 内容 |
---|---|---|---|---|
Authorization | string | 是 | 头部校验串 | Basic:{access_token} |
- 请求参数(multipart/form-data):
参数名称 | 参数类型 | 必填 | 说明 |
---|---|---|---|
deviceType | string | 否 | 设备类型,如:smoke-烟感,gas-燃气 |
deviceId | string | 否 | 设备平台编码 |
start | int | 是 | 分页下标,从1开始,每页+1 |
limit | int | 是 | 每页数量,最大100 |
- 返回结果:
参数名称 | 参数类型 | 必填 | 说明 |
---|---|---|---|
code | string | 是 | 错误码,200表示成功,其它表示失败 |
message | string | 否 | 错误描述 |
data | object | 否 | 数据体: 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
- 请求头:
参数名称 | 参数类型 | 必填 | 说明 | 内容 |
---|---|---|---|---|
Authorization | string | 是 | 头部校验串 | Basic:{access_token} |
- 请求参数(multipart/form-data):
参数名称 | 参数类型 | 必填 | 说明 |
---|---|---|---|
month | string | 是 | 查询月份,需指定月份查询,格式:yyyyMM |
deviceType | string | 否 | 设备类型,如:smoke-烟感,gas-燃气 |
deviceId | string | 否 | 设备平台编码 |
start | int | 是 | 分页下标,从1开始,每页+1 |
limit | int | 是 | 每页数量,最大100 |
- 返回结果:
参数名称 | 参数类型 | 必填 | 说明 |
---|---|---|---|
code | string | 是 | 错误码,200表示成功,其它表示失败 |
message | string | 否 | 错误描述 |
data | object | 否 | 数据体: 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
报警处理时间