6. Получение исторической телеметрии от устройства
Историческая телеметрия − это все данные полученные от устройства с момента его подключения. Хранение данных, полученных от устройства, необходимо для их использования для статистики и анализа изменений данных за промежуток времени.
Чтобы получить исторические данные по телеметрии от устройства, используйте метод GET /front-api-srv/api/v1.0/telemetry.
В адресе запроса необходимо указать данные, которые были получены на предыдущих шагах, и период, за который необходимо получить телеметрию.
| Параметр | Тип | Тип данных | Обяз. | Описание | Пример |
|---|---|---|---|---|---|
| deviceId | query | string | + | ID устройства | 000000b0-00ca-0000-00f0-0a0000000eb0 |
| keys | query | string | - | Ключи телеметрии | rssi |
| from | query | string | + | Начальная дата поиска телеметрии. Формат ISO 8601 | 20230126T00:00:00.000Z |
| to | query | string | + | Конечная дата поиска телеметрии | 20230227T17:25:43.511Z |
Пример запроса:
curl --location -g --request GET 'api/v1.0/telemetry?deviceId=745fd0b3-c3ca-4ede-87dc-1e3650cb9d57&from=2023-01-26T00:00:00.000Z&to=2023-02-27T17:25:43.511Z' \--header 'X-Tenant-API-Key: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.6POk6yJV_adQssw5c'\После успешного выполнения запроса будет получен ответ с полученными данными от устройства за указанный период. Ответ содержит параметры:
| Параметр | Тип данных | Описание | Пример |
|---|---|---|---|
| ts | string | Время сохранения телеметрии | 2023-02-15T00:01:10.015 |
| key | string | Ключ телеметрии | rssi |
| value | int/double/string/boolean/long | Значение телеметрии | -75 |
Пример ответа:
[ { "key": "rssi", "ts": "2023-02-15T00:01:10.015", "value": -75 }, { "key": "rssi", "ts": "2023-02-15T00:06:13.295", "value": -81 }]