获取单个id属性历史记录 - iThings(归档-不使用)

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Basic 之后拼接空格，以及经过 Base64 编码的 username:password

示例：

Authorization: Basic *****************

Header 参数

iThings-token

string

可选

示例值:

eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJVaWQiOiIxNzQwMzU4MDU3MDM4MTg4NTQ0IiwiZXhwIjoxNjgzNTQ4NDU5LCJpYXQiOjE2ODM1NDQ4NTksIlJvbGUiOjF9.ygQyxFx7AGtf7vcFJmE-xcElQUtwE23HN_0av02tSec

iThings-project-id

string

可选

默认值:

123123123

Body 参数application/json

deviceNames

array[string]

设备名

必需

不填获取产品下所有设备

productID

string

产品id

必需

dataID

string

获取的具体标识符的数据

必需

timeStart

string

获取时间的开始

可选

timeEnd

string

时间的结束

可选

argFunc

string

聚合函数

可选

avg:平均值 first:第一个参数 last:最后一个参数 count:总数 twa: 时间加权平均函数参考:https://docs.taosdata.com/taos-sql/function

interval

integer

间隔

可选

(单位毫秒) 如果这个值不为零值则时间的开始和结束必须有效及聚合函数不应该为空

fill

string

填充模式

可选

// FILL 语句指定某一窗口区间数据缺失的情况下的填充模式。填充模式包括以下几种： // 不进行填充：NONE（默认填充模式）。 // VALUE 填充：固定值填充，此时需要指定填充的数值。例如：FILL(VALUE, 1.23)。 // PREV 填充：使用前一个非 NULL 值填充数据。例如：FILL(PREV)。 // NULL 填充：使用 NULL 填充数据。例如：FILL(NULL)。 // LINEAR 填充：根据前后距离最近的非 NULL 值做线性插值填充。例如：FILL(LINEAR)。 // NEXT 填充：使用下一个非 NULL 值填充数据。例如：FILL(NEXT)。

order

integer | null

时间排序

可选

0:aes(默认,从久到近排序) 1:desc(时间从近到久排序)

page

object

可选

page

integer

页码

必需

size

integer

每页大小

必需

示例

{
  "deviceNames": [
    "string"
  ],
  "productID": "string",
  "dataID": "string",
  "timeStart": "string",
  "timeEnd": "string",
  "argFunc": "string",
  "interval": 0,
  "fill": "string",
  "order": 0,
  "page": {
    "page": 0,
    "size": 0
  }
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'http://42.193.250.251:7777/api/v1/things/device/msg/property-log/index' \
--header 'iThings-token: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJVaWQiOiIxNzY2MjUyMTY2OTI5NjEyODAwIiwiUm9sZSI6NSwiSXNBbGxEYXRhIjoyLCJleHAiOjE2ODcwMTUyMDYsImlhdCI6MTY4NzAwOTMxMn0.xxFiBpYlTIDLYhN-_stlrmYGOLqF-wHJKBSqs-zVb8k' \
--header 'iThings-project-id: 123123123' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic Og==' \
--data-raw '{
    "deviceNames": [
        "string"
    ],
    "productID": "string",
    "dataID": "string",
    "timeStart": "string",
    "timeEnd": "string",
    "argFunc": "string",
    "interval": 0,
    "fill": "string",
    "order": 0,
    "page": {
        "page": 0,
        "size": 0
    }
}'

返回响应

🟢200成功

application/json

Body

毫秒级

data

object

必需

list

array [object {3}]

必需

total

integer

总数

必需

code

integer | null

返回code

必需

msg

string

返回消息

必需

默认值:

success

示例

{
  "code": 200,
  "msg": "success",
  "data": {
    "list": [
      {
        "timestamp": "1655473794036",
        "dataID": "GPS_Info",
        "getValue": "{\"latitude\":33,\"longtitude\":33}"
      },
      {
        "timestamp": "1655472886280",
        "dataID": "GPS_Info",
        "getValue": "{\"latitude\":33,\"longtitude\":33}"
      }
    ],
    "total": "2"
  }
}