基于調(diào)試軟件的HTTP協(xié)議調(diào)試物聯(lián)網(wǎng)云平臺(tái)開發(fā)實(shí)踐（第2版）目錄CONTENTS01新建產(chǎn)品和設(shè)備02安裝調(diào)試軟件03屬性上報(bào)04事件上報(bào)

第一部分

新建產(chǎn)品和設(shè)備PART0101實(shí)驗(yàn)一新建產(chǎn)品和設(shè)備【實(shí)驗(yàn)?zāi)康摹?/p>

（1）掌握HTTP協(xié)議的產(chǎn)品、設(shè)備創(chuàng)建流程。

（2）掌握整個(gè)流程中各類信息的解讀?！緦?shí)驗(yàn)設(shè)備】

（1）一臺(tái)PC，可連接Internet。

【實(shí)驗(yàn)要求】

在OneNET平臺(tái)注冊(cè)HTTP產(chǎn)品，在該產(chǎn)品下注冊(cè)設(shè)備?！緦?shí)驗(yàn)步驟】一、新建HTTP產(chǎn)品

（1）登錄OneNET平臺(tái)，進(jìn)入開發(fā)者中心，單擊左側(cè)“產(chǎn)品開發(fā)”。

（2）單擊“創(chuàng)建產(chǎn)品”按鈕，并填寫相關(guān)信息。選定產(chǎn)品品類后，智能化方式選擇“設(shè)備接入”，該選項(xiàng)提供設(shè)備開發(fā)、設(shè)備測(cè)試、數(shù)據(jù)推送等功能，可以快速完成產(chǎn)品接入物聯(lián)網(wǎng)平臺(tái)。進(jìn)一步填寫產(chǎn)品名稱、所屬城市、節(jié)點(diǎn)類型、接入?yún)f(xié)議、數(shù)據(jù)協(xié)議、聯(lián)網(wǎng)方式、開發(fā)方案等一系列信息。

接入?yún)f(xié)議選擇HTTP，數(shù)據(jù)協(xié)議選擇OneJson。（3）記錄新建產(chǎn)品的產(chǎn)品ID。

實(shí)驗(yàn)一新建產(chǎn)品和設(shè)備二、新建HTTP設(shè)備

（1）在同一類產(chǎn)品下，可以添加多個(gè)設(shè)備，并且每個(gè)設(shè)備都將與一個(gè)實(shí)際設(shè)備相對(duì)應(yīng)。如圖所示，單擊“設(shè)備管理”標(biāo)簽，在出現(xiàn)的界面中，添加HTTP設(shè)備,并填寫設(shè)備名稱。實(shí)驗(yàn)一新建產(chǎn)品和設(shè)備二、新建HTTP設(shè)備

（2）單擊詳情，查看如圖所示的設(shè)備相關(guān)信息，包括產(chǎn)品ID、設(shè)備名稱、設(shè)備密鑰等，這些信息將用于Token計(jì)算。實(shí)驗(yàn)一新建產(chǎn)品和設(shè)備（1）選擇新建的HTTP產(chǎn)品，單擊該產(chǎn)品對(duì)應(yīng)的“產(chǎn)品開發(fā)”標(biāo)簽，在出現(xiàn)的界面中單擊“設(shè)置物模型”。

（2）如圖，在出現(xiàn)的界面中，單擊添加自定義功能點(diǎn)。

實(shí)驗(yàn)一新建產(chǎn)品和設(shè)備三、功能定義

HTTP協(xié)議同樣基于物模型進(jìn)行開發(fā)，在使用過程中，需要先定義物模型，再進(jìn)行功能定義，具體步驟如下。

（3）如圖所示，添加功能類型為屬性類型的功能點(diǎn)“溫度”并保存。定義功能點(diǎn)時(shí)，需要選擇功能類型、填寫功能名稱、標(biāo)識(shí)符、數(shù)據(jù)類型、取值范圍、讀寫類型等參數(shù)。其中，標(biāo)識(shí)符不能包含中文字符。這兩個(gè)功能點(diǎn)可以用來記錄運(yùn)行過程中產(chǎn)生的數(shù)據(jù)，讀寫類型可以設(shè)置為讀寫。

三、功能定義

實(shí)驗(yàn)一新建產(chǎn)品和設(shè)備三、功能定義

實(shí)驗(yàn)一新建產(chǎn)品和設(shè)備（4）如圖所示，添加功能類型為服務(wù)類型的功能點(diǎn)，名稱為“控制LED”，調(diào)用方式為同步，輸入?yún)?shù)名稱為L(zhǎng)ED。標(biāo)識(shí)符為功能點(diǎn)唯一標(biāo)識(shí)符，單個(gè)產(chǎn)品下唯一，也是后續(xù)調(diào)用服務(wù)時(shí)對(duì)應(yīng)的identifier參數(shù)。三、功能定義

實(shí)驗(yàn)一新建產(chǎn)品和設(shè)備（5）除了屬性類型和服務(wù)類型，功能類型還包含事件類型。如圖4-12所示，添加功能類型為事件類型的功能點(diǎn)“高溫預(yù)警”，標(biāo)識(shí)符為“Heat”并保存，輸出參數(shù)為Temperature。

三、功能定義

實(shí)驗(yàn)一新建產(chǎn)品和設(shè)備（6）填寫完畢后，出現(xiàn)如圖所示的信息頁面。PART0202

第二部分

安裝調(diào)試軟件實(shí)驗(yàn)二安裝調(diào)試軟件【實(shí)驗(yàn)?zāi)康摹?/p>

（1）掌握Apifox的安裝流程。

（2）掌握軟件的設(shè)置方法。

【實(shí)驗(yàn)設(shè)備】

（1）一臺(tái)PC，可連接Internet。

（2）Apifox軟件安裝包。

【實(shí)驗(yàn)要求】

安裝完成Apifox調(diào)試軟件，并熟悉軟件頁面。

【實(shí)驗(yàn)步驟】

一、軟件下載

安裝包的下載地址為/。進(jìn)入該網(wǎng)站后，下載對(duì)應(yīng)的軟件版本并安裝。

實(shí)驗(yàn)二安裝調(diào)試軟件實(shí)驗(yàn)二安裝調(diào)試軟件二、軟件界面

打開軟件，掃碼進(jìn)入，可以看到如圖所示的軟件頁面。單擊快捷請(qǐng)求進(jìn)入HTTP協(xié)議調(diào)試界面。實(shí)驗(yàn)二安裝調(diào)試軟件二、軟件界面

在調(diào)試界面中，可以通過下拉菜單選擇GET、POST、PUT、DELETE等請(qǐng)求方式，分別實(shí)現(xiàn)查詢、新建、更新、刪除等操作。在右側(cè)輸入U(xiǎn)RL。下方菜單欄為相應(yīng)的請(qǐng)求頭Headers、請(qǐng)求主體Body等。請(qǐng)求主體可以使用多種格式，本項(xiàng)目主要采用json格式。

PART0303

第三部分

屬性上報(bào)實(shí)驗(yàn)三屬性上報(bào)【實(shí)驗(yàn)?zāi)康摹?/p>

（1）掌握HTTP協(xié)議屬性上報(bào)的流程。

（2）掌握整個(gè)流程中各類信息的解讀。【實(shí)驗(yàn)設(shè)備】

（1）一臺(tái)PC，可連接Internet。

（2）Postman軟件。

【實(shí)驗(yàn)要求】

在實(shí)驗(yàn)一創(chuàng)建的HTTP設(shè)備下，設(shè)置物模型，自定義名稱為溫度的屬性功能點(diǎn)，采用Postman軟件實(shí)現(xiàn)設(shè)備屬性上報(bào)。實(shí)驗(yàn)三屬性上報(bào)【實(shí)驗(yàn)步驟】

一、查詢物模型topic在“產(chǎn)品開發(fā)”——“設(shè)備開發(fā)”頁面，單擊“Topic管理”，再單擊“物模型topic”，可以查看該設(shè)備所有Topic權(quán)限和用途等信息，如圖所示。

實(shí)驗(yàn)三屬性上報(bào)二、配置起始行

打開Apifox軟件，單擊快捷請(qǐng)求，進(jìn)入請(qǐng)求頁面。實(shí)驗(yàn)三屬性上報(bào)二、配置起始行

在如圖所示的界面中，選擇請(qǐng)求方式POST，在右側(cè)的框內(nèi)填寫URL，具體如下：/fuse/http/device/thing/property/post?topic=$sys/{pid}/{device-name}/thing/property/post&protocol=http其中{pid}用產(chǎn)品ID替換，{device-name}用設(shè)備名稱替換。其中，還包含了topic和protocol信息，topic為$sys/{pid}/{device-name}/thing/property/post，與物模型topic一致，protocol為http。輸入U(xiǎn)RL后，軟件自動(dòng)解析topic和protocol，并將其作為Params參數(shù)。實(shí)驗(yàn)三屬性上報(bào)二、配置請(qǐng)求頭

單擊Headers，在參數(shù)名的下方添加Token，在示例值的下方填寫Token。Token的計(jì)算方法與MQTT協(xié)議中Token的計(jì)算方法一致。

實(shí)驗(yàn)三屬性上報(bào)二、配置請(qǐng)求頭

請(qǐng)求頭參數(shù)有10個(gè)，其中隱藏了9個(gè)參數(shù)，隱藏參數(shù)如圖所示，這部分內(nèi)容不需要修改，部分參數(shù)如User-Agent為軟件自動(dòng)生成，部分參數(shù)如Host等則根據(jù)填寫的URL分析生成。三、填寫請(qǐng)求主體

單擊Body，填寫請(qǐng)求主體，

具體形式如下：{"id":"123","version":"1.0","params":{“Temp":{"value":0}}}實(shí)驗(yàn)三屬性上報(bào)四、結(jié)果查詢

單擊發(fā)送按鍵發(fā)送請(qǐng)求，得到如圖所示的結(jié)果。

實(shí)驗(yàn)三屬性上報(bào)其中，errno為0，error為succ，表示屬性上傳成功。

打開OneNET平臺(tái)，單擊“設(shè)備管理”，進(jìn)入“屬性”頁面，可以看到功能名稱為“溫度”的屬性新增了數(shù)據(jù)0。五、常見反饋代碼

OneNET技術(shù)文檔中，給出了錯(cuò)誤碼和對(duì)應(yīng)描述，具體如表所示。實(shí)驗(yàn)三屬性上報(bào)PART0404

第四部分

事件上報(bào)實(shí)驗(yàn)四事件上報(bào)【實(shí)驗(yàn)?zāi)康摹?/p>

（1）掌握HTTP協(xié)議事件上報(bào)的流程。

（2）掌握整個(gè)流程中各類信息的解讀。

【實(shí)驗(yàn)設(shè)備】

（1）一臺(tái)PC，可連接Internet。

（2）Apifox軟件。

【實(shí)驗(yàn)要求】

在實(shí)驗(yàn)一創(chuàng)建的HTTP設(shè)備下，查找自定義名稱為“高溫預(yù)警”的事件功能點(diǎn)，采用Apifox軟件實(shí)現(xiàn)設(shè)備事件上報(bào)。

實(shí)驗(yàn)四事件上報(bào)【實(shí)驗(yàn)步驟】

一、配置起始行

打開Apifox軟件，單擊快捷請(qǐng)求，進(jìn)入請(qǐng)求頁面。在如圖所示的界面中，選擇請(qǐng)求方式POST，在右側(cè)的框內(nèi)填寫URL，具體如下：

/fuse/http/device/thing/event/post?topic=$sys/{pid}/{device-name}/thing/event/post&protocol=http其中{pid}用產(chǎn)品ID替換，{device-name}用設(shè)備名稱替換。二、配置請(qǐng)求頭

單擊Headers，在參數(shù)名的下發(fā)添加Token，在示例值的下方填寫Token。Token的計(jì)算方法與MQTT協(xié)議中Token的計(jì)算方法一致。

三、填寫請(qǐng)求主體

如圖所示，單擊Body，填寫請(qǐng)求主體，實(shí)驗(yàn)四事件上報(bào)四、結(jié)果查詢