Віджети і бейджі
Покажіть стан світла своєї черги чи області на сайті, у README чи в розумному домі. Без ключа, без реєстрації.
Налаштуйте бейдж
Розмір впливає лише на код iframe: бейдж має власний розмір.
Попередній перегляд
Оберіть область (і чергу), щоб побачити бейдж і картку.
Бейдж
Картка (iframe)
Для сайту: картка в iframe і бейдж
Картка — це окрема сторінка, яку дозволено вбудовувати. Вставте код туди, де має бути віджет.
……README, форуми, чати
………Розумний дім і скрипти
JSON-стан можна читати з Home Assistant, Node-RED, Homebridge чи звичайного скрипта. Опитуйте не частіше ніж раз на 1–2 хвилини.
……Поля відповіді /status: state, class, plan_status, restore_at, next_outage_at, updated_at, stale, source. Стан unknown означає «даних немає», а не «світло є».
Ліміти й чесні застереження
- Дані на сервері перераховуються приблизно кожні 30 секунд, але браузери й проксі можуть кілька хвилин тримати бейдж у кеші. Це нормально для сторінки, але не для автоматики.
- Ліміти спільні з API: 600 читань на хвилину з однієї IP-адреси. Для вашого сайту запити до бейджа робить браузер відвідувача, тож ліміт діє на нього, а не на вас. Для серверних опитувань частіше ніж раз на хвилину потрібен ключ: див. «Для розробників».
- Це не офіційне джерело і не гарантія подачі світла. Стан за графіком оператора може не збігатися з фактом; ознаку
stale(дані старші за 45 хвилин) показуємо на картці. - Не будуйте на цьому автоматичних рішень, від яких залежить безпека людей чи обладнання (медичні пристрої, генератори, сигналізація).
- Нативних віджетів для домашнього екрана iOS чи Android немає. Є бейдж, картка, API та Telegram-бот.
- Бейдж показує агрегат для черги чи області. Окремих будинків і окремих датчиків не показуємо.