ym88659208ym87991671
Получение ленты объявлений | Документация SmartMarket
Skip to main content

Получение ленты объявлений

Для обращения к ресурсу необходимо отправлять запрос на:

  • Тестовый контур https://edupirfintech.sberbank.ru:9443

  • Промышленный контур https://fintech.sberbank.ru:9443

Получение ленты объявлений

Шаги

1. Получить AccessToken.

2. Отправить запрос.

Для получения ленты объявлений необходимо отправить GET-запрос (/v1/estate/feed), в котором передать авторизационный токен к данным собственной организации (Access Token). Авторизационный токен передается в параметре Authorization заголовка запроса.

Чтобы получить доступ к ресурсу, необходимо передать в scope сервис ESTATE_FEED.

Модель запроса

НаименованиеОписание
Параметры заголовка
Authorization (String)Access token собственной организации, полученный через SSO.
Пример: Bearer daf9a14c-821d-4bde-9c10-0e56e63d54a0-1

Пример запроса

curl -X GET --header 'Accept: application/json' --header
'Authorization: Bearer daf9a14c-821d-4bde-9c10-0e56e63d54a0-1'
'http://edupirfintech.sberbank.ru:9443/fintech/api/v1/estate/feed'

Модель ответа

НаименованиеОписание
application/xmlЛента объявлений с арендой недвижимости в ЦИАН формате

Пример ответа

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<feed>
<feed_version>2</feed_version>
<object>
<Category>garageRent</Category>
<ExternalId>b313385d-53c5-4662-8402-8a72fa57e186</ExternalId>
<Description>Гараж со всеми удобствами</Description>
<Address>Новосибирск, Печатников 14</Address>
<Coordinates/>
<CadastralNumber></CadastralNumber>
<Phones>
<PhoneSchema>
<Number>79232520828</Number>
</PhoneSchema>
</Phones>
<Garage>
<Type>garage</Type>
</Garage>
<TotalArea>30.0</TotalArea>
<SubAgent>
<LastName>Иванов-Петров Сергей Иванович</LastName>
</SubAgent>
<Photos>
<PhotoSchema>
<FullUrl>
https://efs-sbbol-ift-web.testsbi.sberbank.ru/ic/ufs/rental-property/file-storage/external-consumers?file-name=3588b804-d83d-482e-9057-77e17a10e193.jpeg
</FullUrl>
<IsDefault>true</IsDefault>
</PhotoSchema>
</Photos>
<Building>
<Infrastructure>
<HasCarWash>true</HasCarWash>
<HasCarService>true</HasCarService>
<HasTire>true</HasTire>
<HasBasement>true</HasBasement>
</Infrastructure>
</Building>
<PublishTerms>
<Terms>
<PublishTermSchema>
<DomclickServicesEnum>express</DomclickServicesEnum>
</PublishTermSchema>
</Terms>
</PublishTerms>
<BargainTerms>
<Price>10000.0</Price>
<PrepayMonths>1</PrepayMonths>
<SecurityDeposit>1000</SecurityDeposit>
</BargainTerms>
</object>
</feed>

Состав фида

garageRent

garageRent.xml

НаименованиеОписание
Feed {Фид
feed_versionВерсия фида
ObjectОбъект
CategoryКатегория объявления:
officeRent — Офис
ExternalID (string)Внешний Id объявления
Description (string)Текст объявления
Address (string)Адрес объявления
Coordinates {Координаты местоположения
Lat (double)Широта
Lng (double)Долгота
}
CadastralNumber (string)Кадастровый номер
Phones {Телефон
PhonesShema {
CountryCode (string)Код страны
Number (string)Номер
} }
Garage {Тип гаража
TypeТип:
box — Бокс
garage — Гараж
parkingPlace — Машиноместо
TotalArea (double)Общая площадь, м²
Building {Информация о здании
Infrastructure {Инфраструктура
HasCarWash (boolean)Автомойка
HasCarService (boolean)Автосервис
HasTire (boolean)Шиномонтаж
HasInspectionPit (boolean)Смотровая яма
HasVideoSurveillance (boolean)Видеонаблюдение
HasHourSecurity (boolean)Круглосуточная охрана
HasAutomaticGates (boolean)Автоматические ворота
HasEntryByPass (boolean)Въезд по пропускам
HasBasement (boolean)Подвал/погреб
}
ExtraData {Дополнительные данные для модератора FeedDataForModeration
HomeOwnerName (string)ФИО собственника
} }
BargainTerms {Условия сделки
Price (double)Цена
PrepayMonths (int32)Предоплата, от 1 до 12 месяцев
SecurityDeposit (int64)Обеспечительный платеж
} }

officeRent

officeRent.xml

НаименованиеОписание
Feed {Фид
feed_versionВерсия фида
ObjectОбъект
CategoryКатегория объявления:
officeRent — Офис
ExternalID (string)Внешний Id объявления
Description (string)Текст объявления
Address (string)Адрес объявления
Coordinates {Координаты местоположения
Lat (double)Широта
Lng (double)Долгота
}
CadastralNumber (string)Кадастровый номер
Phones {Телефон
PhonesShema {
CountryCode (string)Код страны
Number (string)Номер
} }
TotalArea (double)Общая площадь, м²
FloorNumber (Int64)Этаж
ConditionTypeСостояние:
cosmeticRepairsRequired — Требуется косметический ремонт
finishing — Под чистовую отделку
majorRepairsRequired — Требуется капитальный ремонт
office — Офисная отделка
IsOccupied (boolean)Помещение занято
IsLegalAddressProvided (boolean)Юридический адрес
FurniturePresenceМебель:
no — Нет
yes — Есть
Building {Информация о здании
FloorsCount (Int64)Количество этажей в здании
HeatingTypeОтопление:
autonomous — Автономное
central — Центральное
no — Нет
ClassTypeКласс:
a — A
aPlus — A+
b — B
bMinus — B-
bPlus — B+
c — C
VentilationTypeВентиляция:
forced — Приточная
natural — Естественная
no — Нет
ConditioningTypeКондиционирование:
central — Центральное
local — Местное
no — Нет
ExtinguishingSystemTypeСистема пожаротушения:
alarm — Сигнализация
gas — Газовая
hydrant — Гидрантная
no — Нет
powder — Порошковая
sprinkler — Спринклерная
AccessTypeВход:
free — Свободный
passSystem — Пропускная система
}
BargainTerms {Условия сделки
Price (double)Цена
PrepayMonths (int32)Предоплата, от 1 до 12 месяцев
SecurityDeposit (int64)Обеспечительный платеж
} }

warehouseRent

warehouseRent

НаименованиеОписание
Feed {Фид
feed_versionВерсия фида
ObjectОбъект
CategoryКатегория объявления:
officeRent — Офис
ExternalID (string)Внешний Id объявления
Description (string)Текст объявления
Address (string)Адрес объявления
Coordinates {Координаты местоположения
Lat (double)Широта
Lng (double)Долгота
}
CadastralNumber (string)Кадастровый номер
FloorNumber (Int64)Этаж
Phones {Телефон
PhonesShema {
CountryCode (string)Код страны
Number (string)Номер
} }
ConditionTypeСостояние:
cosmeticRepairsRequired — Требуется косметический ремонт
majorRepairsRequired — Требуется капитальный ремонт
typical — Типовой ремонт
IsLegalAddressProvided (boolean)Юридический адрес
Building {Информация о здании
FloorsCount (Int64)Количество этажей в здании
TotalArea (double)Общая площадь, м²
HeatingTypeОтопление:
autonomous — Автономное
central — Центральное
no — Нет
TypeТип:
administrativeBuilding — Административное здание
businessCenter — Бизнес-центр
businessCenter2 — Деловой центр
businessHouse — Деловой дом
businessPark — Бизнес-парк
businessQuarter — Бизнес-квартал
businessQuarter2 — Деловой квартал
free — Объект свободного назначения
industrialComplex — Производственный комплекс
industrialPark — Индустриальный парк
industrialSite — Промплощадка
industrialWarehouseComplex — Производственно-складской комплекс
logisticsCenter — Логистический центр
logisticsComplex — Логистический комплекс
logisticsPark — Логистический парк
mansion — Особняк
manufactureBuilding — Производственное здание
manufacturingFacility — Производственный цех
modular — Модульное здание
multifunctionalComplex — Многофункциональный комплекс
officeAndHotelComplex — Офисно-гостиничный комплекс
officeAndResidentialComplex — Офисно-жилой комплекс
officeAndWarehouse — Офисно-складское здание
officeAndWarehouseComplex — Офисно-складской комплекс
officeBuilding — Офисное здание
officeCenter — Офисный центр
officeComplex — Офисный комплекс
officeIndustrialComplex — Офисно-производственный комплекс
officeQuarter — Офисный квартал
old — Старый фонд
other — Другое
outlet — Аутлет
propertyComplex — Имущественный комплекс
residentialComplex — Жилой комплекс
residentialHouse — Жилой дом
shoppingAndBusinessComplex — Торгово-деловой комплекс
shoppingAndCommunityCenter — Торгово-общественный центр
shoppingAndEntertainmentCenter — Торгово-развлекательный центр
shoppingAndWarehouseComplex — Торгово-складской комплекс
shoppingCenter — Торговый центр
shoppingComplex — Торговый комплекс
specializedShoppingCenter — Специализированный торговый центр
standaloneBuilding — Отдельно стоящее здание
technopark — Технопарк
tradeAndExhibitionComplex — Торгово-выставочный комплекс
tradingHouse — Торговый дом
tradingOfficeComplex — Торгово-офисный комплекс
warehouse — Склад
warehouseComplex — Складской комплекс
ClassTypeКласс:
a — A
b — B
c — C
d — D
VentilationTypeВентиляция:
forced — Приточная
natural — Естественная
no — Нет
ConditioningTypeКондиционирование:
central — Центральное
local — Местное
no — Нет
ExtinguishingSystemTypeСистема пожаротушения:
alarm — Сигнализация
gas — Газовая
hydrant — Гидрантная
no — Нет
powder — Порошковая
sprinkler — Спринклерная
GatesTypeТип ворот:
atZero — На нулевой отметке
dockType — Докового типа
onRamp — На пандусе
LiftTypes {Лифт
LiftTypeSchema {
TypeТип лифта:
cargo — Грузовой
passenger — Пассажирский
telpher — Тельфер
}}
Infrastructure {Инфраструктура
HasOfficeSpace (boolean)Офисные помещения
}}
HasTransportServices (boolean)Транспортные услуги
HasSafeCustody (boolean)Ответственное хранение
IsCustoms (boolean)Таможня
BargainTerms {Условия сделки
Price (double)Цена
PrepayMonths (int32)Предоплата, от 1 до 12 месяцев
SecurityDeposit (int64)Обеспечительный платеж
} }

Коды возврата

Код возвратаОписание кода возвратаПричина возникновения
200OK
Успешный код возврата
401UNAUTHORIZED
accessToken not found by value =хххххххх-хххх-хххх-хххх-хххххххххххх-хУказан некорректный или просроченный access_token.
500UNKNOWN_EXCEPTION
Внутренняя ошибка сервера
Обновлено 20 апреля 2022

Заметили ошибку?

Выделите текст и нажмите Ctrl + Enter, чтобы сообщить нам о ней