Skip to content

Збирач даних

Збирач даних дозволяє SVITRIX автоматично отримувати дані із зовнішніх HTTP/HTTPS API та відображати результати на LED-матриці — без системи розумного дому.

Як це працює

  1. Ви налаштовуєте одне або кілька джерел даних, кожне з яких вказує на зовнішній API
  2. SVITRIX періодично опитує кожне джерело та витягує значення з JSON-відповіді
  3. Витягнуте значення форматується та відображається як застосунок у циклі

Веб-інтерфейс

Перейдіть за адресою http://[IP]/datafetcher у браузері для керування джерелами даних через візуальний інтерфейс. Ви можете додавати, редагувати та видаляти джерела без написання API-запитів.

Налаштування

Кожне джерело даних має такі параметри:

ПараметрОпис
NameУнікальний ідентифікатор — стає назвою застосунку у циклі
URLПовний HTTP або HTTPS URL API-ендпоінту
JSON PathШлях до значення у відповіді через крапку (напр., bitcoin.usd або data.0.price)
Display FormatНеобов'язковий формат printf (напр., $%.0f для "$67432", %.1f°C для "23.5°C")
IconНеобов'язкова назва іконки з папки ICONS
ColorНеобов'язковий колір тексту hex #RRGGBB
IntervalІнтервал опитування у секундах (мінімум 60, за замовчуванням 900)

Приклад: ціна Bitcoin

Для відображення поточної ціни Bitcoin:

  • Name: btc
  • URL: https://api.coingecko.com/api/v3/simple/price?ids=bitcoin&vs_currencies=usd
  • JSON Path: bitcoin.usd
  • Display Format: $%.0f
  • Icon: btc
  • Color: #F7931A
  • Interval: 300 (кожні 5 хвилин)

Обмеження

  • Максимум 8 джерел даних одночасно
  • Відповідь API повинна бути менше 4 КБ
  • Підтримуються лише публічні API (без кастомних заголовків автентифікації)
  • Мінімальний інтервал опитування — 60 секунд
  • HTTPS підтримується, але без перевірки сертифіката

API

Джерелами даних також можна керувати через HTTP API.