Отримати стислий перелік нерухомості по коду ЮО/ФОП

Отримати стислий перелік назв нерухомого майна особи. Якщо вказано allowspecialdata - повертає застарілі дані (якщо не знаходить більш нових).
Якщо поставлено замовлення на збір, але збір даних по цьому об’єкту ще не завершено - функція видає попередження (status = 201) та видає більш старі дані (якщо вони є в системі)
якщо mode = 0 - видається масив items тільки з назвами нерухомості.
якщо mode = 1 - видається масив items_ex із структурованими даними про нерухомість. Допустимі значення для поля type - див. /estate/type/; для поля role_id - див. /estate/role_type. Також кожен об'єкт нерухомості має свій ідентифікатор (поле "id" - ідентифікатор об'єкта) - він зберігається не більше двох діб, після стає не актуальним.
Для земельних ділянок також присутні додаткові поля parcel_active, obl_code, obl_name, area, area_unit, purpose, use. Зверніть увагу, що для parcel_active = false - також можуть бути заповнені дані по області і т.п. Це означає, що ділянка вже недійсна (можливо розділена), а дані надаються по останньому її активному стану

Request

Authorization

Add parameter in query

key

Example:

key: ********************

Query Params

search_identifier

string

required

код юр/фіз особи

search_type

integer

optional

тип даних в полі search_identifiers (дозволено: 1,6,7;за вмовчанням - 1)

allowspecialdata

boolean

optional

показувати дані з інших джерел

mode

integer

optional

режим виводу (за вмовч=0)

language

string

optional

3 літ. ISO 639-1

key

string

optional

ключ доступу

Responses

🟢200Success

application/json

Body

answer

required

Any of

mode=0

mode=1

items

array[string]

required

перелік об'єктів

is_updating

boolean

required

чи зараз в процесі оновлення

updated_datetime

required

час останнього оновлення

data_checkvalue

string

required

якщо значення змінюється - дані були змінені

status

enum<string>

required

Allowed values:

SuccessWarningError

statusCode

integer

required

message

string

optional

Examples

Success (mode=0)Success (mode=1)

{
    "status": "Warning",
    "statusCode": 201,
    "message": "За цим кодом є запити на збирання даних (пізніші за наявні в базі), які ще не оброблено, або завершено з помилкою (202432 від 2024-03-18 15:07:45.893)",
    "answer": {
        "items": [
            "3220686602:01:002:0053",
            "3220686600:02:010:0003",
            "3220686600:02:010:0002",
            "3220686600:02:010:0001",
            "м.Київ, вулиця Почайнинська, будинок 44",
            "м.Київ, вулиця Шовкуненка, будинок 6",
            "м.Київ, вулиця Електриків, будинок 26",
            "м.Київ, вулиця Електриків, будинок 31",
            "м.Київ, вулиця Електриків, будинок 26/6",
            "м.Київ, вулиця Електриків, будинок 26/9",
            "м.Київ, вулиця Хорива, будинок 33/35",
            "м.Київ, вулиця Щекавицька, будинок 45",
            "м.Київ, вулиця Сурикова, будинок 5",
            "м.Київ, вулиця Старовокзальна, будинок 14/16",
            "Невизначене майно",
            "6522383500:02:002:0032"
        ],
        "relevanceDate": "2024-03-14",
        "updated_datetime": "2024-03-14 15:56:37.743",
        "is_updating": true,
        "data_checkvalue": "E5B317BE94D0E6888DA0A29FA7289F83"
    }
}