ГлавнаяО проектеПомощь

Технические требования

Технические требования

Стандарт XML не допускает наличие символов с ASCII-кодами в диапазоне значений от 0 до 31 (за исключением значений 9, 10, 13 — табуляция, перевод строки, возврат каретки) в текстовых полях. Также этот стандарт строго требует заменять в тексте все следующие символы.

Символ в тексте Код для XML
" "
& &
> >
< &lt;
' &apos;

Требования к XML-файлу

  1. В фиде должны передаваться все актуальные объявления.
  2. В данных не допускается присутствие HTML-тегов.
  3. URL фида должен быть постоянным и доступным по протоколу HTTP (в разделе «Вопросы и ответы » есть инструкция, как можно ограничить доступ к фиду).
  4. URL объявления должен быть постоянным. Объявления, поступающие от Партнёров через фиды, должны обновляться, а не удаляться и создаваться заново.
  5. Если для объявления есть несколько значений одного параметра (например, несколько фото), то нужно передавать несколько одинаковых тегов.
  6. Цену объявления надо передавать только в той валюте, которую указал владелец объявления.
  7. В фиде надо передавать только те параметры, которые ввел податель объявления (например, если геокоординаты и/или время до метро и/или метро вычисляются автоматически, передавать их не надо).

    Если для объявления нет какого-то параметра (податель объявления не указал этот параметр при размещении), то не надо передавать соответствующий тег.

Описание формата

Заголовок документа

<?xml version="1.0" encoding="UTF-8"?>

Стандартный XML-заголовок. Заголовок должен начинаться с первой строки, с нулевого символа.
Документ должен содержать корневой элемент realty.
Фид должен быть в кодировке UTF-8.

Элемент realty

<realty>
   <generation-date>2010-10-05 16:36:00 +07:00</generation-date>
   ...
</realty>

generation-date — содержит информацию о дате и времени создания данного файла

Формат даты YYYY-MM-DD HH:mm:ss +04:00

YYYY — год
MM — месяц
DD — день
HH — час
mm — минута
ss — секунда
+ 07:00 — указание часового пояса (в данном случае — для Новосибирска).

Описание параметров, входящих в элемент <offer>

У элемента <offer> есть обязательный атрибут id — id объявления в вашей базе.
Обязательные элементы отмечены символом «*».
Элементы, содержащие текстовые поля с пометкой «строго ограниченные значения», должны содержать только те значения, которые указаны. Использование других значений будет считаться ошибкой.

Элементы Описание
url* Адрес объявления на вашем сайте
type* тип сделки («продажа», «аренда»)
property-type* категория объекта («квартира», «новостройка», «коммерческая», «коттеджи, дома, дачи», «земля», «гараж»)
category*

«квартира» или «новостройка» («1», «2», «3», «4», «5», «6», «2—эт», «СОТ», «СРТ», «КСС», «2КСС», «3КСС», «КГС», «2КГС», «2СРТ»)

коммерческая («готовый бизнес», «офисное помещение», «торговые площади», «универсальное помещение», «производственное помещение»)

коттеджи, дома, дачи («дом», «часть дома», «коттедж», «часть коттеджа», «дача»)

земля («землеотвод», «садовый участок», «коммерческая земля», «земельный участок»)

гаражи («железный гараж», «капитальный гараж», «парковочное место»)

location* набор тегов, описывающих местоположение объекта
country* Страна
city* Город
district* Район
street* Улица
house* Номер дома
house-material Материал дома («кирпич», «панель», «дерево»)
plans* Планировка квартиры («Нб», «Хр» — хрущевка, «НХ» — не хрущевка, «Ваг» — вагончик, «Р» — раздельная, «УП» — улучшенная планировка, «СИ» — смежно-изолированная, «См» — смежная, «НС» — нестандартная, «ПМ» — полнометражная, «Ст» — стандартная, «Св» — свободная, «Эл» — элитная, «Хит» — хитаровская)
floor* Этаж
floor-total* Этажность
area* общая площадь
living-space жилая площадь
kitchen-space площадь кухни
value* площадь (числовое значение)
unit* единица площади (рекомендуемые значения — «кв. м.» или «сот.», «га» в обявлениях о земле)
comunication коммуникации «телефон», «интернет»
wc Санузел («Р» — раздельный, «с» — совмещенный)
balcony «Б» — балкон, «Л» — лоджия, «БЛ» — балкон + лоджия, «2Б» — два балкона, «3Б» — 3 балкона, «4Б» — 4 балкона, «5Б» — 5 балконов, «2Л» — 2 лоджии, «3Л» — 3 лоджии, «4Л» — 4 лоджии, «Эр», «Б,Эр», «Л,Эр», «2ЛТер», «2Л,Эр», «Б2Л» — балкон + 2лоджии, «2БЛ» — 2балкона + лоджия, «Бз» балкон, застеклен, «Лз» — лоджия, застеклена, «БЛз»
description Описание
code-adv Код объявления в вашей базе будет виден пользователям
sales Группа тегов о продавце
name Имя риелтора, название компании писать не надо
phone Телефон риэлтора или офиса
email Адрес элетронной почты
photos Группа тегов с фотографиями объекта
photo Адрес фотографии объявления