ICS 90.120.25 CCS A 44 山 DB14 西 省 地 方 标 准 DB 14/ T 2258—2021 地震信息系统接口规范 2021 - 01 - 12 发布 山西省市场监督管理局 2021 - 03 - 12 实施 发 布 DB14/T 2258—2021 目  次 前言..................................................................................................................................................................... II 1 范围................................................................................................................................................................. 1 2 规范性引用文件............................................................................................................................................. 1 3 术语和定义..................................................................................................................................................... 1 4 缩略语............................................................................................................................................................. 1 5 基本要求......................................................................................................................................................... 1 6 接口格式......................................................................................................................................................... 2 7 访问程序......................................................................................................................................................... 2 附录 A （资料性） 地震信息系统接口示例............................................................................................... 4 附录 B （资料性） JSON 格式示例...............................................................................................................5 附录 C （资料性） 响应代码及响应消息................................................................................................... 6 参考文献............................................................................................................................................................... 7 I DB14/T 2258—2021 前  言 本文件按照GB/T 1.1－2020《标准化工作导则 第 1 部分：标准化文件的结构和起草规则》的规定 起草。 本文件由山西省地震局提出并监督实施。 本文件由山西省地震标准化技术专家组归口。 本文件起草单位：山西省地震局监测信息中心。 本文件主要起草人：黄金刚、张娜、王卓君、罗勇、高伟亮、梁永烨、殷伟伟、李晓锐、谷利国、 陈存田、张甲瑞、高翔、刘俊芳、吕睿、王宁、闫晓美。 II DB14/T 2258—2021 地震信息系统接口规范 1 范围 本文件规定了地震信息系统接口的术语和定义、缩略语、基本要求、接口格式和访问程序。 本文件适用于地震信息系统接口的设计和使用。 2 规范性引用文件 下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件， 仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本 文件。 GB/T 22568—2008 公共地震信息发布 3 术语和定义 下列术语和定义适用于本文件。 3.1 地震信息系统 Seismic information system 向政府、社会和生产部门提供地震事件信息的软件系统。 3.2 接口 Interface 一组定义、程序及协议的集合，通过接口实现计算机软件之间的相互通信。 4 缩略语 下列缩略语适用于本文件。 HTTP： 超文本传输协议（Hypertext transfer protocol） IP ：互联网协议（Internet Protocol） URL：统一资源定位符（Uniform Resource Locator ） JSON： 数据交换格式（Java Script Object Notation） UTF-8：针对Unicode的可变长度字符编码（8-bit Unicode Transformation Format） 5 5.1 基本要求 通用要求 1 DB14/T 2258—2021 5.1.1 用户应申请注册用户名和密码，支持验证。 5.1.2 接口通过加密算法对用户进行授权；接口请求参数按照顺序拼接成字符串，加上时间戳（格式 为 YYYYMMDDHHMM）形成新的字符串，对新字符串中的 MD5 消息摘要算法的 32 位加密，形成 Key 值。其 中，YYYY 表示年（4 位），MM 表示月（2 位），DD 表示日（2 位），HH 表示时（2 位），MM 表示分（2 位）。 5.1.3 系统应提供接口说明。接口说明包括地震信息系统接口描述、调用请求方式、参数说明、常用 参数代码等内容，并给出接口调用示例代码。 5.2 服务请求参数要求 地震信息系统接口服务请求参数要求见表1。 表1 参数 服务请求参数要求 格式 备注 中华人民共和国北京时间，YYYY 表示年（4 位）， MM 表示月（2 位），DD 表示日（2 位），HH 表示 时间参数 YYYY-MM-DD 小时（2 位，24 小时制），mm 表示分钟（2 位）， HH:mm:ss ss 表示秒钟（2 位）。年月日使用短横线（-）为分 隔符分隔，时分秒使用冒号（:）为分隔符分隔，年 月日与时分秒间间隔一个空格。 经度 XXX.XX 度 位置参数 地理经纬度，XXX.XX 表示整数 3 位，小数 2 位； XX.XX 表示：整数 2 位，小数 2 位。 纬度 XX.XX 度 震级参数 5.3 X.X 级 使用 GB 17740-1999 中规定的地震震级 M， X.X 表 示：整数 1 位，小数 1 位。 效能要求 地震信息系统接口应提供多用户并行访问支持，响应时间应小于500 ms。 6 接口格式 6.1 6.2 6.3 6.4 6.5 7 接口访问地址：接口访问地址应采用统一资源定位符（URL）。 接口协议：HTTP 协议 POST 方式。 调用参数：包括时间参数、位置参数、震级参数等。 响应参数：包括响应代码、响应消息和数据体三部分。 地震信息系统接口示例参见附录 A。 访问程序 7.1 访问地址 地震信息系统接口访问地址应采用统一资源定位符（URL）。URL中的服务器地址宜采用域名，不宜 采用IP地址。 2 DB14/T 2258—2021 7.2 访问步骤 7.2.1 注册 用户应通过地震信息系统接口单位提供的地震服务数据系统平台（以下简称“平台”）申请注册用 户名和密码。或应由地震信息系统接口单位给用户在平台上创建用户名和密码。 7.2.2 登陆 用户通过用户名和密码登陆平台，申请地震信息系统接口访问账号APPID和地震信息系统接口访问 密钥Key（Key应具有有效期，有效期内用户可重复使用，超过有效期系统为用户重新生成Key值） 。 7.2.3 获取接口地址 用户通过用户名和密码登陆平台，获取地震信息系统接口资源访问地址。 7.2.4 生成请求地址 用户应在地震数据资源地址中加入APPID和Key，形式为“&appid=<APPID>&key=<Key>”,生成服务 资源请求地址。 7.2.5 获取服务响应 用户采用HTTP协议中的POST方法调用地震数据资源请求地址，获取服务响应。 7.3 服务响应 7.3.1 返回格式 返回格式要求见表2。 表2 7.3.2 返回格式要求 参数 格式 备注 返回结果 JSON 格式 JSON 格式示例见附录 B 响应代码 resCode 整数型 响应代码参见附录 C 响应消息 resMsg 字符型 数据体 data 数组型 返回内容应为响应代码的详细说明（响应消息参 见附录 C） 返回内容应为地震数据的具体描述 返回结果编码 返回结果编码采用UTF-8字符集。 A 3 DB14/T 2258—2021 附 录