Фид формата Домопланер JSON
Содержание статьи
ВАЖНО: ДАННЫЙ ФОРМАТ ФИДА - УСТАРЕВШИЙ!
Делайте интеграцию сразу с новой версией нашего фида:
подробнее о структурном фиде Домопланера.
-----
Данный тип фида подойдет для синхронизации наличия с сайтом. Наши рекомендации по синхронизации с сайтом вы найдете вот в этом руководстве.
Фид отдает данные в формате JSON.
{
v: 1 => обозначает версию, всегда 1
data: => массив из предложений
discounts: [Array] => массив акций
decorations: [Array] => массив отделок
}Каждый элемент массива data – помещений. Это объект со структурой:
// ID конкретного помещения
"id": 5164
// строковый ID конкретного помещения
"sid": "f8fh9whakejbf89dfohjawfhbiu"
// название проекта и ID внутри ДП
"project": "Квартал у озера"
"project_id": 2144
// название дома и ID внутри ДП
"house": "Дом 1"
"house_id": 12564
// название очереди и ID внутри ДП
// не выводятся, если не дом не привязан к очереди
"stage_title": "5 очередь"
"stage_id": 122
// название секции и ID внутри ДП и номер секции
"section": "Секция Б"
"section_id": 6464
"section_number": 2
// тип помещения, где 0 - квартира, 1 - машиноместо, 2 - кладовая, 3 - офисное помещение
"type": 0
// номер этажа и ID внутри ДП
"floor": 1
"floor_id": 1212
// номер помещения, строка (иногда номера могут быть с буквами и дробями)
"number": "1"
// кол-во комнат - строковый параметр для отображения на плитке
// заведен как "Знак комнатности" в ДП
"rooms_sign": "3+"
"rooms": 2 // кол-во цифрой по документам
// позиция на этажа
"position_on_floor": 3
// евроформат (студийность, где 1 - да, 0 - нет
"is_studio": 0
//статус помещения, где 0 - свободна, 1 - бронь, 2 - оформление договора, 3 - продана, -1 - резерв, -2 - вне учета. Для отображения на сайте рекомендуем работать со статусами 0 - свободно, и 1 - бронь. Все остальные считать проданными
"status": 0
// стоимость помещения, 0 если статус НЕ 0 и НЕ 1
"price": 3990000
// если переуступка, то 1. Если нет, то параметр вообще не передается
"assign": 1
// ID изображения планировки квартиры, возможно использоваться для группировок схожих квартир в единую карточку
"plan_id": 883
// поле из CRM, по которому задана группировка по схожести
"flat_marketing_code": "2К-43,59-44,59"
// площадь помещения
"area": 48.64
// описание к квартире, если выбрано в настройках фида
"description": "Эта квартира такая хорошая..."
// массив тегов к данной квартире
"tags": ['Вид на реку', 'Вид во двор']
// массив акций к этому помещению. Если нет, то параметр не передается
// Содержит номера – это параметр "id" объектов из массива discounts
"discounts": [44, 54]
// ID отделки. Это параметр ID объекта из массива decorations
// Параметр не передается вообще, если нет отделок
"decoration_id": 39
// Название отделки
// Параметр не передается вообще, если нет отделок
"decoration_name": "WhiteBox"
// Стоимость помещения без учета скидки. Появляется только в том случае
// когда на помещение действует скидка со снижением цены
"price_old": 3500400
// Размер скидки на помещения. Появляется только в том случае
// когда на помещение действует скидка со снижением цены
"discount_value": 144 000
// далее массив с изображениями
"images": [{
// первое изображение всегда план с type="plan"
"type": "plan",
"src": "https://storage.yandexcloud.net/.../xxx/yyy.jpg",
// если у плана есть оригинал в SVG, то передаем параметр ниже
"src_svg": "https://storage.yandexcloud.net/.../xxx/yyy.svg",
},{
// type="image" - дополнительные изображения к планировке
"type": "image",
"src": "https://storage.yandexcloud.net/domoplaner/devmedia/xxx/yyy.jpg"
}],
// далее информация о плане этажа, на котором находится помещение
"section_info": {
// ширина изображения этажа
"width": 2200,
// высота изображения этажа
"height": 1400,
// Изображение для этажа
"src": "https://storage.yandexcloud.net/domoplaner/......",
// если у плана этажа есть оригинал в SVG, то передаем параметр ниже
"src_svg": "https://storage.yandexcloud.net/.../xxx/yyy.svg",
// точки полигона, контура квартиры на изображении этажа*
"path": "300,500 390,500 390,595 300,595"
}
* – Считается с левого нижнего угла изображения этажа, сначала Y, потом X (формат leaflet.js).
Для перегона в обычный svg path не забудьте поменять координаты местами,
а координату Y рассчитать как (section_info.height - Y)
/*
Если в настройках фида в ДП включен расширенный режим,
то к каждому помещению будут добавлены дополнительные поля
помещений (только еще проверьте, что включено отображение
этих полей для фидов)
+ список полей ниже
*/
// площадь с учетом коэф. лоджий
"area_koef": 56.32
// площадь без учета лоджий
"area_without": 56.32
// площадь с учетом полных лоджий
"area_full": 56.32
// площадь лоджий полная
"area_loggias": 3.45
// площадь лоджий с коэф
"area_loggias_k": 3.45
// площадь жилая
"area_living": 23.94
// площадь кухни
"area_living": 12.34
// высота потолка
"height": 2.7
// площадь по БТИ
"area_bti": 45.7
// площадь по БТИ жилая
"area_bti_living": 22.7
// площадь по БТИ вспомогательных помещений
"area_bti_add": 12.7
// площадь по БТИ лоджий и балконов
"area_bti_loggias": 4.7Каждый элемент массива discounts – объект со следующим свойствами:
// ID акции
"id": 149
// Заголовок акции из Домопланера
"title": "Скидка 200 000 руб. на 1А и 1Е"
// Текст акции из Домопланера
"text": "Скидка 200 000 рублей на евродвушки типа 1А и 1Е до конца сентября!\nВыбирайте свой идеальный вариант и бронируйте в отделе продаж или по телефону!"
// Ссылка на подробности акции
"site_link": "https://shishkin.life/evro2ka"
// Дата окончания акции
"dt_end": "2022-09-30"Каждый элемент массива decorations – объект со следующим свойствами:
// ID отделки
"id": 149
// Заголовок отделки из Домопланера
"title": "Под ключ"
// Является ли отделкой по умолчанию
"primary": 1Содержание статьи