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

Параметри URL

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

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

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

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

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

countrystring

Код країни з параметра 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.