Appearance
智慧安消
查询安消设备基础信息
接口功能
查询设备基础信息
请求地址
https://open.andmu.cn/v3/open/api/device/base/info
请求方式
POST,需要鉴权
请求参数
参数名称 | 参数类型 | 是否必需 | 参数含义 | 说明 |
---|---|---|---|---|
deviceId | String | Y | 设备编码 | 安消设备的编码为 IMEI |
请求示例
{
"deviceId": "1212121212121212"
}
响应参数
参数名称 | 参数类型 | 参数含义 | 说明 |
---|---|---|---|
deviceId | String | 设备编码 | |
deviceName | String | 设备名称 | |
storeId | String | 节点 ID | |
storeName | String | 节点名称 | |
deviceModel | Integer | 设备型号 | |
classificationType | Integer | 设备分类 | 1 消防设备 2 传感器设备 3 视频设备 4 通用设备 (本版本仅涉及消防设备) |
deviceType | Integer | 设备类型 | 1 烟感设备 2 可燃气体 3 视频设备 4 温湿度设备 5 温感设备 6 水感设备 7 手报设备 8 门磁设备 9 用电设备 10 用水设备 11 用传设备 12 主机设备 13 安防设备 14 广播设备 |
netType | Integer | 联网类型 | 1-NB 2-2G/4G 3-MQTT 4-WIFI 5-有线 |
deviceCompany | Integer | 设备厂商 | |
systemAddress | String | 系统地址 | 仅限传感器设备、json 格式字符串 例: { "system_address":"2222", "system_type":"111", "component_address":"23333", "component_type":"444" } |
loop | String | 回路 | 仅限传感器设备 |
node | String | 节点 | 仅限传感器设备 |
parentDeviceId | String | 父级设备编码 | 仅限传感器设备 |
deviceConnectStatus | Integer | 设备连接状态 | 正常:1 故障:0 |
onlineStatus | Integer | 在线状态 | 在线:1 离线:0 未注册:2 |
deviceLocation | String | 设备详细位置 | |
deviceLongitude | String | 设备经度 | 百度地图 |
deviceLatitude | String | 设备纬度 | 百度地图 |
iccId | String | 设备关联物联卡卡号 | |
deviceProvince | String | 设备位置所属省份编码 | |
deviceCity | String | 设备位置所属地市编码 | |
deviceDistrict | String | 设备位置所属区县编码 |
响应示例
{
"resultCode": "000000",
"resultMsg": "成功",
"data": {
"deviceId": "1212121212121212",
"deviceName":"testDevice",
"storeId": "1003170964989689900",
"storeName": "test",
"deviceModel": "cmiot_s4706_001",
"classificationType":1,
"deviceType": 1,
"netType":1,
"deviceCompany": 23,
"deviceConnectStatus":1,
"onlineStatus":1,
"deviceLocation":"重庆市渝北区",
"deviceLongitude":"108",
"deviceLatitude":"43.5",
"deviceProvince":"351",
"deviceCity":"140100",
"deviceDistrict":"140107"
}
}
获取设备列表
接口功能
获取设备列表
请求地址
https://open.andmu.cn/v3/open/api/fire/device/list/query
请求方式
POST,需要鉴权
请求参数
参数名称 | 参数类型 | 是否必需 | 参数含义 | 说明 |
---|---|---|---|---|
storeId | String | N | 节点 id | 不传时,返回该企业全部设备 |
deviceType | Integer | N | 设备类型 | 1 烟感设备 2 可燃气体 3 视频设备 4 温湿度设备 5 温感设备 6 水感设备 7 手报设备 8 门磁设备 9 用电设备 10 用水设备 11 用传设备 12 主机设备 13 安防设备 14 广播设备 |
connectStatus | Integer | N | 连接状态 | 0 未注册 1 离线 2 在线 3 故障 4 通用故障 5 升级故障 6 NB 通讯板欠压 7 寿命超期 8 低电压 9 迷宫污染 10 通信故障 11 欠压故障 12 过压故障 13 过流故障 14 缺相故障 15 电源故障 16 错相故障 17 探测器故障 18 交流掉电故障 19 底座与烟感连接故障 20 烟雾信号异常故障 21 烟雾状态未校准故障 22 温度状态未校准故障 23 温度信号异常故障 24 主板电池低电量故障 25 通信板电池低电量故障 26 主电故障 27 备电故障 28 总线故障 29 设备被拆 30 失联故障 31 短路故障 32 传感器故障 |
onlineStatus | Integer | N | 在线状态 | 在线:1 离线:0 未注册:2 |
page | Integer | N | 分页索引 | 默认 1 |
pageSize | Integer | N | 分页大小 | 默认 20 |
请求示例
{
"storeId": "1212121212121212"
}
响应参数
参数名称 | 参数类型 | 参数含义 |
---|---|---|
deviceList | List<Response> | 返回设备列表 |
total | Integer | 总数 |
page | Integer | 当前页 |
pageSize | Integer | 每页条数 |
Response 数据模型
名称 | 类型 | 说明 | 备注 |
---|---|---|---|
deviceId | String | 设备编码 | |
deviceName | String | 设备名称 | |
deviceConnectStatus | Integer | 设备连接状态 | 正常:1 故障:0 |
onlineStatus | Integer | 设备在线状态 | 在线:1 离线:0 未注册:2 |
storeId | String | 设备所属节点 ID | |
storeName | String | 设备所属节点名称 | |
deviceModel | Integer | 设备型号 | |
deviceType | Integer | 设备类型 | 1 烟感设备 2 可燃气体 3 视频设备 4 温湿度设备 5 温感设备 6 水感设备 7 手报设备 8 门磁设备 9 用电设备 10 用水设备 11 用传设备 12 主机设备 13 安防设备 14 广播设备 |
classificationType | Integer | 设备分类 | 1 消防设备 2 传感器设备 3 视频设备 4 通用设备 |
isVirtual | Integer | 是否是级联设备 | 0:不是 1:是 |
响应示例
{
"resultCode": "000000",
"resultMsg": "成功",
"data": {
"total": 1,
"page": 1,
"pageSize": 100,
[
"deviceId": "1212121212121212",
"deviceName":"testDevice",
"deviceConnectStatus":1,
"onlineStatus":1,
"storeId": "1003170964989689900",
"storeName": "test",
"deviceModel": "cmiot_s4706_001",
"deviceType": 1,
"classificationType":1,
"isVirtual":1
]
}
}
查询安消设备当前监测值
接口功能
查询安消设备当前监测值
请求地址
https://open.andmu.cn/v3/open/api/anxiao/query/device/analog
请求方式
POST,需要鉴权
请求参数
参数名称 | 参数类型 | 是否必需 | 参数含义 | 说明 |
---|---|---|---|---|
deviceId | String | Y | 设备 imei 或者 mac 号 |
请求示例
{
"deviceId": "2afa8f"
}
响应参数
参数名称 | 参数类型 | 参数含义 | 说明 |
---|---|---|---|
propertiesCode | String | 监测值 ID | |
propertiesName | String | 监测值名称 | |
propertiesValue | String | 监测值 | |
reportTime | Long | 上报时间 | 13 位时间戳 |
响应示例
{
"propertiesCode": "1",
"propertiesName": "检测值名称",
"propertiesValue": "20",
"reportTime": 1707101993000
}
查询安消设备监测能力集
接口功能
查询安消设备监测能力集
请求地址
https://open.andmu.cn/v3/open/api/anxiao/device/monitor/ability/query
请求方式
POST,需要鉴权
请求参数
参数名称 | 参数类型 | 是否必需 | 参数含义 | 说明 |
---|---|---|---|---|
deviceId | String | Y | 设备id | imei 或者 mac |
请求示例
{
"deviceId":"das3156456",
"region":"865132102112"
}
响应参数
参数名称 | 参数类型 | 参数含义 | 说明 |
---|---|---|---|
deviceId | String | 设备 id | |
abilities | List< Ability> | 监测能力集列表 |
Ability
参数名称 | 参数类型 | 参数含义 | 说明 |
---|---|---|---|
propertiesCode | String | 监测值 ID | |
unit | String | 监测值单位 | |
propertiesName | String | 监测值名称 | |
isShowNum | String | 是否展示 | 1:展示 0:不展示 |
响应示例
{
"resultCode": "000000",
"resultMsg": "成功",
"data":{
"deviceId":"das3156456",
"abilities":[{
"propertiesCode":"258",
"propertiesName":"信噪比 (SNR)",
"unit":"dBm",
"isShowNum":"1"
}]
}
}
查询安消设备控制命令能力集
接口功能
查询安消设备控制命令能力集。
请一定先查询再下发,确认您的设备支持哪些命令后,再通过命令下发接口控制设备。
请求地址
https://open.andmu.cn/v3/open/api/anxiao/query/device/devCtrlCapabilities
请求方式
POST,需要鉴权
请求参数
参数名称 | 参数类型 | 是否必需 | 参数含义 | 说明 |
---|---|---|---|---|
deviceId | String | Y | 设备 imei 或者 mac 号 |
请求示例
{
"deviceId":"2a213f2"
}
响应参数
参数名称 | 参数类型 | 参数含义 | 说明 |
---|---|---|---|
code | String | 信令/控制 ID | |
name | String | 信令/控制名称 |
响应示例
{
"code": "123",
"name": "新增"
}
安消设备控制命令下发
接口功能
安消设备控制命令下发。
本接口列出平台已支持的指令,但每款设备支持的命令各有不同,请一定先查询再下发,确认您的设备支持哪些命令后,再通过命令下发接口控制设备。
请求地址
https://open.andmu.cn/v3/open/api/anxiao/device/control/send
请求方式
POST,需要鉴权
请求参数
参数名称 | 参数类型 | 是否必需 | 参数含义 | 说明 |
---|---|---|---|---|
deviceId | String | Y | 设备 imei 或者 mac | |
code | String | Y | 控制命令 |
code 枚举值:
序号 | code 值 | 名称 | 说明 |
---|---|---|---|
1 | query | 查询 | 数据查询 |
2 | erasure | 消音 | 停止设备警鸣 |
3 | reset | 复位 | 恢复设备正常状态 |
4 | timeSync | 时间同步 | 与设备进行时间同步 |
5 | dataSync | 数据同步 | 同步设备状态 |
6 | lowSensistive | 烟感低灵敏度 | 控制烟感灵敏度 |
7 | normalSensitive | 烟感正常灵敏度 | 控制烟感灵敏度 |
请求示例
{
"deviceId":"das3156456",
"code":"erasure"
}
响应参数
参数名称 | 参数类型 | 参数含义 | 说明 |
---|---|---|---|
响应示例
{
"resultCode": "000000",
"resultMsg": "成功"
}
订阅安消设备告警消息
接口功能
订阅安消设备告警消息
请求地址
https://open.andmu.cn/v3/open/api/app/anxiao/alarm/subscribe
请求方式
POST,需要鉴权
请求参数
参数名称 | 参数类型 | 是否必需 | 参数含义 | 说明 |
---|---|---|---|---|
subscribeInfos | List< subscribeInfo> | Y | 订阅信息集合 | 最大 30 条 |
subscribeInfo:
参数名称 | 参数类型 | 是否必需 | 参数含义 | 说明 |
---|---|---|---|---|
deviceId | String | Y | 设备 id | |
event | String | N | 订阅事件集合 | 为空或者不传,则为取消订阅,例:"[\"fireFighting_alarm\",\"fireFighting_danger\"]" |
event 可选类型如下:
- fireFighting_alarm(消防报警)
- fireFighting_danger(消防隐患)
请求示例
{
"subscribeInfos": [{"deviceId":"3232323"}]
}
响应参数
参数名称 | 参数类型 | 参数含义 | 说明 |
---|---|---|---|
响应示例
{
"resultCode": "000000",
"resultMsg": "成功"
}
查询安消设备消息订阅
接口功能
安消设备消息订阅查询,订阅消息流程请参考官网文档,与视频设备相同
请求地址
https://open.andmu.cn/v3/open/api/alarm/subscribe/query
请求方式
POST,需要鉴权
请求参数
参数名称 | 参数类型 | 是否必需 | 参数含义 | 说明 |
---|---|---|---|---|
deviceId | String | N | 设备 id | |
page | Integer | N | 分页索引 | 默认 1 |
pageSize | Integer | N | 分页大小 | 默认 10,最大 10000 |
请求示例
{
"deviceId": "xxxxS_12341234adf",
"page": 1,
"pageSize": 100
}
响应参数
参数名称 | 参数类型 | 参数含义 |
---|---|---|
deviceList | List<SubscribeInfoDTO> | 返回设备列表 |
total | Integer | 总数 |
page | Integer | 当前页 |
pageSize | Integer | 每页条数 |
SubscribeInfoDTO 数据模型
名称 | 类型 | 说明 | 备注 |
---|---|---|---|
deviceId | String | 设备编码 | |
event | String | 订阅事件集合 |
响应示例
{
"resultCode": "000000",
"resultMsg": "成功",
"total": 1,
"page": 1,
"pageSize": 100,
"data": [
{
"deviceId":"xxxxS_12341234adf",
"event":"[\"fireFighting_alarm\",\"fireFighting_danger\"]"
}
]
}
安消设备告警消息体说明
消息统一数据结构:
参数名称 | 参数类型 | 参数含义 | 说明 |
---|---|---|---|
appId | String | 应用id | |
sig | String | 签名 | MD5(appId+secret),计算值为32位小写 |
msgList | list | 消息列表 |
msgList
数据格式:
参数名称 | 参数类型 | 参数含义 | 说明 |
---|---|---|---|
msgType | String | 消息类型 | 参考消息类型 |
timeStamp | String | 消息时间戳 | 13位毫秒 |
data | String | 消息内容 | 不同的消息类型,data的格式不同,请根据消息类型分别解析 |
json
{
"appId": "xxx",
"sig": "xxx",
"msgList": [{
"msgType": "xxx",
"timeStamp": "xxx",
"data": {
"xxx": "xxx"
}
}, {
"msgType": "xxx",
"timeStamp": "xxx",
"data": {
"xxx": "xxx"
}
}]
}
消息类型
消息类型 | 说明 |
---|---|
MESSAGE_FIRE_FIGHTING_ALARM | 安消设备告警消息 |
MESSAGE_FIRE_FIGHTING_DANGER | 安消设备隐患消息 |
安消设备告警消息
MESSAGE_FIRE_FIGHTING_ALARM
data结构
参数名称 | 参数类型 | 参数含义 | 说明 |
---|---|---|---|
deviceId | String | 设备id | |
detectTime | String | 事件时间 | |
alarmContext | String | 事件的内容 | 不同的消息类型,告警的内容不同,请根据消息类型分别解析 |
alarmContext
结构
参数名称 | 参数类型 | 参数含义 | 说明 |
---|---|---|---|
cameras | String | json字符串数组,关联的摄像头ID | 摄像头ID数组,如xxxxS_2418c624d26b, gb_45671234561324556789 |
示例
安消设备告警消息:
json
{
"...": "...",
"msgList": [{
"msgType": "MESSAGE_FIRE_FIGHTING_ALARM",
"timeStamp": "1583317657000",
"data": {
"deviceId": "xxxxS_abcde",
"detectTime": "1593317657000",
"alarmContext":"{\"cameras\":[\"xxxxS_dcd535863eff\",\"gb_45671234561324556789\"]}"
}
}]
}
安消设备隐患消息
MESSAGE_FIRE_FIGHTING_DANGER
data结构
参数名称 | 参数类型 | 参数含义 | 说明 |
---|---|---|---|
deviceId | String | 设备id | |
detectTime | String | 事件时间 |
示例
安消设备隐患消息:
json
{
"...": "...",
"msgList": [{
"msgType": "MESSAGE_FIRE_FIGHTING_DANGER",
"timeStamp": "1583317657000",
"data": {
"deviceId": "xxxxS_abcde",
"detectTime": "1593317657000"
}
}]
}
平台已支持的监测值总集合
展示平台已支持的监测值名称、监测值 ID
列表
监测值名称 | 监测值ID |
---|---|
高度 | 2 |
温度 | 3 |
压力(兆帕) | 4 |
压力(千帕) | 5 |
气体浓度 | 6 |
时间 | 7 |
电压 | 8 |
电流 | 9 |
流量 | 10 |
风量 | 11 |
剩余电流 | 128 |
湿度 | 129 |
信号强度(CSQ) | 130 |
信号强度(RSSI) | 131 |
重发次数 | 132 |
高精度电压 | 256 |
开关量 | 257 |
信噪比 (SNR) | 258 |
信号功率 (Signal power) | 259 |
覆盖等级 (ECL) | 260 |
物理小区标识 (PCI) | 261 |
传感器采样值 | 264 |
灵敏度 | 265 |
电池电量百分比 | 266 |
本底值 | 267 |
CO气体浓度 | 268 |
液位 | 401 |
液位高限报警值 | 402 |
液位低限报警值 | 403 |
压力高限报警值 | 404 |
压力低限报警值 | 405 |
电池电压 | 406 |
通道1状态 | 411 |
通道2状态 | 412 |
通道3状态 | 413 |
通道4状态 | 414 |
通道5状态 | 415 |
通道6状态 | 416 |
通道7状态 | 417 |
通道8状态 | 418 |
应用版本 | 701 |
设备种类 | 702 |
设备SN | 703 |
设备型号 | 704 |
固件版本 | 705 |
IP地址 | 706 |
网络类型 | 707 |
底座电量百分比 | 801 |
主板电池电量 | 802 |
通信板电池电量 | 803 |
开量 | 804 |
关量 | 805 |
参考信号接收功率 | 806 |
参考信号接收质量 | 807 |
NB电池板电量 | 808 |
烟雾板电量 | 809 |
迷宫污染度 | 810 |
烟雾浓度 | 811 |
红光本底值 | 812 |
蓝光本底值 | 813 |
红光采样值 | 814 |
蓝光采样值 | 815 |
保活时间 | 821 |
版本协议号 | 823 |
安消各设备支持的监测值列表
若需要了解各个安消设备型号支持的监测值名称、监测值 ID,请前往云文档查看。 https://docs.qq.com/sheet/DTGZZc01qcWpVdnVO?tab=BB08J2
设备所属省地市行政区划代码
请前往政府官方网站获取最新行政区划代码信息。 供参考(23年版本编码):https://www.mca.gov.cn/mzsj/xzqh/2023/202301xzqh.html