Для розробників
API графіків відключень світла
Ті самі дані, що на сайті, у JSON: для телеграм-ботів, віджетів, Home Assistant. Без ключа, CORS відкритий, до 120 запитів на хвилину з однієї адреси. Дані оновлюються щохвилини, тож частіше питати немає сенсу.
- GET /api/v1/regions
Усі області: стан джерела, скільки черг зараз без світла, чи є графік на завтра.
- GET /api/v1/regions/{область}
Усі черги області на сьогодні й завтра та останні зміни.
- GET /api/v1/regions/{область}/groups/{черга}
Одна черга: сьогодні, завтра, два тижні історії та історія змін.
- GET /{область}/{черга}/calendar.ics
Календарна підписка (iCalendar). Параметр ?alarm=30 додає нагадування за 30 хвилин.
Розширений API: список очікування
Готуємо API з ключами для тих, кому відкритого замало: вебхуки, щойно графік змінився, пошук черги за адресою, вищі ліміти, історія. Розкажіть, що будуєте і що потрібно, і ми напишемо, коли відкриємо доступ.
Як читати день
intervals:[від, до, тип], хвилини від опівночі за Києвом; типoff(немає світла) абоmaybe(можливе відключення).events: ті самі проміжки як мітки часу в мілісекундах, з урахуванням переходу на літній час.status:scheduled,no-outages,emergency(графік не діє) абоunknown. Unknown означає «не опубліковано», а не «світло буде».