智慧消防开放能力说明

本文介绍智慧消防开放能力接入的相关说明。

智慧消防设备控制管理

API 名称	接口地址
设备消音	POST:/v1.0/fire-control/{device_id}/actions/silence-enable

智慧消防事件格式

云开发项目 开启消息订阅 后，可以收到消防设备端上报的事件消息。消息队列接入流程的详细介绍，请参考 消息队列。

数据格式说明

数据上报通过组合多个 code 来形成事件数据。

数据示例：

{
    "dataId": "AAXRV4BrtW9BRB9A2JYW****",
    "devId": "6ca",
    "productKey": "obxxba9vowgc****",
    "status": [
        {
            "1": "eed6810d-82e1-41cd-ba4a-7664f31942cb",
            "code": "alarm_trace_id",
            "t": 1637548630455,
            "value": "eed6810d-82e1-41cd-ba4a-7664f31942cb"
        },
				{
            "5": "未处理",
            "code": "alarm_result_content",
            "t": 1637548630455,
            "value": "未处理"
        },
      	{
            "6": 4065,
            "code": "alarm_value",
            "t": 1637548630455,
            "value": 4065
        },
      	{
            "4": 1650433413000,
            "code": "alarm_trace_time",
            "t": 1637548630455,
            "value": 1650433413000
        },
      	{
            "2": "上限报警",
            "code": "alarm_event_content",
            "t": 1637548630455,
            "value": "上限报警"
        },
      	{
            "7": "MPa",
            "code": "alarm_unit",
            "t": 1637548630455,
            "value": "MPa"
        },
     	 	{
            "3": "device_alarm",
            "code": "fire_alarm_type",
            "t": 1637548630455,
            "value": "device_alarm"
        }
		]
}

告警数据上报

列举说明：

告警数据 Code	数据说明	数据类型
alarm_trace_id	报警事件 ID	String 类型。
alarm_event_content	报警内容	String 类型。
fire_alarm_type	消防设备报警类型	Enum 类型。 fire_alarm：火警报警 device_alarm：设备报警 device_fault：设备故障 signal_fault：通信故障 upper_alarm：上限报警 lower_alarm：下限报警 low_battery：低电告警 state_fault：状态量告警 others：其他
alarm_trace_time	事件发生时间	String 类型。
alarm_result_content	事件处理结果	String 类型。
alarm_value	事件值	Long 类型。上报的值已放大 10000 倍来处理小数点的问题，开发者使用时需除以 10000 来获取真实值。
alarm_unit	报警单位	String 类型。
alarm_process_time	报警处理时间	String 类型。
alarm_level	告警等级	Enum 类型。 event：事件 secondary：次要 important：重要 urgent：紧急

监控数据上报

列举说明：

监控数据 Code	数据说明	数据类型
monitor_name	监测项名称	String 类型。
monitor_data	监测项数据	String 类型。
monitor_value	监测值	Long 类型。上报的值已放大 10000 倍来处理小数点的问题，开发者使用时需除以 10000 来获取真实值。
monitor_unit	监测单位	String 类型。
monitor_time	监测时间	String 类型。

智慧消防事件 1.0 格式

设备事件消息兼容 1.0 版本格式。如需开通 1.0 版本格式，请联系涂鸦工作人员。接入流程参考 行业三方设备事件 1.0 版本格式。

设备报警

功能描述

消防设备发生报警或者异常时，会以报警消息的方式通知开发者。

参数说明

参数名	类型	说明	必填
bizCode	String	事件业务 code，默认 edge_device。	是
eventType	String	事件类型，默认 edge_report_data。	是
mode	String	事件模式，默认 fire_alarm。	是
deviceId	String	涂鸦设备 ID。	是
alarm_trace_id	String	报警事件 ID，用于更新设备报警后的事件处理结果（alarm_result_content）。	是
alarm_event_content	String	报警内容说明。	是
fire_alarm_type	Enum	消防设备报警类型。{“range”:[“fire_alarm”,“device_fault”,“device_alarm”,“others”]}。报警类型包括火警报警、设备故障（电量过低）和设备报警。	是
alarm_trace_time	String	事件发生时间，13 位毫秒时间戳。	是
alarm_result_content	float	事件处理结果描述。由三方平台定义具体内容，文档只是举例。	是
alarm_value	float	事件值。	是
alarm_unit	String	报警的单位。和事件值相关联，比如摄氏度。	是
alarm_process_time	String	报警的处理时间，毫秒。	否

数据示例

{
	"data": "{\"data\":{\"deviceId\":\"6c0********z\",\"dpData\":{\"alarm_trace_id\":\"87-ebe9-47e1-8bab-66f9***4\",\"alarm_event_content\":\"下限报警\",\"fire_alarm_type\":\"device_alarm\",\"alarm_trace_time\":\"15****87\",\"alarm_result_content\":\"未处理\",\"alarm_value\":\“0.003\”,\"alarm_unit\":\"cm\",\"alarm_process_time\":\"1595495410187\"}},\"mode\":\"fire_alarm\"}",
	"bizCode": "edge_device",
	"eventType": "edge_report_data"
}

设备数据上报

功能描述

消防设备检测到数据变化时会上报消息，会以报警消息的方式通知开发者。

参数说明

参数名	类型	说明	必填
bizCode	String	事件业务 code，默认 edge_device。	是
eventType	String	事件类型，默认 edge_report_data。	是
mode	String	事件模式，默认 fire_monitor。	是
deviceId	String	涂鸦设备 ID。	是
monitor_data	String	检测项 code。	是
monitor_name	String	检测项中文名称。	是
monitor_value	数值	检测数据值。	是
monitor_unit	String	检测项数据单位。	是
monitor_time_data	String	检测项数据产生的时间，13 位毫秒时间戳。	是

数据示例

{
	"data": "{\"data\":{\"deviceId\":\"6c0********z\",\"dpData\":{\"monitor_data\":\"tem\",\"monitor_name\":\"温度\",\"monitor_value\":0x0502,\"monitor_unit\":\"摄氏度\",\"monitor_time_data\":\"1595****0187\"}},\"mode\":\"fire_monitor\"}",
	"bizCode": "edge_device",
	"eventType": "edge_report_data"
}