在設計一個資源分享應用。設計RESTful API時,在設計層面有些蒙圈了。特地求教各位。
物聯(lián)網(wǎng)設備通過設備云服務抽象成一個設備API。而我目前設計的Web APP則是通過與應用業(yè)務的整合,將設備API封裝后,再次封發(fā)給第三方APP(比如其他合作平臺)和移動APP。
DeviceAPI --> WebAPI -?-> Cloud|APK|APP
我現(xiàn)在有兩種選擇:
第一種來自Flask/Flask-RESTful的API設計,采用JSON格式。先采用API Key/Secret登陸,換取token,然后在后續(xù)訪問中采用token來訪問,也可以利用API Key/Secret繼續(xù)訪問。這是最常見的經(jīng)典方式。典型的URL風格是:
http://host/api/version/resource/idx/
第二種來自Flask-appbuilder自帶的資源驅動的REST API,采用JSON格式。但是其鑒權方式采用經(jīng)典的username/password。換而言之,移動APP事實上是作為瀏覽器的替代物而存在的。唯一區(qū)別在于返回值采用JSON替代了XHTML。典型URL風格是:
http://host/resource/api/idx
有些怪異,是吧?但URI字段順序并不是最重要的,我發(fā)現(xiàn)移動APP和第三方APP的需求是有差異的。
作為用戶,使用移動APP列出自己名下的設備列表,并通過設備ID來訪問特定設備的狀態(tài)讀取和指令下發(fā)。所以這種方式更加適合第二種方式。
作為合作方網(wǎng)站,需要訪問的范圍可能更加廣,雖然不能夠指令下發(fā),但是讀取特定設備的狀態(tài)也涉及到隱私權。這個似乎更加適合第一種方式。
必須依賴設備ID訪問特定設備,不同的用戶,不同的第三方平臺都需要單獨的設備密鑰。這兩種方式是否可以整合?
這個問題比較寬泛,歡迎指教和討論。
我發(fā)現(xiàn)flask-appbuilder的API URL其實是由sqlalchemy導出的,專為其后臺網(wǎng)頁的AJAX目的而設計。所以不完全符合RESTFul的架構。而flask-restful則是根據(jù)RESTFul而設計導出的,其路徑可以有用戶自定義。
一般來說,針對Web、Mobile、前端的API,還是有所差異的。差異在于Web是固定IP的,而Mobile和瀏覽器前端IP不定,甚至是隱藏IP。這導致三者間鎖定和鑒權方式不一致。Web鎖定domain/IP,瀏覽器鎖定Referrer,Mobile無法鎖定。此外,對于apiKey/apiSecret/nouce/signature/TLS,以及登陸用戶的username/password等信息都通過session/cookie進行保存。
北大青鳥APTECH成立于1999年。依托北京大學優(yōu)質雄厚的教育資源和背景,秉承“教育改變生活”的發(fā)展理念,致力于培養(yǎng)中國IT技能型緊缺人才,是大數(shù)據(jù)專業(yè)的國家
達內(nèi)教育集團成立于2002年,是一家由留學海歸創(chuàng)辦的高端職業(yè)教育培訓機構,是中國一站式人才培養(yǎng)平臺、一站式人才輸送平臺。2014年4月3日在美國成功上市,融資1
北大課工場是北京大學校辦產(chǎn)業(yè)為響應國家深化產(chǎn)教融合/校企合作的政策,積極推進“中國制造2025”,實現(xiàn)中華民族偉大復興的升級產(chǎn)業(yè)鏈。利用北京大學優(yōu)質教育資源及背
博為峰,中國職業(yè)人才培訓領域的先行者
曾工作于聯(lián)想擔任系統(tǒng)開發(fā)工程師,曾在博彥科技股份有限公司擔任項目經(jīng)理從事移動互聯(lián)網(wǎng)管理及研發(fā)工作,曾創(chuàng)辦藍懿科技有限責任公司從事總經(jīng)理職務負責iOS教學及管理工作。
浪潮集團項目經(jīng)理。精通Java與.NET 技術, 熟練的跨平臺面向對象開發(fā)經(jīng)驗,技術功底深厚。 授課風格 授課風格清新自然、條理清晰、主次分明、重點難點突出、引人入勝。
精通HTML5和CSS3;Javascript及主流js庫,具有快速界面開發(fā)的能力,對瀏覽器兼容性、前端性能優(yōu)化等有深入理解。精通網(wǎng)頁制作和網(wǎng)頁游戲開發(fā)。
具有10 年的Java 企業(yè)應用開發(fā)經(jīng)驗。曾經(jīng)歷任德國Software AG 技術顧問,美國Dachieve 系統(tǒng)架構師,美國AngelEngineers Inc. 系統(tǒng)架構師。