Отримати історію параметрів

GET 
/devices/:id/:parameter_name/histo/:timestamp_start/:timestamp_end

Отримати історію параметрів пристрою.

примітка

Цей запит до API може зайняти трохи часу в залежності від запитаного періоду часу.

примітка

Для деяких параметрів (наприклад, мультірівневі датчики) дані будуть відфільтровані та усереднені для відповіді на вимогу пунктів.

Request

Path Parameters

id integerrequired

Ідентифікатор пристрою

parameter_name stringrequired

Назва параметру для запиту

timestamp_start int64required

Початковий часовий штамп для історії

timestamp_end int64required

Кінцева відмітка часу для історії

Query Parameters

points integer

Максимальна кількість балів у відповіді

Responses

200

Історія параметрів

application/json

Schema

Schema

successbooleanrequired

Прапорець, який показує, чи був запит успішним

values

object[]

Список записів історії

Array [

dateinteger

Часова мітка запису

value

object

oneOf

MOD1

number

MOD2

string

]

Example (from schema)

{
  "success": true,
  "values": [
    {
      "date": 0,
      "value": 0
    }
  ]
}

401

Користувач не має дозволу.

application/json

Schema

Schema

successbooleanrequired

Прапорець, який показує, чи був запит успішним

errorCodeintegerrequired

Ціле число помилки, див. Помилки

errorMessagestringrequired

Опис помилки

errorParameters

Додаткові дані, що описують помилку

Example (from schema)

{
  "success": true,
  "errorCode": 0,
  "errorMessage": "string"
}

Example

{
  "success": false,
  "errorCode": 4131,
  "errorMessage": "User not authorized",
  "errorParameters": "Not authorized"
}

403

Відмовлено в доступі

application/json

Schema

Schema

successbooleanrequired

Прапорець, який показує, чи був запит успішним

errorCodeintegerrequired

Ціле число помилки, див. Помилки

errorMessagestringrequired

Опис помилки

errorParameters

Додаткові дані, що описують помилку

Example (from schema)

{
  "success": true,
  "errorCode": 0,
  "errorMessage": "string"
}

Example

{
  "success": false,
  "errorCode": 4132,
  "errorMessage": "Access denied",
  "errorParameters": "Access denied"
}

404

Потрібний пристрій не знайдено.

application/json

Schema

Schema

successbooleanrequired

Прапорець, який показує, чи був запит успішним

errorCodeintegerrequired

Ціле число помилки, див. Помилки

errorMessagestringrequired

Опис помилки

errorParameters

Додаткові дані, що описують помилку

Example (from schema)

{
  "success": true,
  "errorCode": 0,
  "errorMessage": "string"
}

Example

{
  "success": false,
  "errorCode": 4128,
  "errorMessage": "Not found",
  "errorParameters": {
    "type": "device",
    "id": 11
  }
}