开放平台开发文档

Appearance

智慧安消 ​

查询安消设备基础信息 ​

接口功能 ​

查询设备基础信息

请求地址 ​

https://open.andmu.cn/v3/open/api/device/base/info

请求方式 ​

POST，需要鉴权

请求参数 ​

参数名称参数类型是否必需参数含义说明
deviceIdStringY设备编码安消设备的编码为 IMEI

请求示例 ​

{
    "deviceId": "1212121212121212"
}

响应参数 ​

参数名称参数类型参数含义说明
deviceIdString设备编码
deviceNameString设备名称
storeIdString节点 ID
storeNameString节点名称
deviceModelInteger设备型号
classificationTypeInteger设备分类1 消防设备
2 传感器设备
3 视频设备
4 通用设备 (本版本仅涉及消防设备)
deviceTypeInteger设备类型1 烟感设备
2 可燃气体
3 视频设备
4 温湿度设备
5 温感设备
6 水感设备
7 手报设备
8 门磁设备
9 用电设备
10 用水设备
11 用传设备
12 主机设备
13 安防设备
14 广播设备
netTypeInteger联网类型1-NB
2-2G/4G
3-MQTT
4-WIFI
5-有线
deviceCompanyInteger设备厂商
systemAddressString系统地址仅限传感器设备、json 格式字符串 例： { "system_address":"2222", "system_type":"111", "component_address":"23333", "component_type":"444" }
loopString回路仅限传感器设备
nodeString节点仅限传感器设备
parentDeviceIdString父级设备编码仅限传感器设备
deviceConnectStatusInteger设备连接状态正常：1
故障：0
onlineStatusInteger在线状态在线：1
离线：0
未注册：2
deviceLocationString设备详细位置
deviceLongitudeString设备经度百度地图
deviceLatitudeString设备纬度百度地图
iccIdString设备关联物联卡卡号
deviceProvinceString设备位置所属省份编码
deviceCityString设备位置所属地市编码
deviceDistrictString设备位置所属区县编码

响应示例 ​

{
    "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，需要鉴权

请求参数 ​

参数名称参数类型是否必需参数含义说明
storeIdStringN节点 id不传时,返回该企业全部设备
deviceTypeIntegerN设备类型1 烟感设备
2 可燃气体
3 视频设备
4 温湿度设备
5 温感设备
6 水感设备
7 手报设备
8 门磁设备
9 用电设备
10 用水设备
11 用传设备
12 主机设备
13 安防设备
14 广播设备
connectStatusIntegerN连接状态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 传感器故障
onlineStatusIntegerN在线状态在线：1
离线：0
未注册：2
pageIntegerN分页索引默认 1
pageSizeIntegerN分页大小默认 20

请求示例 ​

{
    "storeId": "1212121212121212"
}

响应参数 ​

参数名称参数类型参数含义
deviceListList<Response>返回设备列表
totalInteger总数
pageInteger当前页
pageSizeInteger每页条数

Response 数据模型 ​

名称类型说明备注
deviceIdString设备编码
deviceNameString设备名称
deviceConnectStatusInteger设备连接状态正常：1
故障：0
onlineStatusInteger设备在线状态在线：1
离线：0
未注册：2
storeIdString设备所属节点 ID
storeNameString设备所属节点名称
deviceModelInteger设备型号
deviceTypeInteger设备类型1 烟感设备
2 可燃气体
3 视频设备
4 温湿度设备
5 温感设备
6 水感设备
7 手报设备
8 门磁设备
9 用电设备
10 用水设备
11 用传设备
12 主机设备
13 安防设备
14 广播设备
classificationTypeInteger设备分类1 消防设备
2 传感器设备
3 视频设备
4 通用设备
isVirtualInteger是否是级联设备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，需要鉴权

请求参数 ​

参数名称参数类型是否必需参数含义说明
deviceIdStringY设备 imei 或者 mac 号

请求示例 ​

{
   "deviceId": "2afa8f"
}

响应参数 ​

参数名称参数类型参数含义说明
propertiesCodeString监测值 ID
propertiesNameString监测值名称
propertiesValueString监测值
reportTimeLong上报时间13 位时间戳

响应示例 ​

{
    "propertiesCode": "1",
    "propertiesName": "检测值名称",
    "propertiesValue": "20",
    "reportTime": 1707101993000
}

查询安消设备监测能力集 ​

接口功能 ​

查询安消设备监测能力集

请求地址 ​

https://open.andmu.cn/v3/open/api/anxiao/device/monitor/ability/query

请求方式 ​

POST，需要鉴权

请求参数 ​

参数名称参数类型是否必需参数含义说明
deviceIdStringY设备idimei 或者 mac

请求示例 ​

{
   "deviceId":"das3156456",
    "region":"865132102112"
}

响应参数 ​

参数名称参数类型参数含义说明
deviceIdString设备 id
abilitiesList< Ability>监测能力集列表

Ability ​

参数名称参数类型参数含义说明
propertiesCodeString监测值 ID
unitString监测值单位
propertiesNameString监测值名称
isShowNumString是否展示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，需要鉴权

请求参数 ​

参数名称参数类型是否必需参数含义说明
deviceIdStringY设备 imei 或者 mac 号

请求示例 ​

{
   "deviceId":"2a213f2"
}

响应参数 ​

参数名称参数类型参数含义说明
codeString信令/控制 ID
nameString信令/控制名称

响应示例 ​

{
    "code": "123",
    "name": "新增"
}

安消设备控制命令下发 ​

接口功能 ​

安消设备控制命令下发。
本接口列出平台已支持的指令，但每款设备支持的命令各有不同，请一定先查询再下发，确认您的设备支持哪些命令后，再通过命令下发接口控制设备。

请求地址 ​

https://open.andmu.cn/v3/open/api/anxiao/device/control/send

请求方式 ​

POST，需要鉴权

请求参数 ​

参数名称参数类型是否必需参数含义说明
deviceIdStringY设备 imei 或者 mac
codeStringY控制命令

code 枚举值： ​

序号code 值名称说明
1query查询数据查询
2erasure消音停止设备警鸣
3reset复位恢复设备正常状态
4timeSync时间同步与设备进行时间同步
5dataSync数据同步同步设备状态
6lowSensistive烟感低灵敏度控制烟感灵敏度
7normalSensitive烟感正常灵敏度控制烟感灵敏度

请求示例 ​

{
   "deviceId":"das3156456",
   "code":"erasure"
}

响应参数 ​

参数名称参数类型参数含义说明

响应示例 ​

{
  "resultCode": "000000",
  "resultMsg": "成功"
}

订阅安消设备告警消息 ​

接口功能 ​

订阅安消设备告警消息

请求地址 ​

https://open.andmu.cn/v3/open/api/app/anxiao/alarm/subscribe

请求方式 ​

POST，需要鉴权

请求参数 ​

参数名称参数类型是否必需参数含义说明
subscribeInfosList< subscribeInfo>Y订阅信息集合最大 30 条

subscribeInfo： ​

参数名称参数类型是否必需参数含义说明
deviceIdStringY设备 id
eventStringN订阅事件集合为空或者不传，则为取消订阅，例："[\"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，需要鉴权

请求参数 ​

参数名称参数类型是否必需参数含义说明
deviceIdStringN设备 id
pageIntegerN分页索引默认 1
pageSizeIntegerN分页大小默认 10,最大 10000

请求示例 ​

{
    "deviceId": "xxxxS_12341234adf",
    "page": 1,
    "pageSize": 100
}

响应参数 ​

参数名称参数类型参数含义
deviceListList<SubscribeInfoDTO>返回设备列表
totalInteger总数
pageInteger当前页
pageSizeInteger每页条数

SubscribeInfoDTO 数据模型 ​

名称类型说明备注
deviceIdString设备编码
eventString订阅事件集合

响应示例 ​


{
    "resultCode": "000000",
    "resultMsg": "成功",
    "total": 1,
    "page": 1,
    "pageSize": 100,
    "data": [
          {
               "deviceId":"xxxxS_12341234adf",
               "event":"[\"fireFighting_alarm\",\"fireFighting_danger\"]"
           }
     ]
}

安消设备告警消息体说明 ​

消息统一数据结构：

参数名称参数类型参数含义说明
appIdString应用id
sigString签名MD5(appId+secret),计算值为32位小写
msgListlist消息列表

msgList数据格式：

参数名称参数类型参数含义说明
msgTypeString消息类型参考消息类型
timeStampString消息时间戳13位毫秒
dataString消息内容不同的消息类型，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结构 ​

参数名称参数类型参数含义说明
deviceIdString设备id
detectTimeString事件时间
alarmContextString事件的内容不同的消息类型，告警的内容不同，请根据消息类型分别解析

alarmContext结构

参数名称参数类型参数含义说明
camerasStringjson字符串数组，关联的摄像头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结构 ​

参数名称参数类型参数含义说明
deviceIdString设备id
detectTimeString事件时间

示例 ​

安消设备隐患消息：

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
设备SN703
设备型号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