POST /properties — подача объекта

Подаёт объект недвижимости на MLS. После подачи объект проходит внутреннюю проверку.

Бизнес-описание процесса: Подача объекта на MLS

Доступ

Требуется API-ключ.

Тело запроса

Поле	Тип	Обязательное	Описание	Допустимые значения
`property_type`	string	да	Тип объекта	Квартира, Дом, Таунхаус, Коммерция, Земля
`deal_type`	string	да	Тип сделки	Продажа, Долгосрочная аренда, Посуточная аренда
`price`	decimal	нет	Цена
`description`	string	нет	Описание объекта
`owner`	object	нет	Собственник объекта
`location`	object	нет	Адрес объекта
`attributes`	object	нет	Атрибуты объекта (ключ — имя атрибута, значение — строка)

owner

Собственник идентифицируется по номеру телефона. Если собственник с таким телефоном уже существует — данные обновляются, иначе создаётся новый.

Поле	Тип	Обязательное	Описание
`name`	string	да	ФИО собственника
`phone`	string	да	Телефон в любом формате (нормализуется по стране листинг-агента)
`notes`	string	нет	Заметки

location

Поле	Тип	Обязательное	Описание
`city_id`	integer	да	ID города
`district_id`	integer	нет	ID района
`residential_complex_id`	integer	нет	ID жилого комплекса
`address`	string	нет	Полный адрес
`street`	string	нет	Улица
`house_number`	string	нет	Номер дома
`apartment_number`	string	нет	Номер квартиры
`latitude`	decimal	нет	Широта
`longitude`	decimal	нет	Долгота

attributes

Объект key: value, где ключ — имя атрибута, значение — всегда строка. API автоматически распознаёт и конвертирует типы на входе.

Справочник атрибутов

Основные характеристики

Атрибут	Название	Допустимые значения
`area`	Общая площадь, м²	number
`rooms`	Количество комнат	integer
`floor`	Этаж	integer
`total_floors`	Этажность дома	integer
`kitchen_area`	Площадь кухни, м²	number
`living_area`	Жилая площадь, м²	number
`ceiling_height`	Высота потолков, м	number
`year_built`	Год постройки	integer
`bedrooms`	Количество спален	integer

Строение

Атрибут	Название	Допустимые значения
`building_type`	Тип строения	Панельный, Кирпичный, Монолит, Металлокаркас, Деревянный
`wall_material`	Материал стен	Кирпич, Газоблок, Дерево, СИП-панели, Каркас, Полистиролбетон
`foundation`	Фундамент	Ленточный, Плитный, Свайный
`roof_type`	Тип крыши	Плоская, Двускатная, Вальмовая
`entrance`	Подъезд	integer

Состояние и ремонт

Атрибут	Название	Допустимые значения
`condition`	Состояние	Без ремонта, Косметический, Евроремонт, Дизайнерский
`furniture`	Мебель	Без мебели, Частично, Полная
`window_type`	Окна	Пластиковые, Деревянные, Алюминиевые

Площади

Атрибут	Название	Допустимые значения
`area_land`	Площадь участка, сот.	number
`area_commercial`	Торговая площадь, м²	number
`area_warehouse`	Складская площадь, м²	number

Санузел и балкон

Атрибут	Название	Допустимые значения
`bathroom`	Санузел	Совмещённый, Раздельный
`bathroom_count`	Количество санузлов	integer
`balcony`	Балкон	Нет, Балкон, Лоджия, Терраса
`balcony_glazed`	Балкон застеклён	`"true"` / `"false"`

Парковка

Атрибут	Название	Допустимые значения
`parking`	Парковка	Нет, Двор, Подземная, Гараж, Наземная
`parking_count`	Количество парковок	integer

Коммуникации

Атрибут	Название	Допустимые значения
`heating_type`	Тип отопления	Центральное, Автономное, Нет
`internet`	Интернет	Нет, Проводной, Оптика, DSL, Мобильный (4G/5G)
`gas`	Газ	Центральный, Баллон, Газгольдер, Нет
`water`	Водоснабжение	Центральное, Скважина/колодец, Нет
`sewage`	Канализация	Центральная, Септик, Нет
`electricity`	Электричество	Есть, Рядом, Нет
`electricity_power`	Мощность электричества, кВт	integer
`phone`	Телефон	`"true"` / `"false"`

Особенности

Атрибут	Название	Допустимые значения
`elevator`	Лифт	`"true"` / `"false"`
`is_corner`	Угловая	`"true"` / `"false"`
`isolated_rooms`	Изолированные комнаты	`"true"` / `"false"`
`storage`	Кладовка	`"true"` / `"false"`
`quiet_yard`	Тихий двор	`"true"` / `"false"`
`kitchen_studio`	Кухня-студия	`"true"` / `"false"`
`new_plumbing`	Новая сантехника	`"true"` / `"false"`
`built_in_kitchen`	Встроенная кухня	`"true"` / `"false"`

Безопасность

Атрибут	Название	Допустимые значения
`security`	Охрана	`"true"` / `"false"`
`security_intercom`	Домофон	`"true"` / `"false"`
`security_video`	Видеонаблюдение	`"true"` / `"false"`
`security_alarm`	Сигнализация	`"true"` / `"false"`
`security_fire_alarm`	Пожарная сигнализация	`"true"` / `"false"`
`security_coded_lock`	Кодовый замок	`"true"` / `"false"`
`security_concierge`	Консьерж	`"true"` / `"false"`

Коммерческая недвижимость

Атрибут	Название	Допустимые значения
`commercial_type`	Назначение	Офис, Торговое, Склад, Производство
`has_showcase`	Витрины	`"true"` / `"false"`
`separate_entrance`	Отдельный вход	`"true"` / `"false"`

Земля

Атрибут	Название	Допустимые значения
`land_category`	Категория земли	ИЖС, СНТ, ЛПХ, Коммерческое
`land_status`	Статус земли	В собственности, В аренде
`communications_nearby`	Коммуникации рядом	`"true"` / `"false"`
`road_access`	Подъездная дорога	Асфальт, Гравий, Грунтовая, Нет

Юридическое

Атрибут	Название	Допустимые значения
`is_pledged`	В залоге	`"true"` / `"false"`
`is_installment`	Рассрочка	`"true"` / `"false"`
`is_exchange`	Обмен	`"true"` / `"false"`
`is_privatized`	Приватизирована	`"true"` / `"false"`
`documents_ready`	Документы готовы к сделке	`"true"` / `"false"`
`encumbrance`	Обременение	`"true"` / `"false"`
`ownership_type`	Тип собственности	Частная собственность, Долевая собственность, Государственная

Запрос

{
  "property_type": "Квартира",
  "deal_type": "Продажа",
  "price": 150000,
  "description": "Просторная квартира с видом на море",
  "owner": {
    "name": "Иван Петров",
    "phone": "87011234567"
  },
  "location": {
    "city_id": 1,
    "district_id": 3,
    "address": "ул. Примерная, д. 42, кв. 7",
    "street": "Примерная",
    "house_number": "42",
    "apartment_number": "7",
    "latitude": 34.707,
    "longitude": 33.022
  },
  "attributes": {
    "rooms": "3",
    "floor": "5",
    "total_floors": "9",
    "area": "85.5",
    "condition": "Евроремонт",
    "balcony": "Лоджия",
    "elevator": "true",
    "parking": "Подземная"
  }
}

Нормализация телефона

Телефон 87011234567 будет нормализован до +7 701 123-45-67 на основе страны листинг-агента.

Ответы

201 Created — собственник найден201 Created — собственник создан400 Bad Request401 Unauthorized

{
  "id": 42,
  "status_id": 1,
  "status_name": "new",
  "owner": {
    "id": 10,
    "created": false
  }
}

{
  "id": 42,
  "status_id": 1,
  "status_name": "new",
  "owner": {
    "id": 15,
    "created": true
  }
}

{ "detail": "property_type is required" }

{ "detail": "Invalid or missing API key" }

События

После одобрения объекта публикуется событие mls.new_listing.