Територія

Параметри URL

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

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

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

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

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

countrystring

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

dataobject

Адміністративна одиниця, що відповідає коду в URL.

Атрибути об’єкта

katottgstring

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

parent_katottgstring | null

Код батьківської адміністративної одиниці. Значення null означає, що територія належить до верхнього рівня.

namestring

Назва адміністративної одиниці.

full_namestring

Повна назва з уточненням типу адміністративної одиниці.

slugstring

Текстовий ідентифікатор території для використання в URL.

categorystring

Код категорії адміністративної одиниці у класифікаторі.

levelinteger

Рівень адміністративної ієрархії. Верхній рівень має значення 1; більше значення означає глибший рівень.

Перехід ієрархією

Щоб отримати батьківську одиницю, використайте її parent_katottg у цьому методі. Якщо parent_katottg дорівнює null, територія належить до верхнього рівня.

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

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