Функционал XML API / JSON интеграции позволяет вам построить на своем собственном сайте работающую в реальном времени систему онлайн бронирования квартир.

Мы предоставляем партнеру полный доступ к данным о сдающихся квартирах, календарю занятости, другим необходимым параметрам. Все что вам необходимо сделать – это добавить в личном кабинете адрес своего сайта, получить пароль, и приступить к интеграции системы в свой сайт.

Внедрение данной системы позволяет вам мгновенно выйти за рамки своего региона. В настоящий момент мы работаем в трех странах и 15 городах.

Пример XML, с расшифровкой каждого параметра

<id>26</id> 
ID объекта, является уникальным для домена данной страны.

<status>1</status> 
Статус объявления. 
1 - активно, 0 - объявление удалено или находится в архиве. 
Вам необходимо на своей стороне полностью удалить объявление, если пришел статус <status>0</status>

<deleted>0</deleted> 
В настоящий момент не используется.

<title>Минск, ул. Веры Хоружей 16</title> 
City, Street House. 
Заголовок объявления - город, название улицы, номер дома.

<description>
Полное текстовое описание квартиры. Full text description.
Квартира чистая и уютная, находится в непосредственной близости ст. м. «Площадь Якуба Колоса», развитая инфраструктура. Легко доехатьв любой конец города. В квартире сделан современный евроремонт, стеклопакеты, 2-ух спальная широкая кровать, ТV 72 см по диагонали, безлимитный ИНТЕРНЕТ, WI-FI, микроволновка, стиральная машина, электрочайник, посуда. В вашем распоряжении бесплатное пользование компьютером. Рядом ТЦ "Зеркало", ТЦ "Паркинг", Центральный рынок "Комаровка" . Быстрое заселение хозяйкой, убирается горничной с использованием экологической бытовой химией. Официально делаю регистрацию иностранцам, предоставляются кассовые чеки и полный пакет документов для командировочных. В ванной комнате качественная сантехника, есть гель для душа, шампунь, мыло, фен. Всегда в комплекте свежие полотенца. Кухня - встроенная с необходимой бытовой техникой, посудой и столовыми принадлежностями, чай, кофе. Спальных мест 2+1.
</description>

<created>1302018924</created> 
Дата создания объявления. 
В данный момент нигде не учитывается. 
Время указывается в Unix времени (Unix эпоха, Unix epoch, Unix time, POSIX time, Unix timestamp).

<modified>1369126903</modified> 
Дата создания объявления. В данный момент нигде не учитывается.

<authority>12885819393</authority> 
"Вес" объявления. Учитывается при ранжировании, мы рекомендуем ранжировать объявления на своей стороне именно по этому параметру. 
Чем больше цифра, тем больший вес имеет объявление.

<daysLeft>73</daysLeft> 
Дней до конца оплаченного срока размещения. 
Days until ad would be moved to archive. 
В данный момент нигде не учитывается.

<promoType>1</promoType> 
promoType (int) Ad type code (1 - premium, 2 - basic). 
Тип объявления. Премиум - отображаются в системе на приоритетных местах, базовое - стандартное размещение. 
Для премиум объектов мы выводим более крупные фото в общем списке объявлений.

<hits> В данный момент нигде не учитывается. В дальнейшем, этот параметр будет деактивирован.
<day> 5 </day> day (int) Hits today.
<week> 17 </week> week (int) Hits this week.
<month> 178 </month> month (int) Hits this month
<total> 1383 </total> total (int) Hits since creation
</hits>

<links> Прямая ссылка на объявление, уже содержащая ваш партнерский идентификатор (в данном примере ID партнера 2555).
<adsLink> http://dom2.by/minsk/26/?x=2555 </adsLink>

<bookingLink> Прямая ссылка на объявление при запросе, содержащем даты заезда и выезда.
http://dom2.by/cabinet/booking/190/2013-06-05/2013-06-10/?x=2555
</bookingLink>
</links>

<city>
<name>Минск</name> Street in russian. Название города, на русском языке.
<type>г.</type> Тип населенного пункта. В данном примере Город.
<nameInt>Minsk</nameInt> Аналогично для английского языка.
<typeInt>g</typeInt>


<county/> County in russian.
<countyInt/> Transliterated county.

<state> Минская область </state>  State.
<stateInt> Minskaya oblast </stateInt> Transliterated state.
</city>

<street>
<name> Веры Хоружей </name> Название улицы.
<type> ул. </type> Тип.
<nameInt> Veryi-Horuzhey </nameInt> Аналогично для английского языка. Transliterated street name.
<typeInt> str </typeInt> Transliterated city type abbreviation.
</street>


<house> 16 </house> Номер дома. House number.

<price>43</price> Цена в валюте объявлений. Беларусь, Израиль - доллар США, Украина - Украинская гривна.
<priceWeekend>45</priceWeekend> Price for weekend days. Цена выходного дня (с пятницы на субботу и с субботы на воскресенье).

<discount5>5</discount5> Процент скидки. В примере 5%. Discount for booking for more than 5 days.
<discount10>0</discount10> Discount for booking for more than 10 days.
<discount15>0</discount15> Discount for booking for more than 15 days.

<events>0</events> If hosting of events (e.g. parties, birthdays etc) is allowed (0 - no, 1 - yes). 
Возможность проведения мероприятий. 0 - запрещено, 1 - разрешено.

<gps> gps Coordinates. Gps координаты квартиры.
<lat>53.921298</lat> Latitude. Широта.
<lon>27.570985</lon> Longitude. Долгота.
</gps>

<internet>2</internet> Presence of internet (0 - no, 1 - wired, 2 - wifi). Наличие интернет. 0 - отсутствует, 1 - проводной, 2 - wi-fi.

<minBooking> 3 </minBooking> Minimal booking period (days). 
Минимальный период бронирования, дней. 
Задается в интервале от 2 до 5 суток. Обратите внимание, минимальный интервал бронирования - это 2 ночи (по факту, арендодатель у себя в настройках устанавливает не менее чем 3 ночи). 
В запросе, содержащем интервал одни сутки, вы получите пустое значение.

<rooms>1</rooms> Количество комнат. Rooms. 1, 2, 3, 4.

<sleepers1>1</sleepers1> Number of one person sleeping places. Количество двуспальных мест.
<sleepers2>1</sleepers2> Number of two person sleeping places. Количество односпальных мест.
В данном случае выводим как 2+1. При sleepers1 равной 3 будем выводить как 2+2+2+1.

<smoking>0</smoking> Is smoking allowed (0 - no, 1 - yes). 
Курение. 0 - запрещено, 1 - разрешено.

<images> Child nodes <image> value is image url. Has attribute main = 1 if picture is set as main. Прямая ссылка на изображение.
<image main="1"> Главное фото. Для отображения в общем списке объявлений, выводимое как главное в карточке квартиры.
http://dom2.by/public/by/realestate/nasutki/1359409817dsc_8369.jpg
</image>
<image main="0"> Все остальные фото.
http://dom2.by/public/by/realestate/nasutki/1359409835dsc_8376.jpg
</image>
</images>


Ниже приведены поддерживаемые XML API / JSON функции и примеры их использования.

public function actionGetXMLAds ()
При соответствии идентификационного ключа и домена клиента, возвращает объявления соответствующие критерию запроса.
Параметры : 


  • password = идентификационный ключ. Обязательный
  • from = Y-m-d, дата обновления объявлений, возвращает объявления более обновленные чем указанная дата.
  • date_range = Y-m-d_Y-m-d или Y-m-d (data_range=fromDate_toDate), дата начала бронирования квартиры (обязательный параметр при указании параметра data_range[“to”] )
    data_range[“to”] = Y-m-d, дата окончания бронирования. Бронирование работает в интервале (+2 дня от текущей даты) : (+62 дня от текущей даты). В запросе, зашедшем за данный интервал, выдается пустое значение.
  • price =lowPriceInUSD-highPriceInUSD , ценовой интервал за квартиру в долларах (нижняя и верхняя граница включительно). Например price=100-500. отобразит все объявления цена за квартиры в которых начинается со 100 USD и заканчивается 500 USD.
  • city = город расположения квартиры. Название города написанное на русском . Обязательный.

Пример для XML:

http://dom2.by/api/getxmlads?password=750e1cccac49ea9d57bb5e6099cff310165d1a98
http://dom2.by/api/getxmlads?password=17551b0ebe8b49169ec6a110cdf1551f33f86926&data_range=2012-12-12&price=10-300&city=минск


Пример для JSON:

http://dom2.by/api/getjsonads?password=17551b0ebe8b49169ec6a110cdf1551f33f86926&data_range=2012-12-12&price=10-300&city=минск
public function actionGetXMLDates ()
При соответствии идентификационного ключа и домена клиента, возвращает объявления более обновленные чем указано в параметре from и соответствующие другим критерию запроса.
Параметры : 


  • password = идентификационный ключ.
  • from = Y-m-d-H-i-s

Пример:

http://dom2.by/api/getxmlads?password=750e1cccac49ea9d57bb5e6099cff310165d1a98&from=2011-01-05-12-25-18

Пример запроса для получения актуального списка городов с предложениями в системе:

Получить список городов, в которых есть предложения, можно вот так

http://dom2.by/api/getjsoncities?password=17551b0ebe8b49169ec6a110cdf1551f33f86926