通博TBET

通博TBET云二次开发-获取设备变量历史记录

一、资料下载

通博TBET云IOT说明书 ：http://cloud.ybljg.com/document/881.html

通博TBET云IOT登录地址 ：http://account.ybljg.com/#/login
接口文档地址：http://cloud.ybljg.com/document/1179.html

注意：（不符合以下要求会被系统限制调取）

1、调用此接口每分钟不能超过10次

2、本接口严禁周期频繁调用

3、单次查询变量数量不得超过10个

4、单次查询单个变量的历史记录不得超过5000条

5、若要获取变量最新数据，请使用获取历史记录最新数据

6、如果需要获取实时数据，或想通过数据开发自己个性化业务系统，推荐使用数据推送或私有部署

二、接口说明

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

{url}部分需要其它接口来获取（获取历史记录查询地址：http://cloud.ybljg.com/document/821.html），该查询地址一般不会变化，可获取一次后重复使用

三、调取测试步骤测试使用工具：通博TBET云API接口调试工具或postman软件

（http://cloud.ybljg.com/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内容里（通博TBET云的调试工具选择接口后会自动同步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  订正内容：初稿