《地震预警信息发布 第2部分：信息接口》DBT113.2-2026

1DB/T113.2—2026地震预警信息发布第2部分:信息接口本文件规定了地震预警信息发布中信息接口的基本要求、接口调用和数据包结构ꎮ本文件适用于地震预警信息发布中发布系统与客户端之间的信息交换ꎮ2规范性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款ꎮ其中ꎬ注日期的引用文件ꎬ仅该日期对应的版本适用于本文件ꎻ不注日期的引用文件ꎬ其最新版本(包括所有的修改单)适用于本文件ꎮGB/T18207(所有部分)防震减灾术语GB/T35276信息安全技术SM2密码算法使用规范DB/T113.1—2026地震预警信息发布第1部分:地震预警级别与标识GM/T0092基于SM2算法的证书申请语法规范3术语和定义GB/T18207(所有部分)界定的以及下列术语和定义适用于本文件ꎮ3.1发布系统systemforearthquakeearlywarninginformationrelease对外提供地震预警、地震速报等信息的技术平台ꎮ3.2客户端clientofearthquakeearlywarninginformation接收发布系统的地震预警、地震速报等信息的系统ꎮ4缩略语下列缩略语适用于本文件ꎮHTTPS:超文本传输安全协议(HypertextTransferProtocolSecure)IP:网际互联协议(InternetProtocol)JSON:JavaScript对象表示法(JavaScriptObjectNotation)MAC:媒体访问控制(MediaAccessControl)MQTT:消息队列遥测传输(MessageQueuingTelemetryTransport)QoS:服务质量(QualityofService)TLS:传输层安全性协议(TransportLayerSecurity)UTF-8:8位统一码转换格式(8-bitUnicodeTransformationFormat)2DB/T113.2—20265基本要求发布系统向客户端提供的信息接口分为管理类接口和数据类接口两类ꎮ表1给出了两类接口中的接口名称和功能ꎮ表1接口名称和功能序号接口类别接口名称功能1管理类接口注册接口客户端注册2状态变更接口客户端启用和停止状态切换3查询接口客户端信息查询4注销接口客户端注销5数据类接口预警信息发布接口地震预警信息等发布6辅助信息发布接口地震预警演练信息等发布7信息反馈接口客户端信息反馈5.2数据格式信息接口的数据包应采用JSON格式封装ꎮ5.3字符格式信息接口数据包中的字符编码应采用UTF-8编码ꎮ5.4时间格式信息接口数据包中的时间应为北京时区时间ꎬ采用YYYY-MM-DDTHH:mm:SS[SSS]格式表示时间ꎮ注:YYYY表示四位年份ꎬMM表示两位月份ꎬDD表示两位日期ꎬT表示日期与时间的分隔符ꎬHH表示24小时制的两位小时ꎬmm表示两位分钟ꎬSS表示两位秒数ꎬ[SSS]表示可选的三位毫秒数ꎮ5.5数字证书申请和使用数字证书应遵循以下规定:a)客户端使用客户端标识按照GM/T0092规定申请数字证书ꎻb)发布系统和客户端按照GB/T35276对提供的消息进行数字签名ꎬ对收到的消息进行验签ꎮ6信息交互流程客户端获取发布系统提供的地震预警信息等ꎬ涉及注册、数字证书申请、状态变更、查询、信息订阅、信息处理、反馈和注销8个流程ꎬ其中客户端在注册、状态变更、查询、信息订阅、反馈和注销流程与发布系统的信息接口进行交互ꎮ图1给出了客户端与发布系统间的信息交互流程ꎬ包括下列DB/T113.2—20263步骤:a)客户端首先在发布系统上进行注册,注册成功后,进行数字证书申请;b)客户端获取数字证书后,可进行状态变更、查询和注销;c)客户端通过状态变更,向发布系统通知其进行状态切换;d)客户端通过查询,获取其状态和业务类接口的信息等;e)客户端通过信息订阅,获取地震预警信息等,信息处理后,向发布系统反馈;f)客户端注销后,发布系统清除客户端账户信息。注:证书签发平台负责数字证书签发、更新和管理等。图1信息交互流程7管理类接口管理类接口调用遵循以下要求:a)应使用HTTPS1.1协议,遵循TLS1.2及以上版本要求;b)应采用请求/响应模式,使用POST方法提交请求数据包,接收应答数据包。表2给出了管理类接口的接口名称和访问路径。DB/T113.2—20264表2管理类接口调用序号接口名称访问路径1注册接口/register2状态变更接口/statusChange3查询接口/query4注销接口/deregister7.2数据包结构表3给出了管理类接口的接口名称、请求数据包结构和应答数据包结构ꎬ附录A规定了管理类接口的请求、应答数据包结构ꎮ表3管理类接口数据包结构表序号接口名称请求数据包结构应答数据包结构1注册接口附录A表A.1附录A表A.22状态变更接口附录A表A.3附录A表A.43查询接口附录A表A.5附录A表A.64注销接口附录A表A.7附录A表A.88数据类接口数据类接口调用遵循以下要求:a)应使用MQTT协议ꎬ遵循MQTT3.1及以上版本要求ꎻb)宜通过管理类接口的查询接口ꎬ获取数据类接口的MQTT访问地址、端口、主题名称等ꎻc)应采用订阅/发布模式ꎬ通过订阅预警信息发布主题、辅助信息发布主题ꎬ接收发布系统提供的信息ꎬ通过在信息反馈主题上发布消息ꎬ向发布系统提供反馈信息ꎻd)订阅预警信息发布主题、辅助信息发布主题期间ꎬ客户端应与发布系统保持长连接通信ꎬ通信链路中断恢复后应自动重连ꎮ8.2数据包结构表4给出了预警信息发布主题、辅助信息发布主题和信息反馈主题提供的消息名称、消息代码和消息数据包结构ꎬ附录A规定了各类信息的消息数据包结构ꎬ附录B给出了部分类型消息数据包结构示例ꎮDB/T113.2—20265表4消息数据包结构表序号主题名称消息名称消息代码消息数据包结构1预警信息发布主题地震预警信息附录A表A.92地震预警取消信息3自动速报信息4正式速报信息04025辅助信息发布主题地震预警演练信息附录A表A.96地震预警测试信息附录A表A.97自动速报测试信息03028正式速报测试信息9服务上报指令信息基本信息上报指令信息9002信息反馈主题服务反馈信息客户端基本信息9102DB/T113.2—20266附录A(规范性)数据包结构A.1客户端注册请求数据包表A.1规定了客户端注册请求数据包结构ꎮ表A.1客户端注册请求数据包结构序号键标识名称类型必备或可选内容说明1license入网许可证书字符串必备注册前取得2owner所有者字符串必备客户端管理单位名称3clientType客户端类型字符串必备取值为:01—地震预警专用终端ꎬ02—转发平台ꎬ03—其他适配系统4deviceID设备标识字符串必备客户端的MAC地址5email电子邮件地址字符串必备联系人电子邮件地址A.2客户端注册应答数据包表A.2规定了客户端注册应答数据包结构ꎮ表A.2客户端注册应答数据包结构序号键标识名称类型必备或可选内容说明1code代码数值必备响应代码ꎬ取值为:0—成功ꎬ其他为失败2message提示信息字符串必备提示信息ꎬ失败时提示失败原因3clientID客户端标识字符串必备注册成功后生成ꎬ注册失败时返回空值4userName用户名字符串必备用户名5password密码字符串必备密码A.3客户端状态变更请求数据包表A.3规定了客户端状态变更请求数据包结构ꎮ表A.3客户端状态变更请求数据包结构序号键标识名称类型必备或可选内容说明1clientID客户端标识字符串必备客户端标识2userName用户名字符串必备用户名3password密码字符串必备密码4status状态标识字符串必备客户端状态ꎬ取值为:0—停止ꎬ1—启用DB/T113.2—20267A.4客户端状态变更应答数据包表A.4规定了客户端状态变更应答数据包结构ꎮ表A.4客户端状态变更应答数据包结构序号键标识名称类型必备或可选内容说明1code代码数值必备响应代码ꎬ取值为:0—成功ꎬ其他为失败2message提示信息字符串必备提示信息3status账户状态字符串必备客户端当前状态ꎬ取值为:0—停止ꎬ1—启用A.5客户端查询请求数据包表A.5规定了客户端查询请求数据包结构ꎮ表A.5客户端查询请求数据包结构序号键标识名称类型必备或可选内容说明1clientID客户端标识字符串必备客户端标识2userName用户名字符串必备用户名3password密码字符串必备密码A.6客户端查询应答数据包表A.6规定了客户端查询应答数据包结构ꎮ表A.6客户端查询应答数据包结构序号键标识名称类型必备或可选内容说明1code代码数值必备响应代码ꎬ取值为:0—成功ꎬ其他为失败2message提示信息字符串必备提示信息ꎬ失败时提示失败原因3verifyCert验签公钥字符串必备发布系统的签名公钥4status账户状态字符串必备客户端状态ꎬ取值为:1—启用ꎬ0—停止5createDate注册时间字符串必备客户端注册的时间6expDate失效时间字符串必备客户端失效的时间7eewMQTThost预警信息发布访问地址字符串必备IP地址或域名地址8port端口数值必备整数9topic主题字符串必备预警信息发布主题名称ext拓展参数对象可选预警信息发布接口的拓展属性ꎬ如QoSDB/T113.2—20268表A.6客户端查询请求应答数据包结构(续)序号键标识名称类型必备或可选内容说明auxMQTThost辅助信息发布访问地址字符串必备IP地址或域名地址port端口字符串必备整数topic主题字符串必备辅助信息发布主题名称ext拓展参数对象可选辅助信息发布接口的拓展属性ꎬ如QoSfbkMQTThost信息反馈访问地址字符串必备IP地址或域名地址port端口字符串必备整数topic主题字符串必备信息反馈主题名称ext拓展参数对象可选信息反馈接口的拓展属性ꎬ如QoSext拓展信息对象可选客户端的拓展属性信息ꎬ如安装位置A.7客户端注销请求数据包表A.7规定了客户端注销请求数据包结构ꎮ表A.7客户端注销请求数据包结构序号键标识名称类型必备或可选内容说明1clientID客户端标识字符串必备客户端标识2userName用户名字符串必备用户名3password密码字符串必备密码A.8客户端注销应答数据包表A.8规定了客户端注销应答数据包结构ꎮ表A.8客户端注销应答数据包结构序号键标识名称类型必备或可选内容说明1code代码数值必备响应代码ꎬ取值为:0—成功ꎬ其他为失败2message提示信息字符串必备提示信息ꎬ失败时提示失败原因A.9地震预警信息、地震预警演练信息、地震预警测试信息数据包表A.9规定了地震预警信息、地震预警演练信息、地震预警测试信息数据包结构ꎮ表A.9地震预警信息、地震预警演练信息、地震预警测试信息数据包结构序号键标识名称类型必备或可选内容说明11消息标识字符串必备消息唯一标识22消息代码字符串必备取值为:0101、0201或030133发送时间字符串必备消息的发送时间DB/T113.2—20269表A.9地震预警信息、地震预警演练信息、地震预警测试信息数据包结构(续)序号键标识名称类型必备或可选内容说明44消息来源字符串必备发布系统所属单位名称55校验码字符串必备消息的签名信息66版本号字符串必备消息数据包协议版本号77事件标识字符串必备预警地震事件唯一标识88报次数值必备99产出机构字符串必备信息的产出机构名称应答客户端标识字符串可选消息代码为0201时必备ꎬ取值为:ALL—指所有客户端ꎬ其他为应答客户端标识组成的字符串ꎬ多个客户端标识时客户端端标识间用“ꎬ”拼接震中预警等级字符串必备遵循DB/T113.1—2026中4规定的地震预警等级划分ꎬ取值为:Red—地震红色预警ꎬOrange—地震橙色预警ꎬYellow—地震黄色预警ꎬBlue—地震蓝色预警发震时刻字符串必备地震波传播的起始时间震中参考地名字符串必备震中位置的地名震中经度数值必备东经为正、西经为负ꎬ单位为度(°)震中纬度数值必备北纬为正、南纬为负ꎬ单位为度(°)震源深度数值必备整数ꎬ单位为千米(km)震级数值必备预警估算的地震震级震中烈度数值必备预警估算的地震震中烈度目标对象烈度对象可选预警目标对象的烈度A.10地震预警取消信息数据包表A.10规定了地震预警取消信息数据包结构ꎮ表A.10地震预警取消信息数据包结构序号键标识名称类型必备或可选内容说明11消息标识字符串必备消息唯一标识22消息代码字符串必备33发送时间字符串必备消息的发送时间44消息来源字符串必备发布系统所属单位名称55校验码字符串必备消息的签名信息66版本号字符串必备消息数据包协议版本号77事件标识字符串必备待取消的预警事件标识88产出机构字符串必备信息的产出机构名称DB/T113.2—2026A.11自动速报信息、正式速报信息、自动速报测试信息、正式速报测试信息数据包表A.11规定了自动速报信息、正式速报信息、自动速报测试信息、正式速报测试信息数据包结构ꎮ表A.11自动速报信息、正式速报信息、自动速报测试信息、正式速报测试信息数据包结构序号键标识名称类型必备或可选内容说明11消息标识字符串必备消息唯一标识22消息代码字符串必备取值为:0401、0402、0302或030333发送时间字符串必备消息的发送时间44消息来源字符串必备发布系统所属单位名称55校验码字符串必备消息的签名信息66版本号字符串必备消息数据包协议版本号77事件标识字符串必备地震事件标识ꎬ同一个地震事件标识唯一88序号数值可选默认为空99产出机构字符串必备信息的产出机构名称客户端标识字符串可选默认为空目录标识字符串必备地震速报目录标识发震时刻字符串必备地震波传播的起始时间震中参考地名字符串必备震中参考地名震中经度数值必备东经为正、西经为负ꎬ单位为度(°)震中纬度数值必备北纬为正、南纬为负ꎬ单位为度(°)震源深度数值必备整数ꎬ单位为千米(km)震级数值必备地震发布震级A.12服务上报指令信息数据包表A.12规定了服务上报指令信息数据包结构ꎮ表A.12服务上报指令信息数据包结构序号键标识名称类型必备或可选内容说明11消息标识字符串必备消息唯一标识22消息代码字符串必备取值为:900133发送时间字符串必备发布消息的时间44消息来源字符串必备发布系统所属单位名称55校验码字符串必备消息的签名信息66版本号字符串必备消息数据包协议版本号77应答客户端标识字符串必备由1个或多个客户端标识组成的字符串ꎬ多个客户端标识时客户端端标识间用“ꎬ”拼接ꎻ当为“ALL”时指所有客户端DB/T113.2—2026表A.12服务上报指令信息数据包结构(续)序号键标识名称类型必备或可选内容说明88参考事件标识字符串必备应反馈的事件标识99参考消息标识字符串可选应反馈的消息标识参考消息代码字符串必备应反馈的消息代码拓展字段对象可选拓展属性信息ꎬ如上报截止时间A.13基本信息上报指令信息数据包表A.13规定了基本信息上报指令信息数据包结构ꎮ表A.13基本信息上报指令信息数据包结构序号键标识名称类型必备或可选内容说明11消息标识字符串必备消息唯一标识22消息代码字符串必备取值为:900233发送时间字符串必备发布消息的时间44消息来源字符串必备发布系统所属单位名称55校验码字符串必备消息的签名信息66版本号字符串必备消息数据包协议版本号77应答客户端标识字符串必备由1个或多个客户端标识组成的字符串ꎬ多个客户端标识时客户端端标识间用“ꎬ”拼接ꎻ当为“ALL”时指所有客户端8拓展字段对象可选拓展属性信息ꎬ如上报截止时间A.14服务反馈信息数据包表A.14规定了服务反馈信息数据包结构ꎮ表A.14服务反馈信息数据包结构序号键标识名称类型必备或可选内容说明11消息标识字符串必备消息唯一标识22消息代码字符串必备取值为:910133发送时间字符串必备发布消息的时间44消息来源字符串必备客户端标识55校验码字符串必备消息的签名信息66版本号字符串必备消息数据包协议版本号7