DB14∕T 2258-2021 地震信息系统接口规范.docxVIP

ICS90.120.25CCSA44

DB14

山西省地方标准

DB14/T2258—2021

地震信息系统接口规范

2021-01-12发布

2021-03-12实施

山西省市场监督管理局发布

I

DB14/T2258—2021

目次

前言 II

1范围 1

2规范性引用文件 1

3术语和定义 1

4缩略语 1

5基本要求 1

6接口格式 2

7访问程序 2

附录A（资料性）地震信息系统接口示例 4

附录B（资料性）JSON格式示例 5

附录C（资料性）响应代码及响应消息 6

参考文献 7

II

DB14/T2258—2021

前言

本文件按照GB/T1.1－2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定起草。

本文件由山西省地震局提出并监督实施。

本文件由山西省地震标准化技术专家组归口。

本文件起草单位：山西省地震局监测信息中心。

本文件主要起草人：黄金刚、张娜、王卓君、罗勇、高伟亮、梁永烨、殷伟伟、李晓锐、谷利国、陈存田、张甲瑞、高翔、刘俊芳、吕睿、王宁、闫晓美。

DB14/T2258—2021

1

地震信息系统接口规范

1范围

本文件规定了地震信息系统接口的术语和定义、缩略语、基本要求、接口格式和访问程序。

本文件适用于地震信息系统接口的设计和使用。

2规范性引用文件

下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。

GB/T22568—2008公共地震信息发布

3术语和定义

下列术语和定义适用于本文件。

3.1

地震信息系统Seismicinformationsystem

向政府、社会和生产部门提供地震事件信息的软件系统。

3.2

接口Interface

一组定义、程序及协议的集合，通过接口实现计算机软件之间的相互通信。

4缩略语

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

HTTP：超文本传输协议（Hypertexttransferprotocol）

IP：互联网协议（InternetProtocol）

URL：统一资源定位符（UniformResourceLocator）

JSON：数据交换格式（JavaScriptObjectNotation）

UTF-8：针对Unicode的可变长度字符编码（8-bitUnicodeTransformationFormat）

5基本要求

5.1通用要求

DB14/T2258—2021

2

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-MM-DD

HH:mm:ss

中华人民共和国北京时间，YYYY表示年（4位），

MM表示月（2位），DD表示日（2位），HH表示

小时（2位，24小时制），mm表示分钟（2位），

ss表示秒钟（2位）。年月日使用短横线（-）为分

隔符分隔，时分秒使用冒号（:）为分隔符分隔，年

月日与时分秒间间隔一个空格。

位置参数

经度XXX.XX度

地理经纬度，XXX.XX表示整数3位，小数2位；

XX.XX表示：整数2位，小数2位。

纬度XX.XX度

震级参数

X.X级

使用GB17740-1999中规定的地震震级M，X.X表

示：整数1位，小数1位。

5.3效能要求

地震信息系统接口应提供多用户并行访问支持，响应时间应小于500ms。

6接口格式

6.1接口访问地址：接口访问地址应采用统一资源定位符（URL）。

6.2接口协议：HT