Продажа Аренда Спрос Компании Работа События

Вход

Логин:
Пароль:
	запомнить
Забыли пароль?

Регистрация Регистрация позволяет смотреть контакты прямых объектов, зарегистрироваться в компаниях, работать с картой Киева, метро, блокнотом, получать рассылку новых поступлений.

Добавить объект Даже не зарегистрированным пользователям доступна возможность бесплатно добавлять свои объекты в общую базу.

XML API позволяет владельцам сайтов недвижимости быстро подключить свой сайт к поисковому роботу КиевБазы, передать информацию об объектах КиевБазе, тем самым позволяя пользователям быстро находить Ваши объекты и получить новых клиентов, трафик на сайт.

Список терминов:
Сайт-источник - веб-ресурс (сайт, портал, пр.) который передает или хочет передать КиевБазе информацию о своих объектах.
КБ - сокращение от КиевБаза.

Общая информация о протоколе:
Для передачи объектов с сайта источника на портал КиевБаза – используется XML API.
Сайт-источник формирует XML-файл, делает его доступным по протоколу HTTP (например, http://yoursitename.com/kievbaza.xml) и передает эту ссылку в техническую поддержку портала КБ.
КБ делает запрос на эту ссылку 1 раз в 24 часа (по умолчанию), таким образом, получая информацию о новых/старых объектах на сайте-источнике.
Ссылки к XML-файлам высылайте на адрес support@kievbaza.com

Примеры xml-файлов:
http://kievbaza.com/docs/xml-api/example-1.xml

Внимание!
Настоятельно рекомендуется формировать XML-файл “на лету” (по запросу), а не сохранять его (не кэшировать).
Кодировка XML значения не имеет, сайт может передавать информацию в любой кодировке. Тем не менее, не забывайте явно указывать выбранную кодировку в заголовке XML.

Описание полей XML-файла (протокол):

• id - в данном поле Вы должны указать уникальный ключ (идентификатор), под которым храниться объект на Вашем сайте-источнике.
  Поле будет использоваться в момент синхронизации XML-файла и базы портала КБ.
  Обязательное поле.
  Может принимать как числовые, так и символьные значения до 32х знаков.
  
• address - адрес объекта. Обязательное поле.
  С 2009-06-01 поле address содержит три элемента:
  
  • city - город (обязательное поле).
    В данный момент принимаются объекты только для города Киева и киевской области.
    Если объект не Киевский или находится вне зоны 150 км от Киева - он не будет добавлен в КиевБазу.
  • street - улица (опционально для городов киевской области, обязательное - для Киева).
    
  • house - номер дома (опционально)
  
  Обратите внимание, город и улицу необходимо указывать на русском языке, иначе добавление объекта не гарантируется.
• name (опционально) - название объекта, короткий заголовок. До 100 любых символов. HTML-код, повторяющиеся пробелы и пр. - игнорируются.
  
• description - Содержимое объявления. До 1000 символов. HTML-код, повторяющиеся пробелы и пр. - игнорируются.
  Обязательное поле.
  
• area - числовое значение общей площади объекта.
  Обязательное поле для объектов города Киева.
  
• price - блок цены. Содержит два под-блока:
  
  • sum - сумма. Обязательное поле.
  • currency - валюта. Валюта может принимать значения usd, euro, uah. Если ничего не указывать - по умолчанию usd.
• url - ссылка на дополнительную информацию по объекту.
  Не обязательное поле.
  Тем не менее, рекомендуем указывать ссылку на ваш на вашем сайте.
  Ссылка должна начинаться с http://
• images - блок картинок к объекту. Содержит набор блоков image.
  
  • image - содержит два поля: url и name.
    
    • url - полный адрес картинки. На данный момент принимаются только форматы image/jpeg и image/pjpeg.
      
    • name - название/описание картинки, на данный момент не используется.
      
• labels - содержит записи меток, в которые должен входить объект.
  Метки указываются в свободном порядке через запятую или пробел.
  КиевБаза анализирует содержимое и принимает решение, в какую категорию на портале размещать объект.
  Примеры корректных записей в поле labels:
  
  • аренда, офис
  • sale, office
  • rent, magazine
  • rent, flat
  • rent, flat1
  • продажа, квартира
  • продажа, квартира 1
  • продажа, квартира-1
  • rent, flat 2
  • и т.д. в любом подобном формате

Документация обновлена: 2009-08-19.

По всем техническим вопросам, вопросам касательно расширенных XML API функций, вопросам, связанных с подключением - обращайтесь на email support@kievbaza.com.