Графіки відключень

Зміни графіків території

Ознайомтеся з параметрами запиту та форматом відповіді методу.

GET/api/v1/atu/:katottg/shutdowns/changes

API-ключ - спільна квота облікового запису

Параметри URL та запиту

katottgstring - URLОбов'язковий: Код КАТОТТГ території: UA та 17 цифр.
datestring - query: Дата YYYY-MM-DD за київським часом.

Запит і відповідь

Необовʼязковий date у форматі YYYY-MM-DD; за замовчуванням - поточна дата за київським часом. До 50 змін, новіші першими.

Передайте API-ключ у заголовку Authorization. При 401 перевірте ключ; при 403 - підписку та доступність методу; при 429 враховуйте Retry-After.

Атрибути відповіді

Атрибути елемента масиву

initiatorstring: Ідентифікатор оператора.
queuestring: Черга, графік якої змінився.
date_slugstring: Дата графіка YYYY-MM-DD.
daystring: Позначення дня графіка: today або tomorrow.
actionstring: Створення, оновлення або видалення запису.
beforearray<integer>: Погодинні значення графіка до зміни.
afterarray<integer>: Погодинні значення графіка після зміни.
changed_hoursarray<integer>: Номери годин, значення яких змінилося.
changed_atstring: Час фіксації зміни.

Приклад запиту

curl --fail-with-body --max-time 10 \
  'https://alerts.energy/api/v1/atu/UA80000000000093317/shutdowns/changes' \
  -H 'Authorization: Bearer YOUR_API_KEY'

Приклад відповіді

Умовний скорочений приклад формату. Він не описує поточну ситуацію.

[
  {
    "initiator": "example-operator",
    "queue": "1.1",
    "date_slug": "2026-10-28",
    "day": "today",
    "action": "updated",
    "before": [
      0,
      0,
      0,
      0,
      0,
      0,
      0,
      0,
      0,
      0,
      0,
      0,
      0,
      0,
      0,
      0,
      0,
      0,
      0,
      0,
      0,
      0,
      0,
      0
    ],
    "after": [
      0,
      0,
      0,
      0,
      0,
      0,
      1,
      1,
      0,
      0,
      0,
      0,
      2,
      3,
      0,
      0,
      0,
      0,
      1,
      1,
      0,
      0,
      0,
      0
    ],
    "changed_hours": [
      6,
      7,
      12,
      13,
      18,
      19
    ],
    "changed_at": "2026-10-28T06:00:00.000Z"
  }
]