本篇內(nèi)容介紹了“物聯(lián)網(wǎng)接口列表的知識(shí)點(diǎn)有哪些”的有關(guān)知識(shí)，在實(shí)際案例的操作過(guò)程中，不少人都會(huì)遇到這樣的困境，接下來(lái)就讓小編帶領(lǐng)大家學(xué)習(xí)一下如何處理這些情況吧！希望大家仔細(xì)閱讀，能夠?qū)W有所成！

創(chuàng)新互聯(lián)2013年開(kāi)創(chuàng)至今，是專業(yè)互聯(lián)網(wǎng)技術(shù)服務(wù)公司，擁有項(xiàng)目網(wǎng)站設(shè)計(jì)制作、網(wǎng)站設(shè)計(jì)網(wǎng)站策劃，項(xiàng)目實(shí)施與項(xiàng)目整合能力。我們以讓每一個(gè)夢(mèng)想脫穎而出為使命，1280元鐘樓做網(wǎng)站,已為上家服務(wù),為鐘樓各地企業(yè)和個(gè)人服務(wù),聯(lián)系電話:18982081108

接口列表及接口說(shuō)明

授權(quán)管理

• 獲取訪問(wèn)令牌：開(kāi)發(fā)者通過(guò)開(kāi)發(fā)平臺(tái)創(chuàng)建云應(yīng)用對(duì)應(yīng)的授權(quán)憑證獲取令牌。

• 刷新用戶令牌：出于安全考慮，當(dāng)前每個(gè) OAuth token 的有效期為兩小時(shí)，過(guò)期以后需要使用 refresh_token 來(lái)?yè)Q取新的令牌。

說(shuō)明：access_token 有時(shí)間限制，無(wú)次數(shù)限制；而 refresh_token 無(wú)時(shí)間限制，但是只能生效一次。

• 免登錄令牌：根據(jù)涂鴉用戶uid生成免登錄令牌，部分場(chǎng)景或者API接口需要使用此令牌進(jìn)行請(qǐng)求。

用戶管理

• 同步用戶：該接口為賬號(hào)同步接口，您可結(jié)合自己的業(yè)務(wù)場(chǎng)景，根據(jù)不同參數(shù)來(lái)完成賬號(hào)創(chuàng)建和賬號(hào)信息修改。

1. 在同一應(yīng)用下，傳入相同用戶名，則會(huì)更新該用戶上一次的用戶信息。

2. 如需在涂鴉 OEM App 中直接使用，OEM App 當(dāng)前僅支持手機(jī)號(hào)和郵箱地址，且密碼 hash 規(guī)則為 MD5 算法。

• 獲取用戶列表：您在涂鴉 IoT 平臺(tái)創(chuàng)建的應(yīng)用關(guān)聯(lián)到的用戶數(shù)據(jù)，可通過(guò)該 API 完成拉取。考慮到用戶隱私安全，針對(duì)用戶個(gè)人隱私字段，將進(jìn)行加密處理。

• 獲取用戶信息：用來(lái)獲取用戶信息。

配網(wǎng)管理：隨著產(chǎn)品配網(wǎng)方式豐富度的提高，云開(kāi)發(fā)平臺(tái)對(duì)主流配網(wǎng)能力進(jìn)行了迭代，提供了權(quán)限管理接口來(lái)滿足不同配網(wǎng)方式的訴求，例如 Wi-Fi 配網(wǎng)、藍(lán)牙配網(wǎng)、藍(lán)牙 + Wi-Fi 雙模配網(wǎng)等方式。

• 生成配網(wǎng)令牌：發(fā)現(xiàn)設(shè)備之前，需要先申請(qǐng)一個(gè)臨時(shí)令牌，經(jīng)過(guò)涂鴉客戶端 SDK 進(jìn)行配網(wǎng)，設(shè)備接到配網(wǎng)令牌后可自動(dòng)完成發(fā)現(xiàn)和賬號(hào)綁定。當(dāng)前支持 Wi-Fi 配網(wǎng)和 BLE + Wi-Fi 配網(wǎng)方式，更多能力持續(xù)拓展中（BLE 設(shè)備需掃描設(shè)備二維碼獲取設(shè)備唯一 ID 用于配網(wǎng)）。

• 輪詢配網(wǎng)結(jié)果：由于設(shè)備配網(wǎng)是一個(gè)異步流程，根據(jù)網(wǎng)絡(luò)質(zhì)量的不同，設(shè)備成功入網(wǎng)的時(shí)間不定，故需要開(kāi)發(fā)者輪詢?cè)摻涌谥敝敛樵兊皆O(shè)備列表或到超時(shí)停止輪詢（輪詢周期為 1 秒一次，超時(shí)時(shí)間建議為 100 秒）。

• 開(kāi)放網(wǎng)關(guān)允許子設(shè)備入網(wǎng)：由于子設(shè)備不具備直接的聯(lián)網(wǎng)能力，故而添加子設(shè)備需要網(wǎng)關(guān)加入。網(wǎng)關(guān)進(jìn)入允許入網(wǎng)狀態(tài)后，子設(shè)備可以加入網(wǎng)關(guān)的本地網(wǎng)絡(luò)，通過(guò)網(wǎng)關(guān)完成入庫(kù)。

• 獲取入網(wǎng)子設(shè)備列表：子設(shè)備配網(wǎng)是一個(gè)異步流程，配網(wǎng)時(shí)會(huì)根據(jù)設(shè)備數(shù)量以及網(wǎng)絡(luò)情況陸續(xù)將子設(shè)備加入網(wǎng)關(guān)。因此需要根據(jù)初次發(fā)現(xiàn)時(shí)間輪詢此接口獲取子設(shè)備列表，可結(jié)合自身業(yè)務(wù)結(jié)束發(fā)現(xiàn)流程，建議每次輪詢 1 秒直至 100 秒結(jié)束。

• 獲取網(wǎng)關(guān)下的子設(shè)備列表：通過(guò)網(wǎng)關(guān)設(shè)備 ID，獲取子設(shè)備列表。

設(shè)備控制

• 獲取指令集（按品類）：按品類來(lái)查詢指令集，該指令集為涂鴉公版品類下最豐富的指令集，可供開(kāi)發(fā)者參考使用。如果是平臺(tái)類開(kāi)發(fā)者，建議可按照此類進(jìn)行開(kāi)發(fā)對(duì)接。

• 獲取指令集（按設(shè)備）：查詢?cè)O(shè)備支持的功能，獲取到的指令可用于下發(fā)控制。

• 獲取設(shè)備規(guī)格屬性（包含指令集、狀態(tài)集）：根據(jù)設(shè)備 ID 獲取設(shè)備支持的指令集和狀態(tài)集。

• 下發(fā)設(shè)備指令：根據(jù)獲取到的指令集，可按一組或多組指令集進(jìn)行下發(fā)，是否同時(shí)支持多指令同時(shí)執(zhí)行依具體產(chǎn)品而定。

• 獲取設(shè)備最新?tīng)顟B(tài)：根據(jù)設(shè)備 ID 來(lái)查詢?cè)O(shè)備最新?tīng)顟B(tài)。

定時(shí)管理

• 設(shè)備添加定時(shí)任務(wù)：該接口為設(shè)備添加定時(shí)任務(wù)。通過(guò)參數(shù) loops，可分為循環(huán)定時(shí)任務(wù)與非循環(huán)定時(shí)任務(wù)。

1. 循環(huán)定時(shí)：以一周為循環(huán)，可設(shè)定周一到周日的循環(huán)定時(shí)。

2. 非循環(huán)定時(shí)：設(shè)定指定時(shí)間節(jié)點(diǎn)的定時(shí)任務(wù)，接口會(huì)對(duì)設(shè)定的時(shí)間節(jié)點(diǎn)做限定。該時(shí)間節(jié)點(diǎn)需要在當(dāng)前時(shí)間之后，否則無(wú)法創(chuàng)建定時(shí)任務(wù)，并提示定時(shí)任務(wù)已過(guò)期。

• 查詢?cè)O(shè)備下的定時(shí)任務(wù)列表：該接口用于查詢指定設(shè)備 ID 下已添加定時(shí)任務(wù)的詳細(xì)信息列表。

• 獲取設(shè)備某一個(gè)分類下?的定時(shí)任務(wù)信息：該接口用于獲取指定設(shè)備下某?個(gè)分類下?的定時(shí)任務(wù)信息。

• 更新設(shè)備的某?個(gè)定時(shí)任務(wù)組的信息：該接口用于更新設(shè)備的某一個(gè)定時(shí)任務(wù)組的信息。

• 更新/獲取設(shè)備定時(shí)任務(wù)組的狀態(tài)：該接口用于更新/獲取設(shè)備定時(shí)任務(wù)組的狀態(tài)。

• 創(chuàng)建/更新群組定時(shí)任務(wù)：該接口用于創(chuàng)建/更新群組定時(shí)任務(wù)。

全屋管理

• 添加家庭：給?戶添加?個(gè)家庭以及家庭下的房間。

• 修改家庭：修改家庭基礎(chǔ)信息。

• 刪除/查詢家庭：根據(jù)家庭ID刪除/查詢家庭。

• 查詢家庭下的設(shè)備詳情：根據(jù)家庭 ID查詢家庭下的設(shè)備列表。

• 添加房間：根據(jù)家庭ID添加房間

• 修改/刪除/查詢房間：根據(jù)家庭 ID 和房間 ID 修改/刪除/查詢房間。

• 添加家庭成員：給某個(gè)家庭添加家庭成員。

• 設(shè)置成員權(quán)限：為家庭成員設(shè)置管理員和非管理員的角色權(quán)限，修改家庭成員的名字。

• 刪除/查詢家庭成員：刪除/查詢某個(gè)家庭下成員。

• 查詢?戶所在的家庭列表：根據(jù) uid 查詢?戶所在的家庭列表。

• 查詢/新增/修改/刪除家庭下房間內(nèi)的設(shè)備：查詢/新增/修改/刪除家庭下房間內(nèi)的設(shè)備。

場(chǎng)景自動(dòng)化

• 查詢家庭下的場(chǎng)景列表：查詢家庭下的場(chǎng)景列表。

• 查詢默認(rèn)場(chǎng)景圖片列表：查詢默認(rèn)場(chǎng)景圖?列表。

• 觸發(fā)/添加/刪除/修改場(chǎng)景：觸發(fā)執(zhí)/添加/刪除/修改行某個(gè)場(chǎng)景。

• 查詢家庭下支持場(chǎng)景的設(shè)備列表：查詢家庭下支持場(chǎng)景的設(shè)備列表。

• 場(chǎng)景綁定/綁定：接口主要適用于場(chǎng)景開(kāi)關(guān)設(shè)備。場(chǎng)景開(kāi)關(guān)有相應(yīng)的開(kāi)關(guān)按鈕，每個(gè)開(kāi)關(guān)按鈕擁有相應(yīng)的指令。通過(guò)該接口，可以將指定的開(kāi)關(guān)指令與場(chǎng)景進(jìn)行綁定，即場(chǎng)景開(kāi)關(guān)與場(chǎng)景進(jìn)行關(guān)聯(lián)操作。綁定成功后，通過(guò)指令下發(fā)接口，可以直接觸發(fā)場(chǎng)景。

• 場(chǎng)景解綁：接口主要適用于場(chǎng)景開(kāi)關(guān)設(shè)備。場(chǎng)景開(kāi)關(guān)中的某個(gè)開(kāi)關(guān)與指定場(chǎng)景綁定后，可通過(guò)該接口進(jìn)行解綁。

• 查詢?cè)O(shè)備已綁定的場(chǎng)景列表：接口主要適用于場(chǎng)景開(kāi)關(guān)設(shè)備。通過(guò)場(chǎng)景開(kāi)關(guān)設(shè)備 ID，查詢?cè)撛O(shè)備所關(guān)聯(lián)的場(chǎng)景列表。

• 添加/修改/刪除自動(dòng)化：為家庭添加/修改/刪除自動(dòng)化功能。

• 查詢自動(dòng)化列表：查詢自動(dòng)化列表。

• 查詢單個(gè)自動(dòng)化：查詢家庭中單個(gè)自動(dòng)化場(chǎng)景。

• 觸發(fā)自動(dòng)化外部條件：觸發(fā)家庭中自動(dòng)化場(chǎng)景的外部條件。

• 查詢支持自動(dòng)化場(chǎng)景的設(shè)備列表：查詢家庭下支持自動(dòng)化場(chǎng)景的設(shè)備列表。

• 查詢自動(dòng)化場(chǎng)景支持的天氣條件：查詢自動(dòng)化支持的天氣條件。

• 獲取家庭支持的聯(lián)動(dòng)條件：根據(jù)家庭 ID 獲取聯(lián)動(dòng)條件或執(zhí)行動(dòng)作的標(biāo)準(zhǔn)功能點(diǎn)。

• 獲取設(shè)備支持的聯(lián)動(dòng)條件：根據(jù)設(shè)備 ID 獲取聯(lián)動(dòng)條件或執(zhí)行動(dòng)作的標(biāo)準(zhǔn)功能點(diǎn)。

• 啟用/停用自動(dòng)化：?jiǎn)⒂?停用自動(dòng)化場(chǎng)景。

數(shù)據(jù)服務(wù)

• 獲取數(shù)據(jù)總體概況：獲取數(shù)據(jù)總體概況。

• 統(tǒng)計(jì) App 日注冊(cè)用戶數(shù)：統(tǒng)計(jì) App 日注冊(cè)用戶數(shù)。

• 統(tǒng)計(jì) App 日活躍用戶數(shù)：統(tǒng)計(jì) App 日活躍用戶數(shù)。

• 獲取 App 設(shè)備數(shù)據(jù)概況：獲取 App 設(shè)備數(shù)據(jù)概況。

• 獲取設(shè)備總體概況：獲取設(shè)備總體概況。

• 獲取活躍設(shè)備地區(qū)分布數(shù)據(jù)：獲取活躍設(shè)備地區(qū)分布數(shù)據(jù)。

• 獲取激活設(shè)備地區(qū)分布詳情數(shù)據(jù)：獲取激活設(shè)備地區(qū)分布詳情數(shù)據(jù)。

• 統(tǒng)計(jì)設(shè)備日活躍數(shù)/激活數(shù)/共激活數(shù)據(jù)：統(tǒng)計(jì)設(shè)備日活躍數(shù)/激活數(shù)/共激活數(shù)據(jù)。

• 獲取設(shè)備活躍數(shù)據(jù)概況：獲取設(shè)備活躍數(shù)據(jù)概況。

• 獲取歷史累計(jì)值：獲取歷史累計(jì)值。

• 獲取設(shè)備支持的統(tǒng)計(jì)類型：查詢?cè)O(shè)備當(dāng)前支持的統(tǒng)計(jì)類型。

• 按小時(shí)/天/星期/月統(tǒng)計(jì)：以小時(shí)/天/周/月為單位，返回設(shè)備近 7 天的統(tǒng)計(jì)數(shù)據(jù)。

天氣服務(wù)

• 查詢城市列表：根據(jù)國(guó)家碼獲取該國(guó)支持天氣數(shù)據(jù)城市的信息。

• 查詢城市信息：根據(jù)城市ID來(lái)查詢城市信息。

• 根據(jù)經(jīng)緯度查詢城市列表：根據(jù)經(jīng)緯度查詢城市列表。

• 查詢城市天氣預(yù)報(bào)：根據(jù)城市 ID查詢天氣預(yù)報(bào)。

• 根據(jù)IP查詢天氣預(yù)報(bào)：根據(jù)城市 IP 查詢天氣預(yù)報(bào)。

• 根據(jù)經(jīng)緯度查詢天氣：根據(jù)城市經(jīng)緯度來(lái)查詢城市的天氣信息。

• 查詢城市當(dāng)前天氣情況：根據(jù)城市ID查詢城市當(dāng)天天氣情況。

設(shè)備管理

• 獲取設(shè)備詳情：可查詢?cè)O(shè)備的詳情信息，包括設(shè)備屬性和設(shè)備最新?tīng)顟B(tài)。

• 獲取用戶下設(shè)備列表：可查詢用戶下可操作的設(shè)備列表，包括設(shè)備屬性、設(shè)備最新?tīng)顟B(tài)。

• 獲取設(shè)備列表：提供按應(yīng)用、產(chǎn)品、設(shè)備 ID 查詢?cè)O(shè)備列表的能力，調(diào)用該接口時(shí)，建議請(qǐng)求參數(shù)三選一。數(shù)據(jù)權(quán)限維度滿足以下任意一種，則可獲取相關(guān)設(shè)備數(shù)據(jù)：

1. 應(yīng)用維度：應(yīng)用維度針對(duì)于設(shè)備采購(gòu)商。設(shè)備采購(gòu)商通過(guò)將應(yīng)用（在涂鴉平臺(tái)創(chuàng)建的 OEM App 或者基于涂鴉的客戶端 SDK 自行開(kāi)發(fā)）綁定設(shè)備的方式來(lái)獲取設(shè)備的數(shù)據(jù)。

2. 產(chǎn)品維度：產(chǎn)品維度針對(duì)于設(shè)備生產(chǎn)廠商。生產(chǎn)廠商通過(guò)在涂鴉平臺(tái)創(chuàng)建產(chǎn)品，然后基于這個(gè)產(chǎn)品來(lái)生產(chǎn)設(shè)備（設(shè)備連接涂鴉云），最終獲取或管控廠商所生產(chǎn)設(shè)備的數(shù)據(jù)。

• 修改功能點(diǎn)名稱：滿足多路子設(shè)備，可以進(jìn)行子設(shè)備名稱修改。

• 查詢?cè)O(shè)備日志：根據(jù)查詢條件查詢?cè)O(shè)備操作歷史記錄。

• 恢復(fù)設(shè)備出廠設(shè)置：根據(jù)設(shè)備 ID 來(lái)恢復(fù)出廠設(shè)置。

• 移除設(shè)備：根據(jù)設(shè)備 ID 來(lái)移除設(shè)備。

• 查詢網(wǎng)關(guān)下的設(shè)備列表：查詢網(wǎng)關(guān)下的設(shè)備列表。

• 查詢?cè)O(shè)備出廠信息：查詢?cè)O(shè)備出廠信息。

• 修改設(shè)備名稱：修改設(shè)備名稱。

• 修改多路名稱：當(dāng)設(shè)備存在多路名稱時(shí)可修改，現(xiàn)支持排插類設(shè)備。

OTA升級(jí)

• 獲取設(shè)備的升級(jí)信息：獲取設(shè)備的升級(jí)信息。

• 確認(rèn)設(shè)備升級(jí)：確認(rèn)設(shè)備升級(jí)。

設(shè)備群組

• 查詢?cè)O(shè)備群組列表

• 查詢?nèi)航M詳情

• 查詢?nèi)航M列表

• 創(chuàng)建設(shè)備群組

• 修改群組分組

• 刪除群組分組

• 給設(shè)備群組下發(fā)指令

“物聯(lián)網(wǎng)接口列表的知識(shí)點(diǎn)有哪些”的內(nèi)容就介紹到這里了，感謝大家的閱讀。如果想了解更多行業(yè)相關(guān)的知識(shí)可以關(guān)注創(chuàng)新互聯(lián)網(wǎng)站，小編將為大家輸出更多高質(zhì)量的實(shí)用文章！

當(dāng)前標(biāo)題：物聯(lián)網(wǎng)接口列表的知識(shí)點(diǎn)有哪些
文章轉(zhuǎn)載：http://m.newbst.com/article42/gsoshc.html

成都網(wǎng)站建設(shè)公司_創(chuàng)新互聯(lián)，為您提供云服務(wù)器、網(wǎng)站維護(hù)、外貿(mào)網(wǎng)站建設(shè)、、做網(wǎng)站、虛擬主機(jī)

廣告

聲明：本網(wǎng)站發(fā)布的內(nèi)容（圖片、視頻和文字）以用戶投稿、用戶轉(zhuǎn)載內(nèi)容為主，如果涉及侵權(quán)請(qǐng)盡快告知，我們將會(huì)在第一時(shí)間刪除。文章觀點(diǎn)不代表本網(wǎng)站立場(chǎng)，如需處理請(qǐng)聯(lián)系客服。電話：028-86922220；郵箱：631063699@qq.com。內(nèi)容未經(jīng)允許不得轉(zhuǎn)載，或轉(zhuǎn)載時(shí)需注明來(lái)源： 創(chuàng)新互聯(lián)