智慧消防智能管控平台

对接指南

                              V1.3.0

浙江省消防总队

2019.4.8

目录

1.概述... 3

1.1编写目的... 3

1.2文档简述... 3

1.3规范性引用文件... 3

1.4术语和定义... 4

1.4.1消防远程监控系统... 4

1.4.2智慧用电系统... 4

1.4.3智慧用水系统... 5

1.4.4智能预警系统... 5

1.4.5智能充电桩系统... 6

1.4.6单位自主管理系统... 7

1.4.7其它名词... 7

1.5 缩略语... 7

2. 接口交换项简要说明... 7

2.1 全局说明... 7

2.1.1 一般要求... 7

2.1.2 对接流程图示... 8

2.1社会单位基本信息... 8

2.2运营服务公司... 9

2.3设备信息... 9

2.4部件信息... 9

2.5实时报警信息... 10

3. 对接格式与方法... 10

3.1对接格式... 10

3.2智慧消防智能管控平台向各平台采集数据... 11

3.3各平台向智慧消防智能管控平台报送数据... 12

4. 对接接口详细内容... 14

4.1智慧消防智能管控平台向各平台采集数据... 14

4.1.1单位（或者站点、或者建筑）信息... 14

4.1.2运营服务公司... 16

4.1.3设备信息... 18

4.1.4设备部件信息... 21

4.2 各平台向智能管控平台上报或推送信息... 23

4.2.1报警信息（实时）... 23

5. 字典表... 24

5.1社会单位类型【字典】... 24

5.2区域维表【字典】... 25

5.3平台开发公司【字典】... 25

5.4告警类型【字典】... 25

5.5设备类型【字典】... 27

5.6部件类型【字典】... 27

1.概述

1.1编写目的

编写本文档的目的在于确定“智慧消防”智能管控平台与各“智慧消防”服务平台的数据对接方法，以及在对接过程中双方所需遵循的规范、内容和协议等。

本文档同样可为其它“智慧消防”平台数据互通提供参考。

1.2文档简述

本文档包含：

l  第一部分规定了各类智能防控系统定义；

l  第二部分提供了平台数据互通的接口内容概述；

l  第三部分规定了对接的主要方法和格式；

l  第四部分规定了数据互通的详细内容；

l  第五部分提供了全文档涉及的字典表。

1.3 规范性引用文件

下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅注日期的版本适用于本文件。凡是不注日期的引用文件，其*新版本(包括所有的修改单)适用于本文件。

GB/T 8566-2007 信息技术软件生存周期过程

GB/T 22240-2008信息安全技术信息系统安全等级保护基本要求

GB/T 26875.3-2011城市消防远程监控系统 第3部分:报警传输网络通信协议

GB/T 26875.4-2011 城市消防远程监控系统 第4部分：基本数据项

GB/T 26875.8-2015 城市消防远程监控系统 第8部分:监控中心对外数据交换协议

GB 50440 城市消防远程监控系统技术规范

RFC 2616 超文本传输协议(Hypertext Transfer Protocol-HTTP/1.1)

RFC 2818 超文本传输安全协议(HTTP Over TLS)

RFC 3629 ISO 10646的转换格式(UTF-8，a transformation format of ISO 10646)

RFC 4627 JSON格式定义（The application/json Media Type for JavaScript Object Notation (JSON)）

GB/T 2260-2007 中华人民共和国行政区划代码

GB/T10114-2003县以下行政区划代码编制规则

1.4术语和定义

1.4.1消防远程监控系统

消防远程监控系统是由监控中心、用户信息传输装置、数据通信网络和管理软件等组成的综合性应用系统，系统综合运用物联网、地理信息、数字视频监控等技术手段，实现对联网单位火灾报警、监管、故障等多种信号进行实时监测，提高火灾报警的及时性和可靠性，实现对消防设施的网络化集中管理，对重要场所和高危单位的报警处置实行定位跟踪，提高消防监督执法的针对性和有效性，并应用平台提供的消控室值班人员查岗机制，督促社会单位提高自身消防安全管理水平。

图1-1本文档中消防远程监控系统的设备和部件等简要说明和示意

1.4.2智慧用电系统

智慧用电系统，由传感器及传感终端装置、传感传输装置及系统平台组成，传感器安装在电气线路和用电设备上，实现实时发现漏电、过载等安全隐患，并即时向管理人员发送预警信息等，可以指导企业单位自主开展隐患治理，消除潜在的电气安全隐患。

图1-2本文档中智慧用电系统的设备和部件等简要说明和示意

1.4.3智慧用水系统

智慧用水系统由液压、液位传感器、物联网采集终端和系统平台组成。能实时获取室内外消火栓中的水压和消防水池、水箱的液位信息，并能通过网络进行数据监测和报警。

图1-3本文档中智慧用水系统的设备和部件等简要说明和示意

1.4.4智能预警系统

智能预警系统由无线烟感、无线声光、无线手报、无线智能网关控制器和运营平台组成。系统具备无线烟感触发蜂鸣器报警、人员手机APP报警、应急中心报警、联动声光报警等四项预警功能，可精.确定位报警位置，实现设备电压欠压、探头、声光等故障诊断与信息报告、大数据分析等功能。

图1-4本文档中智能预警系统的设备和部件等简要说明和示意

1.4.5智能充电桩系统

电动自行车智能充电桩系统由智能充电桩、主机、通讯设备、服务端和移动客户端应用系统，采用了多级防过流、防短路、防漏电、防雷、防过充、限流、防雨、高温报警、充电实时监控、异常自动判断自动断电、充满自动断电等安全保护措施；提供电动车车主、充电车辆、充电电量、区域分布等大数据，实现事前预防、事中监控，事后补救的人防、技防和物防三防大融合。

图1-5本文档中智能充电桩系统的设备和部件等简要说明和示意

1.4.6单位自主管理系统

单位自主管理系统通过信息化手段为单位提供消防内部安全管理工具，实现消防安全基础档案管理、消防巡查、日常检查、单位智慧消防物联网设备报警和处置等。并可实现单位消防安全教育、单位消防安全预案管理和消防演练、消防安全群众举报、消防监督管理和消防维保监测管理等功能。

1.4.7其它名词

平台开发公司：本文中指智慧消防应用的软件平台开发公司。

运营服务公司：本文中指智慧消防应用和*终用户签署销售和服务合同，履行设备安装、售后服务的公司。运营服务公司可能和平台开发公司为同一家公司，但也存在为第三方公司或平台开发公司下属子公司。

设备（部件）生产公司：本文中指这类硬件设备的制造、生产厂家。

1.5 缩略语

下列缩略语适用于本文件。

HTTP：超文本传输协议(Hypertext Transfer Protocol)

HTTPS：超文本传输安全协议(HTTP Over TLS)

REST：表述性状态转移(Representational State Transfer)

URI：统一资源标识符(Uniform Resource Identifier)

URL：统一资源定位符(Uniform Resource Locator)

JSON:JavaScript 对象表示法( JavaScript Object Notation)

MQ：消息队列（Message Queue）

2. 接口交换项简要说明

2.1 全局说明

2.1.1 一般要求

l  本文档中提供的技术对接方法使用的字符集采用RFC 3629的相关数据规定，数据统一使用（UTF-8）。

l  本文档中提供的对接方法以HTTP或HTTPS协议作为底层承载协议。采用HTTP协议时，应满足RFC 2616的规定；采用HTTPS协议时，应满足RFC 2818的规定。

2.1.2 对接流程图示

图2-1对接主要步骤示意图

2.1社会单位基本信息

“智慧消防”智能管控平台获取各平台社会单位基本信息接口要求如下：

1) 接口名称：pt1_1。

2) 协议：http/https

3) 调用参数：输入{创建开始时间，创建结束时间，更新开始时间，更新结束时间，社会单位（站点、建筑物）唯.一主键}

4) 返回：{社会单位（站点、建筑物）主键，社会单位（站点、建筑物）名称，所属运营服务公司编码（id），详细地址，纬度，经度，区域编码，设备数，所属平台厂商code}

说明：社会单位基本信息即“智慧消防”设备安装所在的社会单位名称，如某某公司。如某些场景下无法提供社会单位基本信息，可提供该建筑物名称，如某某大厦、某某出租房。也可以提供场所站点名称：如某某路口、某某停车场。

运营服务公司即提供“智慧消防”运营服务的公司。如某某消防安全公司。运营服务公司提供智慧消防运营服务，如设备报警处理、日常维护等工作。参见文档2.2章节。

2.2运营服务公司

“智慧消防”智能管控平台获取各平台运营服务公司信息接口要求如下：

1) 接口名称：pt1_2

2) 接口协议：http/https

3) 接口调用参数：输入{创建开始时间，创建结束时间，更新开始时间，更新结束时间，运营服务公司唯.一主键}

4) 返回值：{运营公司ID，运营公司名称，运营公司编码，运营公司地址，联系人姓名，联系人电话}

2.3设备信息

“智慧消防”智能管控平台获取各平台设备信息接口要求如下

1) 接口名称：pt1_3

2) 接口协议：http/https

3) 接口调用参数：输入{创建开始时间，创建结束时间，更新开始时间，更新结束时间，设备唯.一主键}

4) 返回值：{设备id，设备名称，设备类型，地址，纬度，经度，运营服务公司，社会单位（站点或者建筑物）id，平台厂商code，安装日期，设备状态，设备生产公司或品牌，部件数量}

说明：远程监控平台的设备含义为用户信息传输装置。具体可参考1.4术语和定义。

2.4部件信息

智慧消防智能管控平台获取各平台部件信息接口要求如下

1) 接口名称：pt1_4

2) 接口协议：http/https

3) 接口调用参数：输入{创建开始时间，创建结束时间，更新开始时间，更新结束时间，设备部件唯.一主键}

4) 返回值：{设备部件id，设备部件名称，地址，设备部件关联的设备id，部件生产厂家或品牌，安装日期，设备部件状态，设备部件类型}

说明：远程监控平台的部件含义为用户信息传输装置连接的部件设备。具体可参考1.4术语和定义。

2.5实时报警信息

1) 接口名称：pt1_5

2) 接口协议：RabbitMq

3) 返回值：{报警编号id，设备id，社会单位（建筑、站点）主键,发生时间，报警信息json，报警类型（详见字典表：报警类型），设备部件id，平台厂商code}

4) 功能说明：

1）  设备发生告警时，即时向RabbitMq消息队列中推送告警信息

说明：1）报警信息由各平台向智慧消防智能管控平台主动推送。2）平台开发公司即各智慧消防平台的软件开发和提供公司。

3. 对接格式与方法

3.1对接格式

各接口返回数据字段都以驼峰格式命名

接口返回格式：

{

       code:0,   //Integer

       message:”code中文说明”, //String

data:返回数据 //Object

}

//分页列表时，data格式

data: {

pageNo: 1,    //当前页码

pageSize: 50, //每页条数

pageCount: 2, //总页数

              count:80,    //总条数

        list: [                 //数据列表

            {

            }

        ]

    }

3.2智慧消防智能管控平台向各平台采集数据

请求认证，接入数据系统提供用户名，密码及加密公钥获取认证token，智慧消防智能管控平台在之后的数据请求头中，通过携带token认证获取数据；获取公钥接口接口说明：

返回结果示例：

{

       code:0,

       message:”获取成功”,

data:{

publicKey:”CPf+KadCgGJYRsosgsodB5Ob8eEMYzJpaRQusPEJC0mUWxm2NUsZmhxuksZuVWsCNxsOuDita922nM2y1wcUsxTHLrdIad+tlNYqqoWuUOBuGiDajG8jVu9jj4jKTpKa+hc+00pqggwYu7psRz3xiebE9HiPPUjNaiPK+aqlKSrGlXIGJOWvqJxeOxpb/oQ/x9fKQGXT04iewzNQLdQOm/foz3mOJGuvXAt3ulnjBHqBvA6p27a+7NWcfl9AorLV77rX95YZxliiOcEzWIcH0IDFI1PFEDOX/HxFJ7AYwtwoSgQ2Dy5GsJD6RwLA4hazdWzEkZQBzghZKeTEcMRm5A==”

}

}

登录（获取token）

返回结果示例:

{

       code:0,  

message:”认证成功”,

data:{

       tokenId:”1C4F5B016C68B397A731625FA48FC2F1”

}

}

3.3各平台向智慧消防智能管控平台报送数据

1，请求智慧消防提供接口，获取mq服务地址，账号和密码，及对应exchange名称

获取公钥接口接口说明：

返回结果示例：

{

    "code": 0,

    "message": "获取成功",

    "data": {

        "publicKey": "MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAnO6zs6U0xihzyHM/XXrFen2VJ0AysjAWCuc9sSswM6pSO0cHV+vxjpM6+nh5fuVaHd10yzeUqMwG3MwLqSWxkOky43Sl29CmDK1Grrrxh6tUru8Z8WHPzyZ2q82fZfen12X+dIszVJueuMyRgtgSHedjeRnivWGBeFPBFUwMOIMfyofzz43Vavhtm23mE5M9OGdjnLc45pkfxe7XiEl27kwZAlInT1cJw9iFGl8rgt4DVMlXpjFtLgy5fod1iOh8zNLMfvGv9gdGqIorzMhcXMjNG6IAlVITUenk2lutnUwE2YJH72YRTlUue8ASQfSD2kOU7WAA9XI4Enoc2SIP1wIDAQAB"

    }

}

登录（获取mq信息，获取信息为测试服务器信息，待测试通过后各厂商向平台申请，申请成功后将提供正式信息）

返回结果示例:

{

    code:0,  

message:”认证成功”,

data:{

mqInfo:{

     host:”xxx.xxx.xxx.xxx”,  //服务地址，以正式公布或接口返回为准

port:5672，   //端口

routingKey:”厂商编码.exchange*后一个字段.pubinfo”, //routingKey

exchange: {//告警exchange，各厂家根据告警类型，分别将告警信息推送到对应的队列中

    remoteMonitoring:“pubinfo.alarm.type.1”, //远程监控告警exchange

    wisdomWater:”pubinfo.alarm.type.2”,      //智慧用水告警exchange

    wisdomElectricity:”pubinfo.alarm.type.3”,//智慧用电告警exchange

    wisdomWarning:”pubinfo.alarm.type.4”,    //智能预警告警exchange

    chargingPile:”pubinfo.alarm.type.5”,     //智能充电桩告警exchange

    other:“pubinfo.alarm.type.99”,             //其他告警exchange

    test:“pubinfo.alarm.type.test”             //测试告警exchange

   },

username:”测试账号”,

password:”测试密码”

}

}

}

2，各厂家按照智慧消防平台提供的对接规范开发，测试相应程序

3，联调测试

4，正式发布

5，Mq信息如下（测试环境）

4. 对接接口详细内容

4.1智慧消防智能管控平台向各平台采集数据

【公共】Params参数描述：创建时间和更新时间的区间、列表的主键id

用于全量同步和增量同步数据及获取主键查询结果

创建时间和更新时间、主键id三个参数至少传一个，时间参数区间不得超过7天

4.1.1单位（或者站点、或者建筑）信息

本接口涉及COMPANY_ID与4.1.2运营服务单位的COMPANY_ID直接关联

4.1.1.1请求参数

创建时间、更新时间、主键id三个参数至少传一个参数（请求参数格式为：

application/x-www-form-urlencoded）

4.1.1.2返回数据

成功示例：

{

       code:0,

       message:’获取成功’，

       data: {

pageNo: 1,    //当前页码

pageSize: 50, //每页条数

pageCount: 2, //总页数

              count:80,    //总条数

        list: [                 //数据列表

            {

              buildingId:’38daiofndejd2k3kdjj’,

                            buildingName:’A站点’,

                            companyId:’760’,

                            address:‘杭州市余杭区xx街道xx号’，

                            buildingType:’700’,

                            lng:’120.392932’,

                            lat:’30.273892’,

              regionCode:'330100'

                                     deviceNum:20，

                            producerCode:’780’

            }

                     …

        ]

    }

}

失败示例：

{

code:1,

message:'获取数据异常',

data:null

}

其它失败结果可根据实际情况自行定义（code类型为Integer）

4.1.2运营服务公司

4.1.2.1请求参数

创建时间、更新时间、主键id三个参数至少传一个参数（请求参数格式为：

application/x-www-form-urlencoded）

4.1.2.2返回数据

成功示例：

{

       code:0,

       message:’获取成功’，

       data: {

pageNo: 1,    //当前页码

pageSize: 50, //每页条数

pageCount: 2, //总页数

              count:80, //总条数

        list: [              //数据列表

            {

                 companyId:’760,

                                               companyName:’xx科技公司’,

                                   companyCode:’760’,

                                   address:‘杭州市余杭区xx街道xx号’，

                                               contactName:’张三’,

                                   contactTel:’135xxxx3920’

            }

       …

        ]

    }

}

失败示例：

{

code:1,

message:'获取数据异常',

data:null

}

其它失败结果可根据实际情况自行定义（code类型为Integer）

4.1.3设备信息

本接口涉及BUILDING_ID与4.1.1单位的BUILDING_ID直接关联、COMPANY_ID与4.1.2运营服务单位的COMPANY_ID直接关联

4.1.3.1请求参数

创建时间、更新时间、主键id三个参数至少传一个参数（请求参数格式为：

application/x-www-form-urlencoded）

4.1.3.2返回数据

成功示例：

{

       code:0,

       message:’获取成功’，

       data: {

pageNo: 1,    //当前页码

pageSize: 50, //每页条数

pageCount: 2, //总页数

        count:80,  //总条数

       list: [      //数据列表

           {

              deviceId:’1’,

deviceName:’xx监控设备’,

deviceType:’700’,

address:’杭州市西湖区’,

lat:’30.293323’,

lng:’120.382832’,

companyId:’8389’

buildingId:’ 892983’,

producerCode:’670’,

installDate:’2018-08-01‘,

deviceStatus:’1’,

deviceManufactory:’222’，

              partsNum:20

           }

        …

       ]

    }

}失败示例：

{

code:1,

message:'获取数据异常',

data:null

}

其它失败结果可根据实际情况自行定义（code类型为Integer）

4.1.4设备部件信息

设备部件概念的请参考1.4术语和定义章节

本接口涉及DEVICE_ID和4.1.3设备信息的DEVICE_ID直接关联

4.1.4.1请求参数

创建时间、更新时间、主键id三个参数至少传一个参数（请求参数格式为：

application/x-www-form-urlencoded）

4.1.4.2返回数据

成功示例：

{

       code:0,

       message:’获取成功’，

       data:{

       pageNo: 1,    //当前页码

pageSize: 50, //每页条数

pageCount: 2, //总页数

       count:80, //总条数

      list: [{

partsId:’1’,

partsName:’xx探测器’,

address:’杭州市西湖区’,

deviceId:’8389’

partsManufactory:’海湾’,

installDate:’2018-08-01‘,

partsStatus:’10’,

partsType:'3001'

      }

    ...

   ]

}

}失败示例：

{

code:1,

message:'获取数据异常',

data:null

}

其它失败结果可根据实际情况自行定义（code类型为Integer）

4.2 各平台向智能管控平台上报或推送信息

4.2.1报警信息（实时）

发生警告时，通过mq推送到消防智能管控平台

本接口涉及BUILDING_ID与4.1.1单位的BUILDING_ID直接关联、DEVICE_ID与4.1.3设备信息的DEVICE_ID直接关联、PARTS_ID与4.1.4设备部件信息的PARTS_ID直接关联

推送格式：

{

"alarmEventId":"1548227253000",

"deviceId":"399L00762",

"buildingId":"579HZ007",

"happenTime":"2019-01-23 15:07:32",

"alarmContent":

{"电压过压":"400V","电流过载":""},

"alarmType":"401",

"partsId":"1",

"producerCode":"640"

}

5. 字典表

5.1社会单位类型【字典】

5.2区域维表【字典】

区域为表【字典表】定期根据行政区域变化进行调整，详细字典表请参见

附件1：区域为表字典表。

5.3平台开发公司【字典】

向智慧消防智能管控平台申请

5.4告警类型【字典】

5.5设备类型【字典】

5.6部件类型【字典】

 浙江省火灾智能防控系统标准