塗鴉物聯網足跡塗鴉雲平台介面列表

前序系列文章

>>>

【塗鴉物聯網足跡】塗鴉雲平台介面說明

我們系列文章，都會圍繞如何完成一款智慧型「隔空接吻機」的開發。希望能幫到各異地戀

or異國戀的情侶們！

本文我們會大概講解api介面列表~

介面列表及介面說明

授權管理

說明：access_token 有時間限制，無次數限制；而 refresh_token 無時間限制，但是只能生效一次。

使用者管理

在同一應用下，傳入相同使用者名稱，則會更新該使用者上一次的使用者資訊。

配網管理：隨著產品配網方式豐富度的提高，雲開發平台對主流配網能力進行了迭代，提供了許可權管理介面來滿足不同配網方式的訴求，例如 wi-fi 配網、藍芽配網、藍芽 + wi-fi 雙模配網等方式。

輪詢配網結果：由於裝置配網是乙個非同步流程，根據網路質量的不同，裝置成功入網的時間不定，故需要開發者輪詢該介面直至查詢到裝置列表或到超時停止輪詢（輪詢週期為 1 秒一次，超時時間建議為 100 秒）。

開放閘道器允許子裝置入網：由於子裝置不具備直接的聯網能力，故而新增子裝置需要閘道器加入。閘道器進入允許入網狀態後，子裝置可以加入閘道器的本地網路，通過閘道器完成入庫。

獲取入網子裝置列表：子裝置配網是乙個非同步流程，配網時會根據裝置數量以及網路情況陸續將子裝置加入閘道器。因此需要根據初次發現時間輪詢此介面獲取子裝置列表，可結合自身業務結束發現流程，建議每次輪詢 1 秒直至 100 秒結束。

獲取閘道器下的子裝置列表：通過閘道器裝置 id，獲取子裝置列表。

裝置控制

獲取指令集（按裝置）：查詢裝置支援的功能，獲取到的指令可用於下發控制。

獲取裝置規格屬性（包含指令集、狀態集）：根據裝置 id 獲取裝置支援的指令集和狀態集。

下發裝置指令：根據獲取到的指令集，可按一組或多組指令集進行下發，是否同時支援多指令同時執行依具體產品而定。

獲取裝置最新狀態：根據裝置 id 來查詢裝置最新狀態。

定時管理

迴圈定時：以一周為迴圈，可設定周一到週日的迴圈定時。

非迴圈定時：設定指定時間節點的定時任務，介面會對設定的時間節點做限定。該時間節點需要在當前時間之後，否則無法建立定時任務，並提示定時任務已過期。

全屋管理

場景自動化

資料服務

天氣服務

裝置管理

ota公升級

裝置群組

塗鴉物聯網足跡 塗鴉雲平台介面列表