数据本地化
业务个性化
凯发K8云二次开发-获取设备变量历史记录
一、资料下载
凯发K8云IOT说明书 ：http://cloud.a3photo.net/document/881.html
凯发K8云IOT登录地址 ：http://account.a3photo.net/#/login
接口文档地址：http://cloud.a3photo.net/document/1179.html
注意：（不符合以下要求会被系统限制调取）
1、调用此接口每分钟不能超过10次
2、本接口严禁周期频繁调用
3、单次查询变量数量不得超过10个
4、单次查询单个变量的历史记录不得超过5000条
5、若要获取变量最新数据，请使用获取历史记录最新数据
6、如果需要获取实时数据，或想通过数据开发自己个性化业务系统，推荐使用数据推送或私有部署
二、接口说明
该接口的请求 URL由两部分构成，{url}/history/cusdevice/dataPoint
{url}部分需要其它接口来获取（获取历史记录查询地址：http://cloud.a3photo.net/document/821.html），该查询地址一般不会变化，可获取一次后重复使用
三、调取测试步骤测试使用工具：凯发K8云API接口调试工具或postman软件
（http://cloud.a3photo.net/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内容里（凯发K8云的调试工具选择接口后会自动同步url跟token，其他软件需要手动填入）
B、将文档示例中的括号粘过来填入body，点发送，获取查询地址（body内容为空对象，不是空着，这里要注意，如果不带括号获取会报错）
3、获取设备变量历史记录
A、将{url}/history/cusdevice/dataPoint中{url}的替换为前一步获取的查询地址，组成获取设备变量历史记录的URL：http://history.usr......./history/cusdevice/dataPoint
B、将组成的url与token填入测试工具
C、将说明文档中示例粘入body，具体参数需要替换为自己的实际参数，可在平台查看，发送后获取到查询时间段内的历史数据（时间戳格式为unix时间戳ms）
编写人：许工 编写日期：2024-09-25
审核人：金志方 审核日期：2024-10-14
订正版本：V1.0 订正内容：初稿
