设备历史数据配置查询

• 接口描述

用户可通过本接口获取自己名下指定设备的历史数据配置信息。

• 请求方法

GET

• 请求路径

/v1/dev/history/config

• 接口传参说明

参数	含义	数据类型	传参限制	是否必填
currPage	当前页数	字符串	1-3位正整型数	是
perPage	每页条数	字符串	10 / 50 / 100	是
snCode	设备SN码	字符串	纯数字字符串	是

• 返回值示例

此处仅描述data中包含的数据，外部返回值的含义请参考统一返回值。

{
  "list": [
    {
      "snCode":"100031", // 设备SN码
      "groupId": 877, // 历史数据分组ID
      "groupName":"通道名", // 历史数据分组名
      "sampleTotal": 1 , // 取样总数
      "sampleWay":1 , // 取样方式 (1-周期式，2-触发式，3-定时取样)
      "sendState": 1 // 是否已同步到设备
    }
  ],
  "totalSize": 2,
  "totalPage":1
}

设备历史数据查询

• 接口描述

用户可通过本接口获取自己名下指定设备的历史数据。

• 请求方法

GET

• 请求路径

/v1/dev/history/data

• 接口传参说明

参数	含义	数据类型	传参限制	是否必填
currPage	当前页数	字符串	1-3位正整型数	是
perPage	每页条数	字符串	10 / 50 / 100	是
snCode	设备SN码	字符串	纯数字字符串	是
startTime	起始时间	字符串	10位时间戳	是
endTime	结束时间	字符串	10位时间戳	是
groupId	分组ID（通过历史数据配置查询接口获取）	整型		是

• 返回值示例

此处仅描述data中包含的数据，外部返回值的含义请参考统一返回值 (opens new window)。

{
  "data":[
    {
      "sn_code":"20201112", // 设备SN码
      "group_name":"历史数据", // 设备历史数据分组名
      "columns":"LW10,LW20,QW4", // 设备历史数据标题行 (数据名称)
      "timeAndData":[
        {
          "time_stamp":"2021-11-04 17:11:10", // 时间
          "data":"0,0,0" // 历史数据
        },
        {
          "time_stamp":"2021-11-04 17:10:40",
          "data":"0,0,0"
        }
      ]
    }
  ]
}