應(yīng)急廣播平臺接口規(guī)范

1范圍廣播平臺、應(yīng)急廣播適配器的設(shè)計、建設(shè)、運行和維護。僅該日期對應(yīng)的版本適用于本文件；不注日期的引用文件，其最新版本(包括所有的修改單)適用于本GB/T4880.2—2000語種名稱代碼第2部分：GB/T28161—2011數(shù)字電視廣播業(yè)務(wù)信息規(guī)范GY/T383—2023應(yīng)急廣播系統(tǒng)總體技術(shù)規(guī)范GY/T385—2023應(yīng)急廣播消息格式規(guī)范GY/T386—2023應(yīng)急廣播系統(tǒng)資源分類GY/T389—2023應(yīng)急廣播系統(tǒng)數(shù)字簽名技術(shù)規(guī)范GY/T383—2023界定的以及下列術(shù)語和定義適用于本文件，2應(yīng)急廣播適配器emergencybroadcastingadapter接收、解析、驗證應(yīng)急廣播消息，并向廣播電視和網(wǎng)絡(luò)視聽系統(tǒng)進行協(xié)議轉(zhuǎn)換、簽名、封裝和存儲的設(shè)備。某時間點的所有數(shù)據(jù)。增量數(shù)據(jù)incrementaldata兩個時間點之間發(fā)生變化的數(shù)據(jù)?？臻g網(wǎng)格編碼spatialgridcoding一種用數(shù)字和字母表示地理范圍的方式。應(yīng)急廣播業(yè)務(wù)數(shù)據(jù)emergencybroadcastingdata;EBD應(yīng)急廣播運行管理過程產(chǎn)生的相關(guān)數(shù)據(jù)，主要包括應(yīng)急廣播消息、應(yīng)急廣播消息播發(fā)狀態(tài)查詢、應(yīng)急廣播消息播發(fā)狀態(tài)反饋、運維數(shù)據(jù)請求、應(yīng)急廣播平臺信息、臺站(前端)信息、應(yīng)急廣播適配器信息、傳輸覆蓋播出設(shè)備信息、平臺設(shè)備及終端信息、播發(fā)記錄、應(yīng)急廣播平臺狀態(tài)、應(yīng)急廣播適配器狀態(tài)、傳輸覆蓋播出設(shè)備狀態(tài)、平臺設(shè)備及終端狀態(tài)、行政區(qū)域信息、應(yīng)急廣播數(shù)字證書授權(quán)列表文件、心跳檢測、處理結(jié)果通知、接收回執(zhí)等。4縮略語和約定下列縮略語適用于本文件。HTTP超文本傳輸協(xié)議(HyperTextTransferProtocol)HTTPPOST一種從HTTP客戶端向服務(wù)器發(fā)送數(shù)據(jù)的方法TAR文件歸檔格式(TapeArchive)URN統(tǒng)一資源名(LniformUTF-88位Unicode字符集轉(zhuǎn)換格式(UnicodeTransformationFormat-8bitUnicode)XML可擴展標(biāo)記語言(ExtensibleMarkupLanguage)除非另有說明，第6章元素格式表中的“說明”的所有符號全部使用半角符號。應(yīng)急廣播平臺接口由接口請求方和接口響應(yīng)方組成，接口請求方和接口響應(yīng)方使用應(yīng)急廣播平臺接口進行數(shù)據(jù)傳輸。應(yīng)急廣播平臺接口類型包括各級應(yīng)急廣播平臺、應(yīng)急廣播平臺與應(yīng)急廣播適配器等之間的接口，見圖1。3圖1應(yīng)急廣播平臺接口類型6.1接口協(xié)議應(yīng)急廣播平臺數(shù)據(jù)交互主體分為接口請求方和接口響應(yīng)方，接口請求方和接口響應(yīng)方使用HTTP協(xié)議進行數(shù)據(jù)傳輸，實現(xiàn)各個接口功能。其中接口請求方為客戶端，主動向接口響應(yīng)方發(fā)起HTTP連接請求；接口響應(yīng)方為服務(wù)端，創(chuàng)建HTTP服務(wù)端口，偵聽處理接口請求方的請求。接口請求方和接口響應(yīng)方的接口功能應(yīng)符合6.4要求，接口協(xié)議框架應(yīng)與圖2相符合。圖2接口協(xié)議框架在交互過程中，接口請求方通過HTTPPOST方法將應(yīng)急廣播接口數(shù)據(jù)文件(簡稱接口數(shù)據(jù)文件)發(fā)送給接口響應(yīng)方：接口響應(yīng)方在當(dāng)前HTTP連接中接收該文件，并返回接收回執(zhí)TAR文件(接口數(shù)據(jù)文件的一種，見6.5),通知接口請求方初步處理結(jié)果，隨后結(jié)束該HTTP連接。等進一步處理后在新的HTTP連接中返回相應(yīng)的數(shù)據(jù)。接口流程應(yīng)與圖3相符合。接口請求方通過HTTP向接口響應(yīng)方傳輸接口數(shù)據(jù)文件時，應(yīng)在傳輸報文中注明該文件的文件名及打包壓縮方式，接口響應(yīng)方返回相應(yīng)的接收回執(zhí)TAR文件。具體示例見附錄A。4接口請求方圖3接口流程6.3文件格式6.3.1接口數(shù)據(jù)文件類型接口請求方和接口響應(yīng)方通過接口數(shù)據(jù)文件實現(xiàn)數(shù)據(jù)交換，接口數(shù)據(jù)文件采用TAR格式。接口數(shù)據(jù)文件有如下類型，格式應(yīng)符合6.5的要求：a)應(yīng)急廣播消息TAR文件；b)應(yīng)急廣播消息播發(fā)狀態(tài)查詢TAR文件：c)應(yīng)急廣播消息播發(fā)狀態(tài)反饋TAR文件：d)運維數(shù)據(jù)請求TAR文件；e)應(yīng)急廣播平臺信息TAR文件；g)應(yīng)急廣播適配器信息TAR文件；h)傳輸覆蓋播出設(shè)備信息TAR文件；i)平臺設(shè)備及終端信息TAR文件：j)播發(fā)記錄數(shù)據(jù)TAR文件：k)應(yīng)急廣播平臺狀態(tài)TAR文件：1)應(yīng)急廣播適配器狀態(tài)TAR文件；m)傳輸覆蓋播出設(shè)備狀態(tài)TAR文件；n)平臺設(shè)備及終端狀態(tài)TAR文件：o)行政區(qū)域信息TAR文件：p)應(yīng)急廣播數(shù)字證書授權(quán)列表TAR文件：q)心跳檢測TAR文件：r)處理結(jié)果通知TAR文件：s)接收回執(zhí)TAR文件。6.3.2接口數(shù)據(jù)文件構(gòu)成5接口數(shù)據(jù)文件分為應(yīng)急廣播消息文件和其他接口數(shù)據(jù)文件兩類。應(yīng)急廣播消息文件由應(yīng)急廣播消息指令文件、應(yīng)急廣播消息指令簽名文件和應(yīng)急廣播節(jié)目資源文件組成；其他接口數(shù)據(jù)文件由業(yè)務(wù)數(shù)據(jù)文件和業(yè)務(wù)數(shù)據(jù)簽名文件組成，業(yè)務(wù)數(shù)據(jù)文件和業(yè)務(wù)數(shù)據(jù)簽名文件均采用UTF-8編碼。接口數(shù)據(jù)文件應(yīng)符合表1的要求。表1接口數(shù)據(jù)文件6.3.3接口數(shù)據(jù)文件命名規(guī)則應(yīng)急廣播消息文件命名方式應(yīng)符合CY/T385—2023的規(guī)定。其他接口數(shù)據(jù)文件命名方式如下：a)接口數(shù)據(jù)文件：命名規(guī)則為“EBDT_數(shù)據(jù)文件編號，tar”,數(shù)據(jù)文件編號為其包含的業(yè)務(wù)數(shù)據(jù)文件的EBDID,EBDID說明見6.3.4;b)業(yè)務(wù)數(shù)據(jù)文件：命名規(guī)則為“EB0B_數(shù)據(jù)文件編號，xn!”,數(shù)據(jù)文件編號為其包含的業(yè)務(wù)數(shù)據(jù)文件的EBDID,EBDID說明見6.3.4;c)業(yè)務(wù)數(shù)據(jù)簽名文件：命名規(guī)則為“EBDSEBDB_數(shù)據(jù)文件編號，xml”,數(shù)據(jù)文件編號為被簽名的業(yè)務(wù)數(shù)據(jù)文件的EBDID,EBDID說明見6.3.4;d)在一個TAR文件包里面，所有數(shù)據(jù)文件(不含文件類型)的文件命名不得重復(fù)。6.3.4業(yè)務(wù)數(shù)據(jù)文件說明業(yè)務(wù)數(shù)據(jù)文件總體結(jié)構(gòu)應(yīng)與圖4相符合。日r7表2應(yīng)急廣播業(yè)務(wù)數(shù)據(jù)(EBD)元素格式1URN作為名稱空間(nanespace)23格式為：類型碼(2位數(shù)字碼)(23位數(shù)字碼)+順序碼(16位數(shù)字碼);增4詢文件；饋文件；維數(shù)據(jù)請求文件；急廣播平臺信息文件；輸覆蓋播出沒備信息文件；急廣播平臺狀態(tài)文件；4急廣播適配器狀態(tài)文件；輸覆蓋播出設(shè)備狀態(tài)文件；件；件為心跳檢測文件；理結(jié)果通知文件；56碼7址部業(yè)務(wù)請求。置8目標(biāo)對象9碼格式為YWVY-M-DOHH:WI:SS,YYYT表示年，W表示月，DO表示日，Ⅲ表示時(24小時制),表2(續(xù)) 臺站(前端)一 工EBDType取值為AdminArea 注：序號13～序號30的元素為業(yè)務(wù)數(shù)據(jù)詳情(多選一),6.4接口功能接口功能應(yīng)符合表3的要求，其中接口請求方發(fā)送的接口數(shù)據(jù)文件和接口響應(yīng)方返回的數(shù)據(jù)文件應(yīng)數(shù)據(jù)文件TAR文件發(fā)送給接口響應(yīng)方，請求接口響應(yīng)方播發(fā)應(yīng)急廣性內(nèi)容對應(yīng)急廣播消息進行播放息播發(fā)狀態(tài)播發(fā)狀態(tài)查詢TAR文件發(fā)送給廣播消息播發(fā)狀態(tài)查面TAR文件后，應(yīng)在新的HTTP連接中反餓”功能息播發(fā)狀態(tài)反饋TAR文件主動或收到請求后發(fā)送給接口響應(yīng)方表3(續(xù))數(shù)據(jù)文件數(shù)據(jù)文件報”“臺站(前端)信息上報”“應(yīng)急廣播適配器信息上報”臺信息TAR文件臺站(前端)臺站(前端)后，將臺站(前端)信息上報配器信息TR方信息上報給接口響應(yīng)方數(shù)據(jù)文件出設(shè)備信息方應(yīng)方件應(yīng)方出設(shè)備狀態(tài)數(shù)據(jù)文件級應(yīng)急廣播平臺的平臺設(shè)備及終端狀態(tài)上報給接口響應(yīng)方區(qū)域信息上報給接口響應(yīng)方字證書授權(quán)表的在線狀態(tài)應(yīng)方之前某請隸的處理結(jié)果一般是之前果請求中的接口口請求方，發(fā)送其對上次請求的處理結(jié)果以上級應(yīng)急廣播平臺向下級應(yīng)急廣播平臺發(fā)起應(yīng)急廣播消息播發(fā)狀態(tài)查詢，及下級應(yīng)急廣播平臺向上級應(yīng)急廣播平臺發(fā)起應(yīng)急廣播消息措發(fā)狀態(tài)反饋為例，應(yīng)急廣播上級應(yīng)急廣播平臺與下級應(yīng)急廣播平臺之間交互過程如下：a)上級應(yīng)急廣播平臺向下級應(yīng)急廣播平臺發(fā)起應(yīng)急廣播消息播發(fā)狀態(tài)查詢，見圖5;b)下級應(yīng)急廣播平臺向上級應(yīng)急廣播平臺發(fā)起應(yīng)急廣播消息播發(fā)狀態(tài)反饋，見圖6。圖5上級應(yīng)急廣播平臺向下級應(yīng)急廣播平臺發(fā)起應(yīng)急廣播消息播發(fā)狀態(tài)查詢圖6下級應(yīng)急廣播平臺向上級應(yīng)急廣播平臺發(fā)起應(yīng)急廣播消息播發(fā)狀態(tài)反饋6.5接口數(shù)據(jù)文件格式要求6.5.1應(yīng)急廣播消息TAR文件應(yīng)急廣播消息TAR文件格式應(yīng)符合GY/T385—2023的規(guī)定。6.5.2應(yīng)急廣播消息播發(fā)狀態(tài)查詢TAR文件應(yīng)急廣播消息插發(fā)狀態(tài)查詢TAR文件構(gòu)成應(yīng)符合表4的要求。應(yīng)急廣播消息播發(fā)狀態(tài)查詢文件的EBD.EBMStateRequest元素數(shù)應(yīng)急廣播消息播發(fā)狀態(tài)查詢文件的EBD.EBMSt1 23EBD.EEMStateRequest.6.5.3應(yīng)急廣播消息播發(fā)狀態(tài)反饋TA12(生成)格式為YYYY-MM-DDH:MI:SS,日，Ⅲ表示時(24小時制),MI4FDoFPWSLateHee表7(續(xù))5取值如下；間689息的覆蓋區(qū)域，多個行政區(qū)劃代蓋區(qū)域之間用“?！狈指粲媒K端數(shù) 出條目個EBRPS.EBRID臺站(前端)臺站(前端)FHOFWELALEHesE息碼EBRAS,EBRID播出詳情EBRRS,RptTine格式為YYYY-MM-DDHH:MT:SS,日，HH表示時(24小時制),MIEBRRS.BrdSysInfo情個元素的格式為(傳輸覆蓋播出表7(續(xù))為：(傳輸覆蓋播出設(shè)備編號1,輸覆蓋播出設(shè)備編號2,附加參數(shù)類型，附加參數(shù)值),…。(代輸覆蓋播出設(shè)備編號N,附加參數(shù)類型，附加參數(shù)值》格式為YYYY-NU-DDHH:MI:SS,日，HH表示時(24小時制),WI格式為YYYY-MN-DOHH:MI:SS,日，HH表示時(24小時制),WI束EBRBS.BrdStateCode態(tài)，取值如下；0:未處理；3:播發(fā)成功； 2EBRDTInfo;平臺設(shè)備及終端信息；表9(續(xù))3附加參數(shù)說明4時間格式為YYYY-MN-DDHH:WI:S表示時(24小時制),MI表示分(不含該時間點)數(shù)據(jù)5時間格式為YYYY-MN-DDHH:MI:S表示時(24小時制)。MI表示分(含該時間點)數(shù)據(jù)6M覆題12附加參數(shù)說明3格式為YYYY-MN-DDH;MI:SS表示時(24小時制),MI表示分，4格式為YYYY-MN-DDH:MI:SS5(ERD.ONDRequest)元素格式說明中EBD.OMDRcquest.Parats.Rpt的說明6臺信息條目5可選，個7(生成)8Syne;同步(新增、更新);9r表11(續(xù))6.5.6臺站(前端)信息TAR文件臺站(前端)信息TAR文件構(gòu)成應(yīng)符合表12的要求。表12臺站(前端)信息TAR文件構(gòu)成臺站(前端)信息文件的EBD,EBRSTInfo元素數(shù)據(jù)結(jié)構(gòu)應(yīng)與圖11相符合。日臺站(前端)2附加參數(shù)說明3YYYY表示年，MM表示月，DD表示日。HH表示時(24小時制),表13(續(xù))4格式為YYYY-MM-DOHH:WI:SS,示日，HH表示時(24小時制)5(EBD.OMDRequest)元素格式EBD.OWDRequest,Parans.Rpe的說明6臺站(前端)信息條目個7(生成)時間示日，HH表示時(24小時制)8Syne:同步(新增、更新):(前端)的其他屬性值沒有實際意文9臺站(前端)臺站(前端)被1息2附加參數(shù)說明3tTime格式為YYYY-MN-DDHH:MI:SS,V小時制),MI表示分，5S表示秒4格式為YTYV-MN-DDHH;MI:SS,V5見6.5.4運維數(shù)據(jù)請求(EBO,OMDEeEBD.MDRequest.Parans,RptTyp6息條目可選.個7(生成)格式為YYYY-MW-DDHH:MI:SS,Y小時制),MI表示分，SS表示秒8他屬性值沒有實際意義9EBRAS.iclatedE(前端)EBRAS.RclatedE(前端)表15(續(xù))稱EERAS.Longitud霞厘Rf1 2附加參數(shù)說明3日，HH表示時(24小時制),WI4格式為YYY-NM-DOHH:MI:SS,日，HH表示時(24小時制),WI5(EBD.ONDRequest)元素格式ERD.MORequest,Parans.Rpt的說明6可選，個7(生成)格式為YYTY-MM-DOH:MI:SS,日，Ⅲ表示時(24小時制),NI8輸覆蓋播出設(shè)備資源編碼之外。沒有實際意義9(前端)信息表17(續(xù))(前端)賢息碼覆蓋播出設(shè)備需具備該信息F間用“,”分隔。每個行政區(qū)域代隔示例：漢語的3字符代碼“xho”表17(續(xù))(發(fā)射機) 單位為赫(Hz)adioFarams.Autoswi機 多個1:周一；6:周六；表17(續(xù))ine格式為YYTY-MM-DOHH:MI:SS,日，HH表示時(24小時制),WI格式為YYTY-NM-DOHH:MI:SS,日，Ⅲ表示時(21小時制),WI省設(shè)對容m12附加參數(shù)說明3格式為YYTY-O-DOHH:MI:SS表示年，MW表示月，DD表示日，H表示時(24小時制),NI表示分，$S4格式為TVYY-M-DOHH:MI:SS表示年，MW表示月，DO表示日，HH表示時(24小時制),NI表示分，SS5(EBD.OMDEequest)元素格式EBD,OMIDRcquest.Parans.RptT說明表19(續(xù))67時間格式為YVYY-MM-DOHH:MI:SS表示秒89BRPSBRPS.EBRIDeridCode端覆蓋區(qū)域。多個覆蓋區(qū)域用“,”素一2一表21(續(xù))3表示年，MM表示月，DO表示日，HH表示時(24小時制),MI表示分，$S4格式為TYYY-VM-DDHH:MT:5表示年，MM表示月。D0表示日，HH5(ERD.CMDRequest)元素格式中EBD.ONDRequest.Parans.RptT6條日可選。個7已播發(fā)的8應(yīng)急廣播消息編號說明見GT/T9siclnfo格式為YYYT-IW-DDHH:MI:SS表示年，MM表示月，D0表示日，Ⅲ表21(續(xù))sieInfo,Severity1:1級(特別重大/紅色預(yù)警/Red);2:2級(重大/橙色預(yù)警/Orange);3:3級(較大/黃色預(yù)警/Yellaw);4:4級(一般/監(jiān)色預(yù)警/Blue)格式為YYYY-VM-DDHH:MI:SS表示年，MM表示月。D0表示日，HH表示時(24小時制)。MI表示分，SS格式為YYYT-MM-DDHH:MI:$S表示年，MM表示月，DO表示日，HH表示時(24小時制),MI表示分，SSntentent.LanguageCode例如：漢語的3字符代碼“zho”ntent.MsgTitlentent.AreaCode用“.”分隔，每個行政區(qū)域代碼應(yīng)符合GY/T386—2023的規(guī)定Brdlten.Eu,MsgCoCode要求的覆蓋區(qū)域。多個覆蓋區(qū)域用“,”分隔表21(續(xù))息目可選，個Brdltem.LnitInfo一ode表21(續(xù))率Hrdlten.Coverage用“,”分隔，每個行政區(qū)域代碼應(yīng)符合GY/T386—2023的規(guī)定的覆蓋區(qū)域。多個覆蓋區(qū)域用“,”蓋播出設(shè)備數(shù)，實際調(diào)用終端數(shù)0播出條目o.ResBrdTten個o,ResBrdItenEBRrSS.EBRID臺站(前臺站(前表21(續(xù))SS個S.RptTime格式為YYYT-VM-DDHH:MI:S表示年，MM表示月，DO表示日，HH表示時(24小時制),MI表示分，S5o,ResBrdItes.EBEI加參數(shù)值為傳輸覆蓋播出設(shè)備所播加參數(shù)值為傳輸覆蓋播出設(shè)備所播NHz,表示附加參數(shù)值為傳輸覆蓋播出設(shè)備編號值),……,(傳輸覆蓋播出設(shè)備編號N。附加參數(shù)類型，附加參數(shù)值)o.ResBrdItenEBRBS.StartTine格式為TYYT-VW-DDHH:MI:SS表示年，MM表示月。D0表示日，HH表示時(24小時制),MI表示分，SSS,EndTime格式為YYYT-VM-DDHH:MI:S表示年，MM表示月，DO表示日，HH表示時(24小時制),MI表示分，55S,FilelRLo.BesBrdItenEBEB