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

Оператори області

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

GET/api/v1/source-registry/areas/:slug/suppliers

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

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

slugstring - URLОбов'язковий: Текстовий ідентифікатор із відповідного списку.

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

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

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

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

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

slugstring: Текстовий ідентифікатор оператора.
supplier_keystring: Ключ оператора в довіднику.
supplier_codestring: Код оператора в довіднику.
supplier_namestring: Назва оператора.
supplier_typestring: Тип оператора.
area_slugstring: Ідентифікатор області для URL.
area_namestring: Назва області.
katottgstring | optional: Код КАТОТТГ області, якщо він доступний.
prioritynumber: Порядок відображення оператора.

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

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

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

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

[
  {
    "area_slug": "kyiv",
    "area_name": "місто Київ",
    "katottg": "UA80000000000093317",
    "slug": "example-operator",
    "supplier_key": "example-operator",
    "supplier_code": "example",
    "supplier_name": "Приклад оператора",
    "supplier_type": "oblenergo",
    "priority": 100
  }
]