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 |
Пример запроса:
sh
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 |
Пример ответа:
json
[
{
"key": "rssi",
"ts": "2023-02-15T00:01:10.015",
"value": -75
},
{
"key": "rssi",
"ts": "2023-02-15T00:06:13.295",
"value": -81
}
]