有人云二次開發(fā)-獲取設(shè)備變量歷史記錄
一、資料下載
有人云IOT說明書 :http://cloud.usr.cn/document/881.html
有人云IOT登錄地址 :https://account.usr.cn/#/login
接口文檔地址:http://cloud.usr.cn/document/1179.html
注意:(不符合以下要求會被系統(tǒng)限制調(diào)?。?/p>
1、調(diào)用此接口每分鐘不能超過10次
2、本接口嚴禁周期頻繁調(diào)用
3、單次查詢變量數(shù)量不得超過10個
4、單次查詢單個變量的歷史記錄不得超過5000條
5、若要獲取變量最新數(shù)據(jù),請使用獲取歷史記錄最新數(shù)據(jù)
6、如果需要獲取實時數(shù)據(jù),或想通過數(shù)據(jù)開發(fā)自己個性化業(yè)務(wù)系統(tǒng),推薦使用數(shù)據(jù)推送或私有部署
二、接口說明
該接口的請求 URL由兩部分構(gòu)成,{url}/history/cusdevice/dataPoint
{url}部分需要其它接口來獲?。ǐ@取歷史記錄查詢地址:http://cloud.usr.cn/document/821.html),該查詢地址一般不會變化,可獲取一次后重復(fù)使用
三、調(diào)取測試步驟測試使用工具:有人云API接口調(diào)試工具或postman軟件
(http://cloud.usr.cn/interface/#/debugger?url=%7Burl%7D%2Fhistory%2Fcusdevice%2FlastDataPoint)
1、獲取X-Access-Token(token兩小時內(nèi)有效,如之前已獲取可忽略該步驟)
A、申請二次開發(fā)權(quán)限后,可在擴展功能-功能中心中查看密鑰
B、打開調(diào)試工具,將獲取X-Access-Token的接口URL跟body請求復(fù)制進工具相應(yīng)位置,將具體參數(shù)替換成前一步獲取的密鑰,填寫完成后發(fā)送,可獲取到token
2、獲取獲取歷史記錄查詢地址
A、將第一步獲取的token填寫到Headers內(nèi)容里(有人云的調(diào)試工具選擇接口后會自動同步url跟token,其他軟件需要手動填入)
B、將文檔示例中的括號粘過來填入body,點發(fā)送,獲取查詢地址(body內(nèi)容為空對象,不是空著,這里要注意,如果不帶括號獲取會報錯)
3、獲取設(shè)備變量歷史記錄
A、將{url}/history/cusdevice/dataPoint中{url}的替換為前一步獲取的查詢地址,組成獲取設(shè)備變量歷史記錄的URL:https://history.usr......./history/cusdevice/dataPoint
B、將組成的url與token填入測試工具
C、將說明文檔中示例粘入body,具體參數(shù)需要替換為自己的實際參數(shù),可在平臺查看,發(fā)送后獲取到查詢時間段內(nèi)的歷史數(shù)據(jù)(時間戳格式為unix時間戳ms)
編寫人:許工 編寫日期:2024-09-25
審核人:金志方 審核日期:2024-10-14
訂正版本:V1.0 訂正內(nèi)容:初稿