地震应急信息服务接口规范

DB43/T1695—2019PAGE2地震应急信息服务接口规范范围本标准规定了XX省地震应急信息服务系统接口的术语和定义、访问步骤和接口定义。本标准适用于终端与地震应急信息服务系统间的接入和使用。规范性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。GB/T18207.1—2008防震减灾术语第1部分：基本术语GB/T18207.2—2015防震减灾术语第2部分：专业术语GB/T24888—2010地震现场应急指挥数据共享技术要求DB14/T2258—2021地震信息系统接口规范GB/T32402—2015通信名词术语数据通信因特网术语和定义下列术语和定义适用于本文件。地震应急earthquakeemergencyresponse破坏性地震发生前所做的各种应急准备和地震发生后采取的紧急抢险救灾行动。[GB/T18207.1—2008，定义6.1]地震应急信息服务系统earthquakeemergencyinformationservicesystem向政府、学校、医院等人口密集或行政部门提供地震灾害应急信息的软件系统。接口interface一组定义、程序及协议的集合，通过接口实现计算机软件之间的相互通信。加密encryption由于安全的考虑将数据进行编码，即将标准数据编码转换成专用的编码。加密数据通常要经过解码才能被用户使用。[GB/T32402—2015，定义3.1.102]认证authentication识别个人或处理的合法性的过程。[GB/T32402—2015，定义3.1.37]时间戳timestamp时间戳是指格林威治时间1970年01月01日00时00分00秒（XX时间1970年01月01日08时00分00秒）起至现在的总秒数。访问步骤对接终端需运行在地震行业网，接口采用协议以POST方式实现，访问地址采用统一资源定位符（URL）。调用地震应急信息服务系统的参数以及返回的服务响应结果编码均采用UTF-8字符集。注册登录用户应注册获取用户名和密码，并在登录地震应急信息服务系统时获取认证码。认证码是用户身份的唯一标识，每个认证码均赋予有效期，在有效期内可重复使用。生成请求地址在地震应急信息服务系统资源地址中加入认证参数、时间参数、地震事件参数等生成服务资源请求地址。认证参数在请求头中进行设置，其他参数在服务资源地址或请求体中进行设置。获取服务响应采用协议中的POST方法调用地震应急信息服务系统资源地址，获取服务响应。服务响应以JSON数据交换格式返回，数据格式见表1。表SEQ表\*ARABIC1返回格式要求参数格式长度描述code字符型20参见附录Cmsg字符型200响应代码的详细说明，参见附录Cvalue泛型不限返回内容包括字符型、数组等形式，根据服务接口返回内容确定接口定义用户登录用户登录请求参数采用JSON字符串封装和加密公钥（参见附录A）加密，终端可通过协议中的POST方法调用本接口。用户登录请求参数要求见表2，调用示例及响应结果参见附录B.1所示。表SEQ表\*ARABIC2用户登录请求参数要求参数格式长度描述username字符型50用户名password字符型100用户密码timestamp长整型16毫秒级时间戳获取地震评估事件用户应在获取地震评估事件数据资源地址中加入districtCode、startTime、endTime参数，形式为“?districtCode=<xx>&startTime=<startTime>&endTime=<endTime>”，并在消息头中设置用户登录成功后获得的认证信息，形式为“Authorization=<认证信息>”。获取地震评估事件数据请求参数要求见表3，调用示例及响应结果参见附录B.2所示。表SEQ表\*ARABIC3获取地震评估事件数据请求参数要求参数格式长度描述districtCode字符型10行政区编码startTime长整型16毫秒级时间戳endTime长整型16毫秒级时间戳获取地震影响场用户应在获取地震影响场数据资源地址中加入eventId参数，形式为“?eventId=<xx>”，并在消息头中设置用户登录成功后获得的认证信息，形式为“Authorization=<认证信息>”。获取地震影响场数据请求参数要求见表4，调用示例及响应结果参见附录B.3所示。表SEQ表\*ARABIC4获取地震影响场数据请求参数要求参数格式长度描述eventId字符型50地震评估事件ID获取灾害损失预评估结果用户应在获取灾害损失（如：人员伤亡）预评估结果资源地址中加入eventId参数，形式为“?eventId=<xx>”，并在消息头中设置用户登录成功后获得的认证信息，形式为“Authorization=<认证信息>”。请求参数要求见表5，调用示例及响应结果参见附录B.4所示。表SEQ表\*ARABIC5获取评估结果请求参数要求参数格式长度描述eventId字符型50地震评估事件ID附录A地震应急信息服务系统加密公钥（规范性）0438b2a736dd2c29eda14588437e618ab8a442a8a6e3346a35d87b8e9ea8506651619908c0e19def2bf19f38b0a65c4cb5a2c139ea6b64ae7feb26ad212e2e3293

附录B地震应急信息服务接口示例（资料性）表B.1地震应急信息服务接口示例接口地址:/domain:port/dzyj-service/login请求方式POST参数说明{ "username":"字符串"， "password":"字符串"， "timestamp":毫秒级时间戳}返回结果{"code":"10000"，"msg":"成功"，"value":}表B.2获取地震评估事件示例接口地址:/domain:port/dzyj-service/eqevent/query?districtCode=430102&startTime=毫秒级时间戳&endTime=毫秒级时间戳请求方式POST参数说明districtCode:"430102"startTime:毫秒级时间戳endTime:毫秒级时间戳Authorization：用户身份的唯一标识返回结果{ "code":"10000"， "msg":"成功"， "value":[ { "id":"地震评估事件编码"， "name":"XX省XX区XX级地震"， "date":毫秒级时间戳， "lon":经度， "lat":纬度， "ms":震级， "depth":震源深度 } ]}表B.3地震影响场接口示例接口地址:/domain:port/dzyj-service/ld/query?eventId=xxx请求方式POST参数说明eventId:"地震评估事件编码"Authorization：用户身份的唯一标识返回结果{ "code":"10000"， "msg":"成功"， "value":[ { "eventId":"地震评估事件编码"， "inty":烈度值， "geom":二进制数据 }， ]}表B.4地震灾害损失预评估接口示例接口地址:/domain:port/dzyj-service/death/query?eventId=xxx请求方式POST参数说明eventId:"地震评估事件编码"Authorization：用户身份的唯一标识返回结果{ "code":"10000"， "msg":"成功"， "value":[ { "eventId":"地震评估事件编码"， "districtCode":"430102"， "dist