一種路由器的接口體系的構(gòu)建方法
【技術(shù)領(lǐng)域】
[0001] 本發(fā)明屬于路由器的技術(shù)領(lǐng)域，具體地涉及一種路由器的接口體系的構(gòu)建方法。
【背景技術(shù)】
[0002] 傳統(tǒng)的路由器，其內(nèi)部各種功能通過直接調(diào)用指令來完成，各種不同的功能有不 同的實現(xiàn)方式、不同的參數(shù)形式和調(diào)用方式，功能劃分不清晰。接口沒有一個統(tǒng)一的接口輸 入輸出框架，不便于進(jìn)行功能擴(kuò)展，也不便于調(diào)用者使用。
[0003] 另一方面，傳統(tǒng)的路由器的接口只能在本地調(diào)用，只有本地網(wǎng)絡(luò)中才能對路由器 進(jìn)行操作，而無法遠(yuǎn)程進(jìn)行信息查看和參數(shù)設(shè)置，可擴(kuò)展性較差。
[0004] 再一方面，傳統(tǒng)的路由器的接口權(quán)限控制（權(quán)限控制指對不通的調(diào)用者，限制他 們接口調(diào)用的范圍，保證系統(tǒng)的安全性和可控性）較為簡單，只要有后臺密碼，就可以調(diào)用 所有接口，而無法進(jìn)行權(quán)限劃分，比如某些調(diào)用者只能查看信息，某些調(diào)用者可以有更多高 權(quán)限的功能，這樣造成路由器使用時安全性較低。

【發(fā)明內(nèi)容】

[0005] 本發(fā)明要解決的技術(shù)解決問題是：克服現(xiàn)有技術(shù)的不足，提供一種路由器的接口 體系的構(gòu)建方法，其能夠使得接口體系清晰、便于進(jìn)行功能擴(kuò)展、便于調(diào)用者使用、接口在 本地和遠(yuǎn)程皆可調(diào)用、系統(tǒng)安全性強(qiáng)。
[0006] 本發(fā)明的技術(shù)解決方案是：這種路由器的接口體系的構(gòu)建方法，該方法包括：構(gòu) 造基于命名空間的接口體系、構(gòu)造消息通道、配置權(quán)限認(rèn)證、配置輸入輸出參數(shù)格式；
[0007] 在構(gòu)造基于命名空間的接口體系中，路由器對外提供的API方法由嵌入式動態(tài)語 言Iua編寫，以namespace命名空間來組織，各級空間以點號分割，命名空間分為三個層次， 權(quán)限范圍逐步變小，下面的層次隸屬于上一層，是上一層功能的子集；
[0008] 在構(gòu)造消息通道中，路由器端作為一個消息接收者同cloud-client對接，服務(wù)器 端則作為一個業(yè)務(wù)系統(tǒng)同cloud-server通信，服務(wù)器端采用同步調(diào)用接口同cloud服務(wù)器 進(jìn)行通信，API的接口調(diào)用路徑包括本地和服務(wù)器端；
[0009] 在配置權(quán)限認(rèn)證中，API調(diào)用者使用預(yù)先分配的app_key和app_secret來對請求 簽名，服務(wù)器端直接調(diào)用openapi. hiwifi. com，客戶端通過openapi. hiwifi. com和指定路 由器綁定以后，通過請求域名client, openapi. hiwifi. com直接調(diào)用被綁定路由器里面的 接口。
[0010] 本發(fā)明按照命名空間劃分出具體的接口所屬系統(tǒng)，使得接口體系清晰；本發(fā)明通 過構(gòu)造消息通道，使得云服務(wù)器端和路由器端同時調(diào)用，而無需做任何切換，實現(xiàn)透明的調(diào) 用效果，便于進(jìn)行功能擴(kuò)展、便于調(diào)用者使用、接口在本地和遠(yuǎn)程皆可調(diào)用；本發(fā)明在配置 權(quán)限認(rèn)證中實現(xiàn)了權(quán)限授權(quán)和校驗功能，可以對不同的使用者授予不同的權(quán)限，保證系統(tǒng) 的安全性和可控性。
【附圖說明】
[0011] 圖1示出了根據(jù)本發(fā)明的API的namespace的結(jié)構(gòu)設(shè)計。
[0012] 圖2示出了根據(jù)本發(fā)明的加密消息通道的一個優(yōu)選實施例。
[0013] 圖3示出了根據(jù)本發(fā)明的openapi調(diào)用路徑。
[0014] 圖4示出了根據(jù)本發(fā)明的遠(yuǎn)程調(diào)用API框架。
【具體實施方式】
[0015] 這種路由器的接口體系的構(gòu)建方法，該方法包括：構(gòu)造基于命名空間（命名空間 是一種范圍劃分方法，將相關(guān)的事務(wù)合并到同一個分類中）的接口體系、構(gòu)造消息通道、配 置權(quán)限認(rèn)證、配置輸入輸出參數(shù)格式；
[0016] 在構(gòu)造基于命名空間的接口體系中，路由器對外提供的API方法由嵌入式動態(tài)語 言Iua編寫，以namespace命名空間來組織，各級空間以點號分割，命名空間分為三個層次， 權(quán)限范圍逐步變小，下面的層次隸屬于上一層，是上一層功能的子集；
[0017] 在構(gòu)造消息通道中，路由器端作為一個消息接收者同cloud-client對接，服務(wù)器 端則作為一個業(yè)務(wù)系統(tǒng)同cloud-server通信，服務(wù)器端采用同步調(diào)用接口同cloud服務(wù) 器（指路由器開發(fā)廠商所擁有的，部署在機(jī)房的服務(wù)器，與路由器端是相對的概念）進(jìn)行通 信，API的接口調(diào)用路徑包括本地和服務(wù)器端；
[0018] 在配置權(quán)限認(rèn)證中，API調(diào)用者使用預(yù)先分配的app_key和app_secret來對請求 簽名，服務(wù)器端直接調(diào)用openapi. hiwifi. com，客戶端通過openapi. hiwifi. com和指定路 由器綁定以后，通過請求域名client, openapi. hiwifi. com直接調(diào)用被綁定路由器里面的 接口。
[0019] 本發(fā)明按照命名空間劃分出具體的接口所屬系統(tǒng)，使得接口體系清晰；本發(fā)明通 過構(gòu)造消息通道，使得云服務(wù)器端和路由器端同時調(diào)用，而無需做任何切換，實現(xiàn)透明的調(diào) 用效果，便于進(jìn)行功能擴(kuò)展、便于調(diào)用者使用、接口在本地和遠(yuǎn)程皆可調(diào)用；本發(fā)明在配置 權(quán)限認(rèn)證中實現(xiàn)了權(quán)限授權(quán)和校驗功能，可以對不同的使用者授予不同的權(quán)限，保證系統(tǒng) 的安全性和可控性。
[0020] 優(yōu)選地，在構(gòu)造基于命名空間的接口體系中，接口通過Iua的module模塊來進(jìn)行 組織，相關(guān)的接口封裝在同一個module模塊中。
[0021] 優(yōu)選地，在配置權(quán)限認(rèn)證中，通過請求域名client, openapi. hiwifi. com直接調(diào) 用被綁定路由器里面的接口成功以后，openapi. hiwifi. com返回一個client_secret，調(diào) 用 client, openapi. hiwifi. com 用此 client_secret 來請求簽名。
[0022] 優(yōu)選地，在配置輸入輸出參數(shù)格式中，輸入?yún)?shù)格式為輸入調(diào)用者的id、調(diào)用者申 請的名字、調(diào)用的設(shè)備MAC地址、調(diào)用的方法名、調(diào)用的接口所需要的參數(shù)，輸出參數(shù)格式 為輸出路由器返回代碼、路由器返回文字描述、路由器對應(yīng)接口返回數(shù)據(jù)、平臺返回代碼、 平臺返回文字描述、平臺返回其他數(shù)據(jù)。
[0023] 優(yōu)選地，在配置輸入輸出參數(shù)格式中，API框架接口調(diào)用格式使用POST方式 提交JSON(JSON(JavaScript Object Notation)是一種輕量級的數(shù)據(jù)交換格式。基于 JavaScript的一個子集。JSON采用完全獨立于語言的文本格式，性使JSON成為理想的數(shù) 據(jù)交換語言。易于人閱讀和編寫，同時也易于機(jī)器解析和生成，網(wǎng)絡(luò)傳輸速度快）格式的請 求數(shù)據(jù)，HTTP header 中的 Content-Type 設(shè)為 application/json，action 包含綁定、解除 綁定、調(diào)用API、獲取狀態(tài)；加密認(rèn)證通過對POST的數(shù)據(jù)算出一個校驗碼sign并作為一個 參數(shù)。
[0024] 以下給出一個具體實施例。
[0025] 這種路由器的接口體