智慧安居信息服務(wù)資源接口規(guī)范第1部分基于表述性狀態(tài)轉(zhuǎn)

《智慧安居信息服務(wù)資源接口規(guī)范第1部分基于表述性狀態(tài)轉(zhuǎn)移（REST）技術(shù)的接口方法》編制說明一、項目背景作為智慧城市應(yīng)用領(lǐng)域之一，智慧安居是廣泛應(yīng)用物聯(lián)網(wǎng)、云計算等先進(jìn)技術(shù)，高度集成管理運行體系、信息化應(yīng)用體系和基礎(chǔ)支撐體系，建立和完善智慧型的社會服務(wù)管理工作大格局，保障安全、服務(wù)民生的惠民實事工程。智慧安居以居民服務(wù)為核心，為居民提供安全、高效、便捷的智慧化服務(wù)，涵蓋智慧家居系統(tǒng)、智慧樓宇、智慧社區(qū)、智慧安防等諸多領(lǐng)域，僅智能家居產(chǎn)業(yè)一項，即將進(jìn)入快速發(fā)展期，并以每年約19.8%的速率增長，預(yù)計2015年產(chǎn)值達(dá)1240億元。在發(fā)展戰(zhàn)略性新興產(chǎn)業(yè)的時代背景下，智慧安居的廣泛應(yīng)用可以充分發(fā)揮信息技術(shù)對城市發(fā)展和經(jīng)濟社會發(fā)展的引領(lǐng)支撐作用，有利于提高群眾生活品質(zhì)，有利于創(chuàng)新社會管理方式，有利于提高資源配置效率，有利于增強社會穩(wěn)定性。工作簡況任務(wù)來源根據(jù)國家標(biāo)準(zhǔn)化管理委員會2014年下達(dá)的國家標(biāo)準(zhǔn)制修訂計劃，國家標(biāo)準(zhǔn)《智慧安居應(yīng)用系統(tǒng)數(shù)據(jù)接口規(guī)范》（標(biāo)準(zhǔn)初始名稱）由浙江省標(biāo)準(zhǔn)化研究院、中國標(biāo)準(zhǔn)化研究院負(fù)責(zé)起草，標(biāo)準(zhǔn)計劃號為20141937-Z-469（全國電子業(yè)務(wù)標(biāo)準(zhǔn)化技術(shù)委員會2014年標(biāo)準(zhǔn)項目）。起草單位及起草人員2014年10月接到標(biāo)準(zhǔn)制定任務(wù)后，成立了以浙江省標(biāo)準(zhǔn)化研究院為牽頭單位，浙江大華技術(shù)股份有限公司、浙江航天長峰科技發(fā)展有限公司、杭州鴻雁電器有限公司、杭州湯米智能科技有限公司、浙江省郵電工程建設(shè)有限公司、浙江好絡(luò)維醫(yī)療技術(shù)有限公司、杭州天策啟瑞科技有限公司、杭州聰普智能科技有限公司、紹興瑞谷物聯(lián)網(wǎng)技術(shù)有限公司、浙江科技學(xué)院、浙江省物聯(lián)網(wǎng)產(chǎn)業(yè)協(xié)會等10多個專家為成員的標(biāo)準(zhǔn)編寫組。主要工作過程2014年10月23日，在浙江省標(biāo)準(zhǔn)化研究院組織召開智慧安居系列標(biāo)準(zhǔn)起草組第一次討論會議。會議由浙江省標(biāo)準(zhǔn)化研究院匯報了《智慧安居應(yīng)用系統(tǒng)數(shù)據(jù)接口規(guī)范》的前期工作情況，各起草單位結(jié)合各自單位情況談了對智慧安居和本標(biāo)準(zhǔn)的大致構(gòu)想。2014年11月7日，浙江省標(biāo)準(zhǔn)化研究院組織召開智慧安居系列標(biāo)準(zhǔn)起草組第二次討論會議。起草組從“安”和“居”兩方面展開對智慧安居定義的討論，并大致商定了智慧安居的業(yè)務(wù)功能范圍為社會運營服務(wù)、基礎(chǔ)業(yè)務(wù)服務(wù)、安防管理服務(wù)、宜居管理服務(wù)、居住商務(wù)服務(wù)、運營管理服務(wù)等幾部分。2015年1月23日，在浙江省標(biāo)準(zhǔn)化研究院組織召開智慧安居系列標(biāo)準(zhǔn)起草組第八次討論會議上，針對本標(biāo)準(zhǔn)，起草組經(jīng)過討論要求增加標(biāo)準(zhǔn)中文目錄，XML部分作為規(guī)范性附錄A。2015年2月6日，浙江省標(biāo)準(zhǔn)化研究院組織召開智慧安居系列標(biāo)準(zhǔn)起草組第九次討論會議。起草組調(diào)整了標(biāo)準(zhǔn)目錄層次，提出體系架構(gòu)圖要詳細(xì)描述接口內(nèi)容，說明資源情況。2015年4月8日，浙江省標(biāo)準(zhǔn)化研究院在杭州環(huán)島賓館組織召開智慧安居國家標(biāo)準(zhǔn)研討會。參加會議的有中國標(biāo)準(zhǔn)化研究院、南京中新賽克科技有限公司、華立儀表集團股份有限公司、杭州天夏科技集團有限公司、浙江達(dá)峰科技有限公司、杭州根特電子信息科技有限公司等單位的專家和企業(yè)代表以及標(biāo)準(zhǔn)起草組成員共計18名。討論提出：1、智慧安居的定義要明確范圍，標(biāo)準(zhǔn)的邊界和范圍也要明確。2、數(shù)據(jù)接口示意圖中，外部應(yīng)用改為業(yè)務(wù)應(yīng)用。2015年10月20日，浙江省標(biāo)準(zhǔn)化研究院組織召開智慧安居國家標(biāo)準(zhǔn)第十一次研討會。與會專家有中國標(biāo)準(zhǔn)化研究院任冠華博士、公安部計算機與信息處理標(biāo)準(zhǔn)化技術(shù)委員會巢明峻委員、地下管線委員會江怡芳秘書長、網(wǎng)端科技（杭州）有限公司樓微然董事長。另外還有杭州徳瀾科技有限公司、浙江好絡(luò)維醫(yī)療技術(shù)有限公司、杭州湯米智能科技有限公司等16家系列標(biāo)準(zhǔn)的參與單位代表參與本次研討。會議對本標(biāo)準(zhǔn)形成的修改意見有：標(biāo)準(zhǔn)名稱改為“智慧安居信息服務(wù)資源接口規(guī)范第1部分基于表述性狀態(tài)轉(zhuǎn)移（REST）技術(shù)的接口方法”；調(diào)整術(shù)語定義為“智慧安居信息服務(wù)”；增加URI的目錄層定義說明，應(yīng)用資源數(shù)據(jù)接口按“資訊、保障、定制、分析聯(lián)動、運維管理”進(jìn)行分類；接口的輸入輸出等要有明確規(guī)定；調(diào)整附錄A(規(guī)范性附錄)數(shù)據(jù)接口規(guī)范XMLSchame的格式；增加附錄C(資料性附錄)數(shù)據(jù)樣例。會后，起草組再次討論并作出相應(yīng)調(diào)整。2015年12月23日，浙江省標(biāo)準(zhǔn)化研究院在浙江科技學(xué)院組織召開智慧安居國家第十二次標(biāo)準(zhǔn)起草組討論會。起草組討論提出增加前言中智慧安居信息服務(wù)資源接口規(guī)范其他部分的定義；接口定義部分按照YD/T2464-2013重新組織目錄及內(nèi)容；附錄C新增政務(wù)資訊服務(wù)、家政資訊服務(wù)、商家黃頁服務(wù)、視頻瀏覽服務(wù)、出入口控制服務(wù)、訂閱服務(wù)等主要接口消息范例。2016年1月21日，浙江省標(biāo)準(zhǔn)化研究院組織召開智慧安居國家標(biāo)準(zhǔn)第十三次討論會。討論決定在定制服務(wù)中增加一個接口“通知服務(wù)”的說明。標(biāo)準(zhǔn)征求意見的落實情況發(fā)送《標(biāo)準(zhǔn)草案稿》的單位包括向部分相關(guān)單位征求意見、工作組專家（評審）建議或意見的單位數(shù)共計個。標(biāo)準(zhǔn)編制原則本標(biāo)準(zhǔn)以自主編寫的方式完成。標(biāo)準(zhǔn)編制組引用了YD/T2764基于表述性狀態(tài)轉(zhuǎn)移（REST）技術(shù)的業(yè)務(wù)能力開放應(yīng)用程序接口（API）地址本、YD/T2765基于表述性狀態(tài)轉(zhuǎn)移（REST）技術(shù)的業(yè)務(wù)能力開放應(yīng)用程序接口（API）支付業(yè)務(wù)等標(biāo)準(zhǔn)，參考了GB/T28181安全防范視頻監(jiān)控聯(lián)網(wǎng)系統(tǒng)信息傳輸、交換、控制技術(shù)要求、GB/T30147安防監(jiān)控視頻實時智能分析設(shè)備技術(shù)要求、GA/T753.6報警統(tǒng)計信息管理代碼第6部分：違反治安管理行為分類與代碼、GA/T753.8報警統(tǒng)計信息管理代碼第8部分：群體性事件分類與代碼等標(biāo)準(zhǔn)，標(biāo)準(zhǔn)編制以科學(xué)、客觀、合理、適用為原則，在查閱和吸收國內(nèi)國際等相關(guān)文獻(xiàn)資料和相關(guān)要求，結(jié)合我國智慧安居的實際建設(shè)情況，并適度考慮前瞻性下編制了本標(biāo)準(zhǔn)。標(biāo)準(zhǔn)的主要內(nèi)容及依據(jù)本標(biāo)準(zhǔn)規(guī)定了智慧安居信息服務(wù)資源調(diào)用接口的基本要求、接口定義等內(nèi)容。本標(biāo)準(zhǔn)適用于智慧安居應(yīng)用系統(tǒng)的規(guī)劃、開發(fā)、運維和管理，可供智慧安居服務(wù)單位參考使用。（一）術(shù)語和定義智慧安居信息服務(wù)smartresidinginformationservice：由服務(wù)單位基于現(xiàn)代通訊網(wǎng)絡(luò)，通過物聯(lián)網(wǎng)、地理信息、大數(shù)據(jù)、云計算等信息技術(shù)實現(xiàn)智慧研判，滿足服務(wù)區(qū)域內(nèi)居民的安全與舒適的生活需求，并提供交互式的信息服務(wù)模式。表述性狀態(tài)轉(zhuǎn)移representationalstatetransfer：一種針對網(wǎng)絡(luò)應(yīng)用的設(shè)計和開發(fā)方式，指的是一組架構(gòu)約束條件和原則，可以降低開發(fā)的復(fù)雜性，提高系統(tǒng)的可伸縮性。[YD/T2764-2014和YD/T2765-2014]（二）基本要求協(xié)議接口應(yīng)采用REST架構(gòu)風(fēng)格定義，通過HTTP的方法動詞提供REST服務(wù)，所涉及的信息服務(wù)資源采用XML或JSON進(jìn)行封裝。HTTPURI格式定義為：<protocol>://<ip>:<port>/<URI>?p1=v1&p2=v2&…&pn=vn，其中，protocol支持http和https協(xié)議，ip指主機地址或域名，port指http請求所用的端口號，URI路徑是“<SERVICE>/<resource>”，查詢字符串參數(shù)以“p1=v1&p2=v2&…&pn=vn”形式出現(xiàn)。（三）接口定義智慧安居信息服務(wù)資源接口可將基礎(chǔ)應(yīng)用服務(wù)信息提供給智慧安居其他信息應(yīng)用平臺，包括資訊服務(wù)、居家生活、保障服務(wù)和定制服務(wù)，其中資訊服務(wù)以政務(wù)信息、天氣信息獲取，居家生活以家政服務(wù)、商家黃頁服務(wù)，保障服務(wù)以視頻瀏覽、出入口控制，定制服務(wù)以訂閱服務(wù)等為例進(jìn)行接口說明。示例：政務(wù)信息的接口定義政務(wù)信息URIhttp://<ip>:<port>/SR/System/AffairsInfo/Parameters請求URI變量政務(wù)信息請求URI變量說明具體見表1。URI變量說明名稱描述SRSmartResiding，縮寫為“SR”System系統(tǒng)AffairsInfo政務(wù)資訊Parameters查詢條件參數(shù)列表響應(yīng)代碼政務(wù)信息響應(yīng)代碼要求見附錄B。GET操作請求政務(wù)信息請求參數(shù)具體見表2。政務(wù)信息查詢請求參數(shù)字段類型是否必選備注Keywordsstringtrue查詢關(guān)鍵詞Categorystringfalse根據(jù)關(guān)鍵詞從指定政務(wù)資訊類型中進(jìn)行查詢響應(yīng)政務(wù)信息響應(yīng)參數(shù)具體見表3。政務(wù)信息查詢響應(yīng)參數(shù)字段類型備注Statusstring響應(yīng)狀態(tài)，成功或失敗Detailsstring響應(yīng)錯誤信息，正常為空Totalinteger檢索結(jié)果數(shù)量Datalist檢索結(jié)果列表PublishDeptstring政務(wù)信息發(fā)布單位PublishTimedatetime政務(wù)信息發(fā)布時間Categorystring政務(wù)信息類型Titlestring政務(wù)信息標(biāo)題Contentstring政務(wù)信息內(nèi)容主要試驗（或驗證）的分析報告、相關(guān)技術(shù)和經(jīng)濟影響論證無。重大意見分歧的處理依據(jù)和結(jié)果無。預(yù)期的社會經(jīng)濟效益及貫徹實施標(biāo)準(zhǔn)的要求、措施等建議通過規(guī)范智慧安居信息服務(wù)資源接口規(guī)范第1部分:基于表述性狀態(tài)轉(zhuǎn)移(REST)技術(shù)的接口，能增進(jìn)應(yīng)用系統(tǒng)之間的交流，數(shù)據(jù)接口規(guī)范使相關(guān)的應(yīng)用系統(tǒng)逐漸走向統(tǒng)一化,提高信息的口徑的一致性，便于相互數(shù)據(jù)轉(zhuǎn)換。智慧安居各應(yīng)用系統(tǒng)的之間數(shù)據(jù)共享和數(shù)據(jù)交換更為便捷,降低整個系統(tǒng)的信息成本水平。通過規(guī)范智慧安居應(yīng)用系統(tǒng)數(shù)據(jù)接口，能有效保護應(yīng)用系統(tǒng)用戶的利益，有利于智慧安居應(yīng)用系統(tǒng)的開發(fā)與使用，降低了應(yīng)用系統(tǒng)的開發(fā)成本,為用戶的特殊需求和二次開發(fā)提供數(shù)據(jù)接口，極大地簡化了軟件設(shè)計工作。同時，數(shù)據(jù)接口規(guī)范使得智慧安居信息服務(wù)基礎(chǔ)應(yīng)用系統(tǒng)用戶擺脫束縛,即使系統(tǒng)的各模塊都采用購買成品的方式也不必整個系統(tǒng)一定要使用同一公司的產(chǎn)品，使得每個系統(tǒng)模塊都能選用市場上最好的產(chǎn)品。通過規(guī)范智慧安居應(yīng)用系統(tǒng)數(shù)據(jù)接口規(guī)范