本篇內(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)至今,是專(zhuān)業(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)系電話(huà):18982081108
接口列表及接口說(shuō)明
授權(quán)管理
獲取訪問(wèn)令牌:開(kāi)發(fā)者通過(guò)開(kāi)發(fā)平臺(tái)創(chuàng)建云應(yīng)用對(duì)應(yīng)的授權(quán)憑證獲取令牌。
刷新用戶(hù)令牌:出于安全考慮,當(dāng)前每個(gè) OAuth token 的有效期為兩小時(shí),過(guò)期以后需要使用 refresh_token 來(lái)?yè)Q取新的令牌。
說(shuō)明:access_token 有時(shí)間限制,無(wú)次數(shù)限制;而 refresh_token 無(wú)時(shí)間限制,但是只能生效一次。
免登錄令牌:根據(jù)涂鴉用戶(hù)uid生成免登錄令牌,部分場(chǎng)景或者API接口需要使用此令牌進(jìn)行請(qǐng)求。
用戶(hù)管理
同步用戶(hù):該接口為賬號(hào)同步接口,您可結(jié)合自己的業(yè)務(wù)場(chǎng)景,根據(jù)不同參數(shù)來(lái)完成賬號(hào)創(chuàng)建和賬號(hào)信息修改。
在同一應(yīng)用下,傳入相同用戶(hù)名,則會(huì)更新該用戶(hù)上一次的用戶(hù)信息。
如需在涂鴉 OEM App 中直接使用,OEM App 當(dāng)前僅支持手機(jī)號(hào)和郵箱地址,且密碼 hash 規(guī)則為 MD5 算法。
獲取用戶(hù)列表:您在涂鴉 IoT 平臺(tái)創(chuàng)建的應(yīng)用關(guān)聯(lián)到的用戶(hù)數(shù)據(jù),可通過(guò)該 API 完成拉取。考慮到用戶(hù)隱私安全,針對(duì)用戶(hù)個(gè)人隱私字段,將進(jìn)行加密處理。
獲取用戶(hù)信息:用來(lái)獲取用戶(hù)信息。
配網(wǎng)管理:隨著產(chǎn)品配網(wǎng)方式豐富度的提高,云開(kāi)發(fā)平臺(tái)對(duì)主流配網(wǎng)能力進(jìn)行了迭代,提供了權(quán)限管理接口來(lái)滿(mǎn)足不同配網(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ò)涂鴉客戶(hù)端 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))。
輪詢(xún)配網(wǎng)結(jié)果:由于設(shè)備配網(wǎng)是一個(gè)異步流程,根據(jù)網(wǎng)絡(luò)質(zhì)量的不同,設(shè)備成功入網(wǎng)的時(shí)間不定,故需要開(kāi)發(fā)者輪詢(xún)?cè)摻涌谥敝敛樵?xún)到設(shè)備列表或到超時(shí)停止輪詢(xún)(輪詢(xún)周期為 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í)間輪詢(xún)此接口獲取子設(shè)備列表,可結(jié)合自身業(yè)務(wù)結(jié)束發(fā)現(xiàn)流程,建議每次輪詢(xún) 1 秒直至 100 秒結(jié)束。
獲取網(wǎng)關(guān)下的子設(shè)備列表:通過(guò)網(wǎng)關(guān)設(shè)備 ID,獲取子設(shè)備列表。
設(shè)備控制
獲取指令集(按品類(lèi)):按品類(lèi)來(lái)查詢(xún)指令集,該指令集為涂鴉公版品類(lèi)下最豐富的指令集,可供開(kāi)發(fā)者參考使用。如果是平臺(tái)類(lèi)開(kāi)發(fā)者,建議可按照此類(lèi)進(jìn)行開(kāi)發(fā)對(duì)接。
獲取指令集(按設(shè)備):查詢(xún)?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)查詢(xún)?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ù)。
循環(huán)定時(shí):以一周為循環(huán),可設(shè)定周一到周日的循環(huán)定時(shí)。
非循環(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ò)期。
查詢(xún)?cè)O(shè)備下的定時(shí)任務(wù)列表:該接口用于查詢(xún)指定設(shè)備 ID 下已添加定時(shí)任務(wù)的詳細(xì)信息列表。
獲取設(shè)備某一個(gè)分類(lèi)下?的定時(shí)任務(wù)信息:該接口用于獲取指定設(shè)備下某?個(gè)分類(lèi)下?的定時(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ù)。
全屋管理
添加家庭:給?戶(hù)添加?個(gè)家庭以及家庭下的房間。
修改家庭:修改家庭基礎(chǔ)信息。
刪除/查詢(xún)家庭:根據(jù)家庭ID刪除/查詢(xún)家庭。
查詢(xún)家庭下的設(shè)備詳情:根據(jù)家庭 ID查詢(xún)家庭下的設(shè)備列表。
添加房間:根據(jù)家庭ID添加房間
修改/刪除/查詢(xún)房間:根據(jù)家庭 ID 和房間 ID 修改/刪除/查詢(xún)房間。
添加家庭成員:給某個(gè)家庭添加家庭成員。
設(shè)置成員權(quán)限:為家庭成員設(shè)置管理員和非管理員的角色權(quán)限,修改家庭成員的名字。
刪除/查詢(xún)家庭成員:刪除/查詢(xún)某個(gè)家庭下成員。
查詢(xún)?戶(hù)所在的家庭列表:根據(jù) uid 查詢(xún)?戶(hù)所在的家庭列表。
查詢(xún)/新增/修改/刪除家庭下房間內(nèi)的設(shè)備:查詢(xún)/新增/修改/刪除家庭下房間內(nèi)的設(shè)備。
場(chǎng)景自動(dòng)化
查詢(xún)家庭下的場(chǎng)景列表:查詢(xún)家庭下的場(chǎng)景列表。
查詢(xún)默認(rèn)場(chǎng)景圖片列表:查詢(xún)默認(rèn)場(chǎng)景圖?列表。
觸發(fā)/添加/刪除/修改場(chǎng)景:觸發(fā)執(zhí)/添加/刪除/修改行某個(gè)場(chǎng)景。
查詢(xún)家庭下支持場(chǎng)景的設(shè)備列表:查詢(xún)家庭下支持場(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)行解綁。
查詢(xún)?cè)O(shè)備已綁定的場(chǎng)景列表:接口主要適用于場(chǎng)景開(kāi)關(guān)設(shè)備。通過(guò)場(chǎng)景開(kāi)關(guān)設(shè)備 ID,查詢(xún)?cè)撛O(shè)備所關(guān)聯(lián)的場(chǎng)景列表。
添加/修改/刪除自動(dòng)化:為家庭添加/修改/刪除自動(dòng)化功能。
查詢(xún)自動(dòng)化列表:查詢(xún)自動(dòng)化列表。
查詢(xún)單個(gè)自動(dòng)化:查詢(xún)家庭中單個(gè)自動(dòng)化場(chǎng)景。
觸發(fā)自動(dòng)化外部條件:觸發(fā)家庭中自動(dòng)化場(chǎng)景的外部條件。
查詢(xún)支持自動(dòng)化場(chǎng)景的設(shè)備列表:查詢(xún)家庭下支持自動(dòng)化場(chǎng)景的設(shè)備列表。
查詢(xún)自動(dòng)化場(chǎng)景支持的天氣條件:查詢(xún)自動(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è)用戶(hù)數(shù):統(tǒng)計(jì) App 日注冊(cè)用戶(hù)數(shù)。
統(tǒng)計(jì) App 日活躍用戶(hù)數(shù):統(tǒng)計(jì) App 日活躍用戶(hù)數(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ì)類(lèi)型:查詢(xún)?cè)O(shè)備當(dāng)前支持的統(tǒng)計(jì)類(lèi)型。
按小時(shí)/天/星期/月統(tǒng)計(jì):以小時(shí)/天/周/月為單位,返回設(shè)備近 7 天的統(tǒng)計(jì)數(shù)據(jù)。
天氣服務(wù)
查詢(xún)城市列表:根據(jù)國(guó)家碼獲取該國(guó)支持天氣數(shù)據(jù)城市的信息。
查詢(xún)城市信息:根據(jù)城市ID來(lái)查詢(xún)城市信息。
根據(jù)經(jīng)緯度查詢(xún)城市列表:根據(jù)經(jīng)緯度查詢(xún)城市列表。
查詢(xún)城市天氣預(yù)報(bào):根據(jù)城市 ID查詢(xún)天氣預(yù)報(bào)。
根據(jù)IP查詢(xún)天氣預(yù)報(bào):根據(jù)城市 IP 查詢(xún)天氣預(yù)報(bào)。
根據(jù)經(jīng)緯度查詢(xún)天氣:根據(jù)城市經(jīng)緯度來(lái)查詢(xún)城市的天氣信息。
查詢(xún)城市當(dāng)前天氣情況:根據(jù)城市ID查詢(xún)城市當(dāng)天天氣情況。
設(shè)備管理
獲取設(shè)備詳情:可查詢(xún)?cè)O(shè)備的詳情信息,包括設(shè)備屬性和設(shè)備最新?tīng)顟B(tài)。
獲取用戶(hù)下設(shè)備列表:可查詢(xún)用戶(hù)下可操作的設(shè)備列表,包括設(shè)備屬性、設(shè)備最新?tīng)顟B(tài)。
獲取設(shè)備列表:提供按應(yīng)用、產(chǎn)品、設(shè)備 ID 查詢(xún)?cè)O(shè)備列表的能力,調(diào)用該接口時(shí),建議請(qǐng)求參數(shù)三選一。數(shù)據(jù)權(quán)限維度滿(mǎn)足以下任意一種,則可獲取相關(guān)設(shè)備數(shù)據(jù):
應(yīng)用維度:應(yīng)用維度針對(duì)于設(shè)備采購(gòu)商。設(shè)備采購(gòu)商通過(guò)將應(yīng)用(在涂鴉平臺(tái)創(chuàng)建的 OEM App 或者基于涂鴉的客戶(hù)端 SDK 自行開(kāi)發(fā))綁定設(shè)備的方式來(lái)獲取設(shè)備的數(shù)據(jù)。
產(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)名稱(chēng):滿(mǎn)足多路子設(shè)備,可以進(jìn)行子設(shè)備名稱(chēng)修改。
查詢(xún)?cè)O(shè)備日志:根據(jù)查詢(xún)條件查詢(xún)?cè)O(shè)備操作歷史記錄。
恢復(fù)設(shè)備出廠設(shè)置:根據(jù)設(shè)備 ID 來(lái)恢復(fù)出廠設(shè)置。
移除設(shè)備:根據(jù)設(shè)備 ID 來(lái)移除設(shè)備。
查詢(xún)網(wǎng)關(guān)下的設(shè)備列表:查詢(xún)網(wǎng)關(guān)下的設(shè)備列表。
查詢(xún)?cè)O(shè)備出廠信息:查詢(xún)?cè)O(shè)備出廠信息。
修改設(shè)備名稱(chēng):修改設(shè)備名稱(chēng)。
修改多路名稱(chēng):當(dāng)設(shè)備存在多路名稱(chēng)時(shí)可修改,現(xiàn)支持排插類(lèi)設(shè)備。
OTA升級(jí)
獲取設(shè)備的升級(jí)信息:獲取設(shè)備的升級(jí)信息。
確認(rèn)設(shè)備升級(jí):確認(rèn)設(shè)備升級(jí)。
設(shè)備群組
查詢(xún)?cè)O(shè)備群組列表
查詢(xún)?nèi)航M詳情
查詢(xún)?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://redsoil1982.com.cn/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)容(圖片、視頻和文字)以用戶(hù)投稿、用戶(hù)轉(zhuǎn)載內(nèi)容為主,如果涉及侵權(quán)請(qǐng)盡快告知,我們將會(huì)在第一時(shí)間刪除。文章觀點(diǎn)不代表本網(wǎng)站立場(chǎng),如需處理請(qǐng)聯(lián)系客服。電話(huà):028-86922220;郵箱:631063699@qq.com。內(nèi)容未經(jīng)允許不得轉(zhuǎn)載,或轉(zhuǎn)載時(shí)需注明來(lái)源: 創(chuàng)新互聯(lián)