Получение ленты объявлений
Обновлено 29 февраля 2024
Для обращения к ресурсу необходимо отправлять запрос на:
Тестовый контур
https://iftfintech.testsbi.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://iftfintech.testsbi.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
| Наименование | Описание |
|---|---|
| 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
| Наименование | Описание |
|---|---|
| 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
| Наименование | Описание |
|---|---|
| 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) | Обеспечительный платеж |
| } } |
Коды возврата
| Код возврата | Описание кода возврата | Причина возникновения | |
|---|---|---|---|
| 200 | OK | ||
| Успешный код возврата | |||
| 401 | UNAUTHORIZED | ||
| accessToken not found by value =хххххххх-хххх-хххх-хххх-хххххххххххх-х | Указан некорректный или просроченный access_token. | ||
| 500 | UNKNOWN_EXCEPTION | ||
| Внутренняя ошибка сервера |