
有人云二次開(kāi)發(fā)-獲取設(shè)備變量歷史記錄
一、資料下載
有人云IOT說(shuō)明書(shū) :http://cloud.usr.cn/document/881.html
有人云IOT登錄地址 :https://account.usr.cn/#/login
接口文檔地址:http://cloud.usr.cn/document/1179.html
注意:(不符合以下要求會(huì)被系統(tǒng)限制調(diào)?。?/p>
1、調(diào)用此接口每分鐘不能超過(guò)10次
2、本接口嚴(yán)禁周期頻繁調(diào)用
3、單次查詢(xún)變量數(shù)量不得超過(guò)10個(gè)
4、單次查詢(xún)單個(gè)變量的歷史記錄不得超過(guò)5000條
5、若要獲取變量最新數(shù)據(jù),請(qǐng)使用獲取歷史記錄最新數(shù)據(jù)
6、如果需要獲取實(shí)時(shí)數(shù)據(jù),或想通過(guò)數(shù)據(jù)開(kāi)發(fā)自己個(gè)性化業(yè)務(wù)系統(tǒng),推薦使用數(shù)據(jù)推送或私有部署
二、接口說(shuō)明
該接口的請(qǐng)求 URL由兩部分構(gòu)成,{url}/history/cusdevice/dataPoint
{url}部分需要其它接口來(lái)獲取(獲取歷史記錄查詢(xún)地址:http://cloud.usr.cn/document/821.html),該查詢(xún)地址一般不會(huì)變化,可獲取一次后重復(fù)使用
三、調(diào)取測(cè)試步驟測(cè)試使用工具:有人云API接口調(diào)試工具或postman軟件
(http://cloud.usr.cn/interface/#/debugger?url=%7Burl%7D%2Fhistory%2Fcusdevice%2FlastDataPoint)
1、獲取X-Access-Token(token兩小時(shí)內(nèi)有效,如之前已獲取可忽略該步驟)
A、申請(qǐng)二次開(kāi)發(fā)權(quán)限后,可在擴(kuò)展功能-功能中心中查看密鑰

B、打開(kāi)調(diào)試工具,將獲取X-Access-Token的接口URL跟body請(qǐng)求復(fù)制進(jìn)工具相應(yīng)位置,將具體參數(shù)替換成前一步獲取的密鑰,填寫(xiě)完成后發(fā)送,可獲取到token

2、獲取獲取歷史記錄查詢(xún)地址
A、將第一步獲取的token填寫(xiě)到Headers內(nèi)容里(有人云的調(diào)試工具選擇接口后會(huì)自動(dòng)同步url跟token,其他軟件需要手動(dòng)填入)

B、將文檔示例中的括號(hào)粘過(guò)來(lái)填入body,點(diǎn)發(fā)送,獲取查詢(xún)地址(body內(nèi)容為空對(duì)象,不是空著,這里要注意,如果不帶括號(hào)獲取會(huì)報(bào)錯(cuò))

3、獲取設(shè)備變量歷史記錄
A、將{url}/history/cusdevice/dataPoint中{url}的替換為前一步獲取的查詢(xún)地址,組成獲取設(shè)備變量歷史記錄的URL:https://history.usr......./history/cusdevice/dataPoint
B、將組成的url與token填入測(cè)試工具

C、將說(shuō)明文檔中示例粘入body,具體參數(shù)需要替換為自己的實(shí)際參數(shù),可在平臺(tái)查看,發(fā)送后獲取到查詢(xún)時(shí)間段內(nèi)的歷史數(shù)據(jù)(時(shí)間戳格式為unix時(shí)間戳ms)


編寫(xiě)人:許工 編寫(xiě)日期:2024-09-25
審核人:金志方 審核日期:2024-10-14
訂正版本:V1.0 訂正內(nèi)容:初稿