Для осуществления пакетной загрузки данных о квартирах, нужно предоставить API из двух URL, по которым постоянно доступны актуальные данные в JSON-формате.
пример URL: https://example.com/projects
Структура JSON:
[
{
"id": string, (1)
"name": string, (2)
},
... другие ЖК
]
(1) Идентификатор ЖК в Вашей системе. Любая уникальная строка. Не должен меняться.
(2) Название ЖК.
Должен в качестве параметра принимать идентификатор ЖК.
пример URL: https://example.com/project-units?project_id=12
Структура JSON:
[
{
"area": number, (1)
"block_name": string | null, (2)
"flat_number": string | null, (3)
"floor": number, (4)
"id": string, (5)
"layout_url": string, (6)
"price": number, (7)
"room_count": number, (8)
"status": 'sold' | 'booked' | 'available', (9)
"unit_type": 'flat' | 'splithouse' | 'quadrohouse' | 'cottage' | 'penthouse' | 'townhouse' | 'duplex', (10)
},
... другие квартиры
]
Пример данных с заполненными полями можно найти в файле feed-example.json в этом репозитории.
(1) Площадь квартиры.
(2) Грубо говоря, блоки — это отдельные дома в комлексе. Примеры названия блока: "Дом 1", "Блок А", "Дом 1, секция 2".
(3) Номер квартиры (если это квартира, а не частный дом).
(4) Номер этажа квартиры (указывается в любом случае, даже если во всем доме только один этаж).
(5) Идентификатор квартиры. Любая строка, уникальная в пределах новостройки. Не должен меняться!
(6) Ссылка на изображение планировки квартиры. Поддерживаемые форматы — png и jpg (jpeg). Размер - до 50 Мп.
(7) Цена квартиры (не цена за метр квадратный).
(8) Количество комнат в квартире.
(9) Статус продажи квартиры. Три допустимые значения: sold - продана, booked - забронирована, available - доступна для покупки.
(10) Тип недвижимости. Самый распространенный вариант - flat. Помимо него есть пентхаус и варианты для разных типов частных домов.