如何使用HTTP連線到QNAP QIoT Suite Lite @ 觀察筆記

本文章將介紹如何使用HTTP連線到QNAP QIoT Suite Lite

如需其他QIoT Suite Lite連接到不同開發版的部分可參考:
https://www.qnap.com/go/how-to/tutorial/qiot-suite-lite

關於如何建立IoT Applaction及Thing部分，可參考:
https://www.qnap.com/go/how-to/tutorial/article/how-to-show-dht11-data-on-qiot-dashboard

另外，您也可以到QNAP GitHub 參考其他程式範例: https://github.com/qnap-dev/qnap-qiot-sdks

開啟IoT Application取得HTTP連線設定檔

打開IoT應用並進入IoT 裝置頁面
選擇您要設定連線的IoT 裝置，點選 “連接裝置" 按鈕
選擇 “HTTP"並點選 “下一頁"
選擇 “下載JSON檔案"，下載的檔名為"resourceinfo.json"

* 更多關於resourceinfo.json資訊
下面為resourceinfo.json的範例:

	
			1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38

			         <span class="pun">{</span>
 
           <span class="str">"accesstoken"</span><span class="pun">:</span> <span class="str">"r:e91d53d57729b9d0b59772f9f2a130dc"</span><span class="pun">,</span>
 
           <span class="str">"myqnapcloudHost"</span><span class="pun">:</span> <span class="str">"Not Available"</span><span class="pun">,</span>
 
           <span class="str">"clientId"</span><span class="pun">:</span>  <span class="str">"rpi2_1509001699"</span><span class="pun">,</span>
 
           <span class="str">"host"</span><span class="pun">:</span> <span class="pun">[</span>
 
           <span class="str">"172.17.28.73"</span>
 
                <span class="pun">],</span>
 
                <span class="str">"requesterid"</span><span class="pun">:</span>  <span class="str">"c08b5979-1f8f-42da-9085-d761707be65c"</span><span class="pun">,</span>
 
                <span class="str">"port"</span><span class="pun">:</span> <span class="lit">23000</span><span class="pun">,</span>
 
                <span class="str">"resources"</span><span class="pun">:</span> <span class="pun">[</span>
            <span class="pun">{</span>
 
                        <span class="str">"description"</span><span class="pun">:</span>  <span class="str">""</span><span class="pun">,</span>
 
                        <span class="str">"datatype"</span><span class="pun">:</span>  <span class="str">"Float"</span><span class="pun">,</span>
 
                        <span class="str">"resourceid"</span><span class="pun">:</span>  <span class="str">"temp"</span><span class="pun">,</span>
 
                        <span class="str">"topic"</span><span class="pun">:</span>  <span class="str">"qiot/things/admin/rpi2/temp"</span><span class="pun">,</span>
 
                        <span class="str">"resourcename"</span><span class="pun">:</span>  <span class="str">"temp"</span><span class="pun">,</span>
 
                        <span class="str">"resourcetypename"</span><span class="pun">:</span>  <span class="str">"Temperature"</span><span class="pun">,</span>
 
                        <span class="str">"unit"</span><span class="pun">:</span> <span class="str">"°C"</span>
 
   <span class="pun">}</span>
<span class="pun">]</span>
<span class="pun">}</span>

		

參考:
1. “accesstoken" : HTTP header需帶入Access-Token的值
2. “myqnapcloudHost": 顯示您是否連接上myqnapcloud DDNS服務，若連結上將會顯示hostname。(如果您有關於port轉發之設定問題，可以參考: https://qiot.qnap.com/blog/en/2017/09/21/solve-problem-using-different-port-qiot-suite-lite-v1-0-41/
3. “clientId": QIoT給予device端的ID
4. “host": Nas的IP
5. “requesterid" : HTTP header需帶入RequesterId 的值
6. “port": HTTP的通訊埠
7. “resources":resource資訊，包含以下:
  - description: QIoT資源的說明
  - datatype: QIoT資源的資料格式
  - resourceid: QIoT資源的資源ID
  - topic: HTTP發布及接收資料路徑
  - resourcename: QIoT資源名稱
  - resourcetypename: QIoT資源型態名稱
  - unit: QIoT資源的單位
連線格式:
“發布":
- method: PUT
- path: /resources/<topic>
- Header:
  - Access-Token : <accesstoken>
  - RequesterId : <requesterid>
  - Content-Type : application/json
- body:
  - {“value" : <data>}
“接收":
- method: GET
- path: /resources/<topic>
- header :
  - Access-Token : <accesstoken>
  - RequesterId : <requesterid>
  - Content-Type : application/json