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可選

險品防護