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