《突发事件应对标准要素数据服务接口要求》

ICS35.240.99

CCSD07

CAPSA

团体标准

T/CAPSAXXXX—XXXX

突发事件应对标准要素数据服务接口要求

Requirementsfordataserviceinterfaceofemergencyresponse

standardselement

（征求意见稿）

XXXX-XX-XX发布XXXX-XX-XX实施

公共安全科学技术学会发布

T/CAPSAXXXX—XXXX

突发事件应对标准要素数据服务接口要求

1范围

本文件规定了突发事件应对领域标准数据服务接口的组成、名称、参数、返回码和返回数据结构。

本文件适用于事故灾难类突发事件应对领域标准数据服务接口的设计开发及标准数据的提供、使

用。

2规范性引用文件

下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，

仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本

文件。

GB/T32572-2016自然灾害承灾体分类与代码

GB/T35561-2017突发事件分类与编码

GB/T38565-2020应急物资分类及编码

3术语和定义

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

标准数据standarddata

利用信息等技术对标准纸质或pdf文本进行结构化和语义化处理，将标准纸质或pdf文本转换为计

算机可理解和可处理的形式，能够通过数字设备进行读取、传输和使用的数据。

服务接口serviceinterface

数据服务系统提供给应用系统访问数据的应用编程接口。

返回码returncode

服务接口调用后返回的，用以标识调用成功与否和错误原因等信息的状态码。

注：一般用一个数字表示。

[来源：GB/T42877—2023,3.5]

返回数据结构structureforreturneddata

接口调用后返回的内存对象的数据组织方式。

[来源：GB/T42877—2023,3.5]

4接口组成

接口由4部分组成：接口名称、接口参数、返回码和返回数据结构。其中，接口名称表达数据访

问的具体功能，接口参数表达数据访问的输入条件，返回码表达数据访问的调用状态，返回数据结构表

达返回数据的内存对象结构。

一个接口可以有一个或多个参数，每个参数应明确为必选或可选。

接口示例见附录A。

5接口名称

接口名称应由4部分组成：接口功能、数据类别、数据内容、主要条件。其中，接口功能、数据

类别、数据内容不应为空，主要条件可为空。

1

T/CAPSAXXXX—XXXX

接口名称宜采用小驼峰命名法，命名格式为：{接口功能}{数据类别}{数据内容}{主要条件}。各

组成部分的取值规则应符合表1的规则。

表1接口名称各组成部分的取值规则

组成部分代码含义备注

接口功能的范围为提供数

据，不包含回写数据。

接口功能get检索突发事件应对领域标准数据的方法

接口功能及其代码取值根

据需要扩展。

cma煤矿事故资料

manmma金属非金属矿山事故资料

hca危险化学品事故资料

facea烟花爆竹和民用爆炸物事故资料

数据类别ca建筑施工事故资料符合GB/T35561的要求

fa火灾事故资料

rta道路交通事故资料

wta水上交通事故资料

oaad其他事故灾难资料

标准中包含的标准结构要素

数据内容Ele要素知识和标准核心技术内容知

识

多个条件以“And”连接。

主要条件{By}{参数类别}主要参数类型参数类别连接规则应符合

表2的规定。

6接口参数

接口参数分类

接口参数分为7类，其中，5类用于定义标准核心技术内容，2类用于定义标准结构要素。接口参数

类别及其描述的输入条件应符合表2的规定。

表2接口参数类别及其描述的输入条件

标准数据分类接口参数类别类别代码接口参数描述的输入条件

事故信息类AccInf数据的事故信息。如：突发事件分类

应急阶段类EmePha数据的应急阶段。如：应急阶段名称

标准核心技术内

应急任务类EmeTas数据的应急任务。如：应急任务名称

容

应对主体类CopSub数据的应对主体。如：救援主体分类

应急资源类EmeRes数据的应急资源。如：应急物资分类

标准基本信息类StaBasInf数据的标准基本信息。如：文件类型

标准结构要素

标准辅助信息类StaAuxInf数据的标准辅助信息。如：提出信息

接口参数定义

2

T/CAPSAXXXX—XXXX

6.2.1接口参数定义应由名称、含义、赋值类型、赋值格式、赋值示例、使用说明等6部分组成，其

中，名称采用下划线法；赋值类型指整数、浮点数、字符串等编程语言的数据类型。

6.2.2数据访问常用接口参数定义应符合附录B的规定，可按需、按规则进行扩展。

7返回码

返回码分类

根据返回码表征的调用状态分为成功和失败两类。

返回码定义

返回码的定义由返回码取值和含义2部分组成。

成功类的返回码取值为0。失败类的返回码取值规则为｛类别代码｝｛顺序号｝。其中,类别代码和

名称应符合表3的规定，顺序号为2位数字，从01开始。

常用返回码定义应符合附录C的规定，也可参照常用返回码的定义进行扩展。

表3常用返回码定义清单

返回码分类类别代码类别名称

成功0调用成功

1用户验证失败

2接口参数错误

失败3数据库错误

4服务器错误

5其他错误

8返回数据结构

返回数据结构的具体描述应符合表4的规定。

表4返回数据的序列化格式信息

参数分类格式类型格式信息

{

retutnCode:”返回码”,

returnMessage:”返回码说明（包含错误信息）”,

requestTime:”接收请求时间”,

responseTime:”返回请求结果时间”,

事故信息类jsontakeTime:”耗时（毫秒）”,

Eme_Typ:”突发事件类型”,

Eme_Lev:”突发事件级别”,

Dis_Exp_Typ:”承灾体类型”,

Haz_Nam:”危险源名称”,

}

{

retutnCode:”返回码”,

returnMessage:返回码说明（包含错误信息）

应急阶段类json””,

requestTime:”接收请求时间”,

responseTime:”返回请求结果时间”,

takeTime:”耗时（毫秒）”,

3

T/CAPSAXXXX—XXXX

Eme_Man_Sta_Nam:”应急阶段名称”,

Eme_Res_Lev:”应急响应级别”

}

{

retutnCode:”返回码”,

returnMessage:”返回码说明（包含错误信息）”,

requestTime:”接收请求时间”,

responseTime:”返回请求结果时间”,

应急任务类jsontakeTime:”耗时（毫秒）”,

Eme_Tas_Nam:”应急任务名称”,

Eme_Tas_Con:”应急任务内容”,

Eme_Act:”应急行动”

Eme_Pla:”应急地点”

}

{

retutnCode:”返回码”,

returnMessage:”返回码说明（包含错误信息）”,

requestTime:”接收请求时间”,

responseTime:”返回请求结果时间”,

takeTime:耗时（毫秒）,

应对主体类json””

Res_Sub_Cla:”救援主体分类”,

Res_Sub_Lev:”救援主体级别”,

Res_Sub_Nam:”救援主体名称”,

Res_Sub_Rol:”救援主体角色”,

Res_Sub_Res:”救援主体责任”

}

{

retutnCode:”返回码”,

returnMessage:”返回码说明（包含错误信息）”,

requestTime:”接收请求时间”,

responseTime:”返回请求结果时间”,

takeTime:耗时（毫秒）,

应急资源类json””

Eme_Sup_Cla:”应急物资分类”,

Eme_Sup_Nam:”应急物资名称”,

Eme_Sup_Mod:”应急物资型号”,

Eme_Sup_Cod:”应急物资编码”,

Eme_Sup_Fun:”应急物资功能”

}

{

retutnCode:”返回码”,

returnMessage:”返回码说明（包含错误信息）”,

requestTime:”接收请求时间”,

responseTime:”返回请求结果时间”,

takeTime:”耗时（毫秒）”,

Sta_Typ:标准类别,

标准基本信息””

jsonSta_Nam_Chi:标准中文名称,

类””

Sta_Nam_Eng:”标准英文译名”,

ICS:”国际标准分类号”,

CCS:”中文标准文献分类号”,

Sta_Num:”标准号”,

Iss_Dat:”发布日期”,

Imp_Dat:”实施日期”

}

{

标准辅助信息retutnCode:返回码,

json””

类returnMessage:”返回码说明（包含错误信息）”,

requestTime:”接收请求时间”,

4

T/CAPSAXXXX—XXXX

responseTime:”返回请求结果时间”,

takeTime:”耗时（毫秒）”,

StaSpo:”提出单位”,

Cen_Uni:”归口单位”,

Dra_Uni:”起草单位”,

Chi_Dra:”主要起草人”,

Sta_Obj_Cov_Asp:”标准主题内容”,

App_Lim:”适用界限”,

Ter_Chi:”术语中文名称”,

Ter_Def:”术语定义”,

Ter_Eng:”术语英文名称”

}

5

T/CAPSAXXXX—XXXX

A

A

附录A

（资料性）

接口示例

A.1突发事件应对标准事故信息数据接口示例

表A.1给出了突发事件应对标准煤矿事故信息数据接口示例。

表A.1突发事件应对标准煤矿事故信息数据接口示例

接口名称getcmaEleByAccInf

必选/

名称含义赋值类型赋值格式赋值示例使用说明

可选

表示：煤矿事故

DataCode数据类别代码字符串-cma必选

资料

表示：煤矿煤尘

Eme_Typ突发事件类型字符串-20102可选

爆炸事故

Eme_Lev突发事件级别字符串-Ⅰ级表示：特别重大可选

表示：除了家庭

之外的财产,包括

接口参数

国有财产、劳动

群众集体所有财

Dis_Exp_Typ承灾体类型字符串-公共财产可选

产、用于公益事

业的社会捐助或

者专项基金的财

产等

表示：煤矿生产

多个以逗号（,）分过程中所产生的

Haz_Nam危险源名称字符串煤矿粉尘危险源可选

隔各种矿物细微颗

粒的总称

返回码取值见表3

返回数据结构返回数据结构见表4

A.2突发事件应对标准应急阶段数据接口示例

表A.2给出了突发事件应对标准煤矿事故应急阶段数据接口示例。

表A.2突发事件应对标准煤矿事故应急阶段数据接口示例

接口名称getcmaEleByEmePha

必选/

名称含义赋值类型赋值格式赋值示例使用说明

可选

表示：煤矿事故

DataCode数据类别代码字符串-cma必选

资料

接口参数

应急处置与救表示：应急处置

Eme_Man_Sta_Nam应急阶段名称字符串-可选

援与救援阶段

Eme_Res_Lev应急响应级别字符串-Ⅰ级响应表示：Ⅰ级响应可选

返回码取值见表3

返回数据结

返回数据结构见表4

构

A.3突发事件应对标准应急任务数据接口示例

6

T/CAPSAXXXX—XXXX

表A.3给出了突发事件应对标准煤矿事故应急任务数据接口示例。

表A.3突发事件应对标准煤矿事故应急任务数据接口示例

接口名称getcmaEleByEmeTas

必选/

名称含义赋值类型赋值格式赋值示例使用说明

可选

表示：煤矿事故

DataCode数据类别代码字符串-cma必选

资料

Eme_Tas_Nam应急任务名称字符串-应急指挥表示：应急指挥可选

多个以逗号（,）分指挥、协调各方表示：指挥、协

Eme_Tas_Con应急任务内容字符串可选

接口参数隔救援力量调各方救援力量

转移、撤离或者表示：转移、撤

Eme_Act应急行动字符串-疏散人员和重要离或者疏散人员可选

财产和重要财产

表示：应急地点

XX省XX市XX县

Eme_Pla应急地点字符串-在XX省XX市XX县可选

（区）

（区）

返回码取值见表3

返回数据结构返回数据结构见表4

A.4突发事件应对标准应对主体数据接口示例

表A.4给出了突发事件应对标准煤矿事故应对主体数据接口示例。

表A.4突发事件应对标准煤矿事故应对主体数据接口示例

接口名称getcmaEleByCopSub

必选/

名称含义赋值类型赋值格式赋值示例使用说明

可选

表示：煤矿事故

DataCode数据类别代码字符串-cma必选

资料

表示：在突发事

件处理中对客体

有认识和实践能

Res_Sub_Cla救援主体分类字符串-消防救援支队力的人或组织。可选

主要包括政府机

构、非政府组

接口参数

织、个体或群体

Res_Sub_Lev救援主体级别字符串-政府机构表示：政府机构可选

表示：XX消防救

Res_Sub_Nam救援主体名称字符串-XX消防救援支队可选

援支队

指挥、组织、协表示：指挥、组

Res_Sub_Rol救援主体角色字符串-可选

调处置织、协调处置

负责指挥、组表示：负责指

多个以逗号（,）分

Res_Sub_Res救援主体责任字符串织、协调处置工挥、组织、协调可选

隔

作处置工作

返回码取值见表3

返回数据结构返回数据结构见表4

A.5突发事件应对标准应急资源数据接口示例

表A.5给出了突发事件应对标准煤矿事故应急资源数据接口示例。

7

T/CAPSAXXXX—XXXX

表A.5突发事件应对标准煤矿事故应急资源数据接口示例

接口名称getcmaEleByEmeRes

必选/

名称含义赋值类型赋值格式赋值示例使用说明

可选

表示：煤矿事故

DataCode数据类别代码字符串-cma必选

资料

应急装备及配套表示：应急装备

Eme_Sup_Cla应急物资分类字符串-可选

物资及配套物资

表示：正压式呼

Eme_Sup_Nam应急物资名称字符串-正压式呼吸器可选

吸器

钢瓶型正压式呼表示：钢瓶型正

Eme_Sup_Mod应急物资型号字符串-可选

吸器压式呼吸器

表示：正压式呼

Eme_Sup_Cod应急物资编码字符串-2010101可选

吸器

表示：可以使消

接口参数防人员和抢险救

护人员在进行灭

火战斗或抢险救

援时防止吸入对

人体有害毒气，

烟雾，悬浮于空

多个以逗号（,）分个体防护、防止

Eme_Sup_Fun应急物资功能字符串气中的有害污染可选

隔吸入有害物质

物。也可在缺氧

环境中使用，防

止吸入有毒气

体，从而有效地

进行灭火、抢险

救灾救护和劳动

作业

返回码取值见表3

返回数据结构返回数据结构见表4

A.6突发事件应对标准基本信息数据接口示例

表A.4给出了突发事件应对标准危险化学品事故标准基本信息数据接口示例。

表A.6突发事件应对标准危险化学品事故标准基本信息数据接口示例

接口名称gethcaEleByStaBasInf

必选/

名称含义赋值类型赋值格式赋值示例使用说明

可选

表示：危险化学

DataCode数据类别代码字符串-hca必选

品事故资料

中华人民共和国表示：中华人民

Sta_Typ标准类别字符串-可选

国家标准共和国国家标准

表示：标准中文

石油化工可燃气名称为石油化工

接口参数

Sta_Nam_Chi标准中文名称字符串-体和有毒气体检可燃气体和有毒可选

测报警设计规范气体检测报警设

计规范

Specification表示：标准英文

fordesignof名称为

Sta_Nam_Eng标准英文译名字符串-combustibleSpecification可选

gasandtoxicfordesignof

gasdetectioncombustiblegas

8

T/CAPSAXXXX—XXXX

andalarmforandtoxicgas

petrochemicaldetectionand

industryalarmfor

petrochemical

industry

表示：13.300危

ICS国际标准分类号字符串-13.300可选

险品防护