1 范圍

      GB 26875的本部分規(guī)定了城市消防遠程監(jiān)控系統(tǒng)監(jiān)控中心對外數(shù)據(jù)交換協(xié)議的縮略語、XMLSchema定義、一般要求、數(shù)據(jù)查詢接口和數(shù)據(jù)實時發(fā)布接口。

      本部分適用于城市消防遠程監(jiān)控系統(tǒng)監(jiān)控中心與外部系統(tǒng)之間的數(shù)據(jù)交換。

2 規(guī)范性引用文件

      下列文件對于本文件的應(yīng)用是必不可少的。凡是注日期的引用文件，僅注日期的版本適用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改單）適用于本文件。

      GB 18030 信息技術(shù) 中文編碼字符集

      GB/T 26875.4-2011 城市消防遠程監(jiān)控系統(tǒng) 第4部分：基本數(shù)據(jù)項

      GB 50440 城市消防遠程監(jiān)控系統(tǒng)技術(shù)規(guī)范

      RFC 2616 超文本傳輸協(xié)議（Hypertext Transfer Protocol-HTTP/1.1）

      RFC 2818 超文本傳輸安全協(xié)議（HTTP Over TLS）

      RFC 3023 XML媒體類型（XML Media Types）

      RFC 3629 ISO 10646的轉(zhuǎn)換格式（UTF-8，a transformation format of ISO 10646）

      RFC 6749 OAuth 2.0 認證框架（The OAuth 2.0 Authorization Framework）

3 術(shù)語和定義

      GB 50440界定的術(shù)語和定義適用于本文件。

4 縮略語

      下列縮略語適用于本文件。

      HTTP：超文本傳輸協(xié)議（Hypertext Transfer Protocol）

      HTTPS：超文本傳輸安全協(xié)議（HTTP Over TLS）

      REST：表述性狀態(tài)轉(zhuǎn)移（Representational State Transfer）

      URI：統(tǒng)一資源標識符（Uniform Resource Identifier）

      XML：可擴展標記語言（eXtensible Markup Language）

      XML Schema：可擴展標記語言架構(gòu)定義（XML Schema Definition）

5 XML Schema定義

5.1 GB/T 26875.4-2011中規(guī)定的各類信息的XML Schema定義見附錄A。

5.2 數(shù)據(jù)訂閱請求、取消數(shù)據(jù)訂閱請求、數(shù)據(jù)訂閱響應(yīng)及相關(guān)數(shù)據(jù)通知的XML Schema定義見附錄B。

5.3 附錄A、附錄B所述XML Schema中引用的公用數(shù)據(jù)類型的XML Schema定義見附錄C。

6 一般要求

6.1 本協(xié)議使用的字符集應(yīng)滿足GB18030或RFC 3629的規(guī)定。

6.2 本協(xié)議應(yīng)以HTTP或HTTPS協(xié)議作為底層承載協(xié)議。采用HTTP協(xié)議時，應(yīng)滿足 RFC 2616的規(guī)定；采用HTTPS協(xié)議時，應(yīng)滿足RFC 2818的規(guī)定。

6.3 本協(xié)議宜采用OAuth 2.0協(xié)議進行客戶端驗證和授權(quán)，并滿足RFC6749的規(guī)定。

6.4 監(jiān)控中心如未能處理接收到的請求時，返回的HTTP響應(yīng)的狀態(tài)代碼（Status Code）應(yīng)是400，實體主體（Entity Body）應(yīng)是RFC 3023中描述的媒體類型為“application/xml”的錯誤響應(yīng)。錯誤響應(yīng)的XML Schema定義見A．15，其中description元素為錯誤描述；code元素為錯誤代碼，取值范圍為1～9999，僅1000～9999用于自定義錯誤，錯誤代碼的定義見表1。

表1 錯誤代碼表

7 數(shù)據(jù)查詢接口

7.1 數(shù)據(jù)查詢請求

7.1.1 任何查詢請求應(yīng)支持表2規(guī)定的通用查詢參數(shù)。

表2 通用查詢參數(shù)

7.1.2 查詢請求接口應(yīng)支持HTTP的GET方法。

      注：GET方法是HTTP規(guī)定的客戶端與服務(wù)器的交互方法之一，一般用于獲取或查詢資源信息。

7.1.3 查詢請求接口應(yīng)采用REST風格的HTTP接口，接口URL基本格式為http（s）：//．．．/openapi/vl/query/｛uri｝｛query＿string｝，其中｛uri｝應(yīng)支持7.3規(guī)定的各類查詢的｛uri｝路徑，｛uri｝可在任何“/”處截止，不以“/”結(jié)尾；｛query＿string｝由通用查詢參數(shù)和具體查詢參數(shù)組合而成，在格式上，以“？”字符為起點，每個參數(shù)以“＆”隔開，再以“＝”分開參數(shù)名稱與參數(shù)值，同一參數(shù)的參數(shù)值如有多個，則以“，”連接參數(shù)值。如？keyl＝value＆．key2＝value21，value22＆．．．．．

7.2 數(shù)據(jù)查詢響應(yīng)

7.2.1 查詢響應(yīng)數(shù)據(jù)的格式由查詢請求的format參數(shù)指定。

7.2.2 查詢響應(yīng)數(shù)據(jù)的編碼類型由查詢請求的oe參數(shù)指定。

7.3 數(shù)據(jù)查詢細則

7.3.1 監(jiān)控中心查詢

7.3.1.1 ｛uri｝為jkzx＿list/｛jkzx＿guid｝。

7.3.1.2 ｛query＿string｝可使用表3規(guī)定的具體查詢參數(shù)。

表3 監(jiān)控中心具體查詢參數(shù)

7.3.1.3 響應(yīng)數(shù)據(jù)的XML Schema定義見A．1。

7.3.2 監(jiān)控人員查詢

7.3.2.1 ｛uri｝為jkzx＿list/｛jkzx＿guid｝/jkry＿list/｛jkry＿guid｝。

7.3.2.2｛query＿string｝除可以使用7.3.1.2規(guī)定的參數(shù)外，還可使用表4規(guī)定的具體查詢參數(shù)。

以上為標準部分內(nèi)容，如需看標準全文，請到相關(guān)授權(quán)網(wǎng)站購買標準正版。