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