Оператори та стан

Огляд областей

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

GET/api/v1/source-registry/areas/overview

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

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

Повертає огляд доступних даних за областями та їхні slug.

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

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

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

namestring: Назва області.
slugstring: Ідентифікатор області для URL.
katottgstring: Код КАТОТТГ області.
levelnumber: Узагальнений рівень стану.
modestring: Назва режиму електропостачання.
labelstring: Текстове пояснення стану електропостачання.
has_gpvboolean: Чи діють графіки погодинних відключень.
gpv_cancelledboolean: Чи скасовано графіки погодинних відключень.
emergency_scopestring: Масштаб аварійних обмежень: none, local або regional.
affected_katottgsarray<string>: Коди територій із локальними аварійними обмеженнями.
scheduled_queuesinteger: Кількість черг із чинним графіком відключень.
supplier_countinteger: Кількість доступних операторів області.
updatedstring | null: Час останнього доступного оновлення стану.

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

curl --fail-with-body --max-time 10 \
  'https://alerts.energy/api/v1/source-registry/areas/overview' \
  -H 'Authorization: Bearer YOUR_API_KEY'

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

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

[
  {
    "name": "місто Київ",
    "slug": "kyiv",
    "katottg": "UA80000000000093317",
    "level": 2,
    "mode": "scheduled",
    "label": "Діють графіки погодинних відключень",
    "has_gpv": true,
    "gpv_cancelled": false,
    "emergency_scope": "none",
    "affected_katottgs": [],
    "scheduled_queues": 1,
    "supplier_count": 1,
    "updated": "2026-10-28T06:00:00.000Z"
  }
]