Надзвичайні ситуації території

Параметри URL

countrystringОбов’язковий

Дволітерний код ISO 3166-1 alpha-2 у нижньому регістрі. Використовуйте поле code зі списку країн.

katottgstringОбов’язковий

Код адміністративної одиниці зі списку територій вибраної країни.

Які ситуації входять до відповіді

Відповідь містить ситуації самої території та її батьківських одиниць. Враховуються всі батьківські одиниці до верхнього рівня адміністративної ієрархії. Ситуації дочірніх або сусідніх територій не включаються. У кожному записі зберігається код території, для якої ситуацію оголошено.

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

Передайте API-ключ у заголовку Authorization. Параметри запиту та тіло не потрібні. Успішна відповідь має статус 200 і формат JSON. Оновлення можуть з’являтися у відповіді із затримкою до 15 секунд.

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

countrystring

Код країни з параметра URL.

katottgstring

Код території, яку запитано в URL.

dataarray<object>

Поточні ситуації в межах описаного охоплення. Якщо активних записів немає, повертається порожній масив.

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

katottgstring

Код території, для якої оголошено ситуацію. У відповіді для вибраної території це може бути код її батьківської одиниці.

typestring

Ідентифікатор типу надзвичайної ситуації. Наприклад, air позначає повітряну загрозу.

levelinteger

Поточний рівень у межах типу ситуації. Назву та пояснення можна отримати з довідника рівнів за поєднанням type та level.

startstring · date-time

Час початку ситуації у форматі ISO 8601, UTC. Суфікс Z позначає нульове зміщення від UTC.

endnull

Для поточної ситуації завжди null. Завершені записи до відповіді не потрапляють.

Помилки запиту

Невідома країна або територія повертає 404. Недоступні дані країни повертають 409, некоректні параметри повертають 422. При 401 перевірте API-ключ, при 429 зачекайте час із Retry-After.