Території

Міста і громади області

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

GET/api/v1/atus/:katottg/city-communities

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

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

katottgstring - URLОбов'язковий: Код КАТОТТГ території: UA та 17 цифр.

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

Передайте код області. Метод повертає міста та громади області, коли в громаді знайдено одне місто.

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

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

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

citystring: Назва міста.
communitystring: Повна назва територіальної громади.
district_slugstring: Ідентифікатор району для URL.
community_slugstring: Ідентифікатор громади для URL.

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

curl --fail-with-body --max-time 10 \
  'https://alerts.energy/api/v1/atus/UA32000000000030281/city-communities' \
  -H 'Authorization: Bearer YOUR_API_KEY'

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

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

[
  {
    "city": "Приклад",
    "community": "Приклад територіальна громада",
    "district_slug": "pryklad-rayon",
    "community_slug": "pryklad-terytorialna-hromada"
  }
]