凯发K8

凯发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. 获取历史记录最新数据（该接口不适用于实时数据获取）
2. 调用此接口每分钟不能超过30次
3. 本接口严禁周期频繁调用
4. 如果需要获取实时数据，或想通过数据开发自己个性化业务系统，推荐使用javasdk或数据推送或私有部署

二、接口说明

该接口的请求 URL由两部分构成，{url}/history/cusdevice/lastDataPoint

{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/lastDataPoint中{url}的替换为前一步获取的查询地址，组成获取历史记录最新数据的URL：http://history.usr......./history/cusdevice/lastDataPoint

B、将组成的url与token填入测试工具

C、将文档中示例粘入body，具体参数需要替换为自己的实际参数，可在平台查看，发送后获取到最新数据

编写人：许工    编写日期：2024-09-25

                   审核人：金志方   审核日期：2024-10-14  

                   订正版本：V1.0  订正内容：初稿