使用GizwitsOpenAPI,快速開發輕應用

2022-02-14 02:10:10 字數 1684 閱讀 7349

機智雲是乙個開放的物聯網裝置平台,它為企業和個人開發者提供裝置接入、使用者賬號管理、使用者與裝置繫結管理、裝置遠端監控、定時任務以及裝置高階資料等服務。

這些資料都是儲存在機智雲的資料庫中的。那麼作為開發者,如何去訪問這些資料呢?

open api 就是機智雲對外提供這些資料的訪問介面!

根據機智雲提供的服務,open api 提供如下功能:

機智雲 open api 是 restful 風格的 http api,您可以使用任何標準的 http 客戶端訪問機智雲 open api。

各種程式語言一般都有現成的 http 客戶端可以使用。

x-gizwits-user-token 簡稱 usertoken,它代表著介面呼叫中的使用者上下文。

usertoken 具有有效期,預設為 7 天。

可以通過使用者註冊或者登入介面獲取 usertoken,返回欄位中的 token 就是 usertoken,expire_at 表示 usertoken 過期的時間戳:

每次登入可以獲取乙個新的 usertoken,新舊 usertoken 都可以使用。

因為機智雲 open api 大多數的介面都是與使用者相關的,所以一般的介面呼叫順序如下:

下面以使用者登入為例,說明 api 除錯工具的使用:

介面右邊有個紅色嘆號,點選後彈出對話方塊,提示需要輸入的頭部資訊

頁面自動重新整理,並且嘆號變成藍色,表示需要輸入的頭部資訊已填寫(已填寫並不一定表示值是正確的,如果值錯誤,會反應在介面返回內容中)

在引數輸入框中輸入引數值(點選引數右邊的 example value 黃色框框,可以快速輸入示例 json)

點選 「試一下」 按鈕,即可完成介面呼叫

介面呼叫完成,會顯示本地呼叫等效的 curl 語句,請求 url,響應體,響應碼和響應頭

下面對各分類介面的典型呼叫場景進行說明。

有以下幾種方式可以註冊使用者:

todo

簡訊驗證碼的主要用途有:

獲取簡訊驗證碼有兩種方式,一種不需要驗證碼,一種需要驗證碼,您可以根據實際的應用場景選擇兩種不同的方法。

不需要驗證碼

需要驗證碼

校驗簡訊驗證碼

手機號使用者註冊和重置密碼時,您不需要也不能去驗證簡訊驗證碼,只需要將使用者輸入的簡訊驗證碼傳入對應介面,機智雲會自動進行校驗。

簡訊驗證碼正確校驗後立即失效,預設有效期為 24 小時。

注意:匿名使用者和第三方登入使用者呼叫使用者註冊介面進行登入。

您可以修改以下使用者資訊:

該介面可以獲取使用者詳細資訊。

手機號使用者重置密碼需要先獲取簡訊驗證碼。

可以通過一下兩種方式繫結裝置:

通過 product_key 和 mac 位址繫結裝置

通過***繫結裝置

***生成

todo

繫結裝置

使用者可以對繫結的裝置修改別名和備註。

同乙個裝置被多個使用者繫結,每個使用者都可以對該裝置設定別名和備註,互不衝突。

第乙個繫結裝置的使用者對裝置具有控制權,稱為裝置 owner,owner 可以將裝置分享給其他裝置。被分享的使用者稱為 guest。

owner 分享裝置之後,可以隨時取消分享,或者解綁 guest 對裝置的繫結。

guest 也可以主動解綁裝置。

裝置分享的主要有兩種方式:

guest 將會收到一條裝置分享訊息

owner 和 guest 都將收到一條裝置分享訊息

使用GraphEdit使用

1 註冊元件。其實乙個filter就是乙個com元件,所以使用之前需要註冊,可以有兩種方法對元件進行註冊。1.直接使用命令。命令列下輸入 regsvr32 hqtlystd.ax 編譯之後你會在工程目錄下的debug中找到hqtlystd.ax,這個就是要用的filter 即可註冊成功。2.vc6....

MySQL使用學習使用 mysql學習使用

1 mysql學習 1 安裝 ubuntu下直接安裝 apt get install mysql server 2 檢查伺服器是否啟動 sudo netstat tap grep mysql,如果啟動成功,出現以下資訊 tcp00localhost.localdomain mysql listen ...

學習使用CSDN markdown使用

建立乙個自定義列表 如何建立乙個註腳 注釋也是必不可少的 katex數學公式 新的甘特圖功能,豐富你的文章 uml 圖表 flowchart流程圖 匯出與匯入 你好!這是你第一次使用markdown編輯器所展示的歡迎頁。如果你想學習如何使用markdown編輯器,可以仔細閱讀這篇文章,了解一下mar...