Получение ленты объявлений
Обновлено 20 сентября 2023
Для обращения к ресурсу необходимо отправлять запрос на:
Текущий тестовый контур
https://edupirfintech.sberbank.ru:9443
Новый тестовый контур
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://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
Наименование | Описание |
---|---|
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 | ||
Внутренняя ошибка сервера |