一、資料準備:
有人云網址:http://cloud.usr.cn/
二次開發(fā)文檔:http://cloud.usr.cn/document/237.html
二、注意:
1、用戶可以通過http請求向設備下發(fā)數(shù)據(jù),目前僅支持數(shù)據(jù)點數(shù)據(jù)和透傳數(shù)據(jù)的下發(fā)
2、每個用戶每秒最多下發(fā)10條數(shù)據(jù),超出部分的數(shù)據(jù),服務器不處理并返回錯誤碼
3、進行二次開發(fā)時需要將使用的設備在線
4、流程:
(1)通過用戶登陸接口獲取token
(2)獲取推送的url,獲取命令下發(fā)地址,注:該接口有頻率限制,獲取一次后可重復使用,不需頻繁獲取
(3)按照接口規(guī)范推送命令數(shù)據(jù)
三、具體操作步驟:
1、在接口文檔中找到用戶登錄接口(二次開發(fā)-API-用戶-用戶登錄)
將請求URL和請求方式填到postman中
2、在headers中添加Content-Type請求參數(shù),值為application/json
3、將請求示例大括號中得數(shù)據(jù)復制到body的raw中
account中填有人云賬號,password中填有人云密碼md5加密之后的密碼
設置完成后點擊Send,獲取生成的token
4、在二次開發(fā)文檔界面打開獲取命令下發(fā)地址(二次開發(fā)-命令下發(fā)-使用文檔-獲取命令下發(fā)地址)
5、將命令下發(fā)的請求方式和請求URL填入postman中
在headers中添加Content-Type和token,值分別為application/json以及剛剛獲取到的token
生成的token兩小時內有效
6、將請求示例復制到body的raw中,之后點擊Send,會生成一個鏈接,這個鏈接是命令下發(fā)地址
7、二次開發(fā)文檔打開命令下發(fā)界面(二次開發(fā)-命令下發(fā)-使用文檔)
命令下發(fā)的接口類型為post,協(xié)議類型為https
將剛剛生成的命令下發(fā)地址復制到新建的窗口的URL中,后邊加上/v1.0/{type}/{deviceId}
其中type: dataPoint或transmission(dataPoint:變量數(shù)據(jù),transmission:透傳數(shù)據(jù));deviceId:設備sn
8、在headers中添加Content-Type和token,值分別為application/json以及剛剛獲取到的token
生成的token兩小時內有效
9、在body中填入示例中的代碼
數(shù)據(jù)透傳的話填入"data":"YWJjZGVmZw==",其中data中的數(shù)據(jù)為透傳的數(shù)據(jù)(數(shù)據(jù)轉為base64傳輸,最大長度為8000個字符)
組態(tài)數(shù)據(jù)的話,slaveName為從機名稱,variableName為變量名稱,value為數(shù)據(jù)本身
10、如果返回200,則證明接口下發(fā)成功