Общие требования к передаче данных

Общие требования к передаче данных

Общие требования к передаче данных

• Формат передачи данныхКодировка
• Заголовок
• Корневой элемент
• Формат даты
• Требования к фиду и объявлениям в немОсновные требования
• Актуальность
• Сроки публикации
• Цена объекта
• Требования к объявлениям по типам недвижимости

Чтобы объявления попали в базу сервиса Яндекс Недвижимость, подготовьте фид с данными по приведенным ниже требованиям.

Формат передачи данных

Фид с объявлениями для Яндекс Недвижимости составляется на языке YRL (Yandex Realty Language), разработанном в Яндексе. YRL основан на стандарте XML (Extensible Markup Language).

Ограничения:

Нельзя использовать первые 32 ASCII‑символа в текстовых полях.

Исключения: табуляция, перевод строки, возврат каретки.

Необходимо кодировать определенные символы:

Таблица замены символов в YRL‑файле

Символ, который нужно заменить Код для YRL‑файла

" "

& &

>

< <

' '

Кодировка

Кодировка фида — UTF‑8.

Заголовок

YRL‑документ должен начинаться со стандартного XML‑заголовка — нулевого символа первой строки:

Корневой элемент

Корневой элемент YRL‑фида — . Он должен содержать элементы , в каждом из которых — информация из одного объявления. Для удобства можно добавить элемент с датой создания фида.

Чтобы указать пространство имен, используйте атрибут xmlns:

Формат даты

Все даты и время указывайте по стандарту ISO 8601 — в формате YYYY-MM-DDTHH:mm:ss+00:00, где:

• YYYY — год;

• MM — месяц;

• DD — день;

• HH — час;

• mm — минута;

• ss — секунда;

• +00:00 — указание часового пояса (для Москвы — +03:00).

Требования к фиду и объявлениям в нем

Основные требования

Размещение и доступ:

• фид размещен на вашем домене;

• предоставлен в виде URL‑ссылки;

• доступ к фиду постоянно открыт по протоколу HTTP;

• фид доступен круглосуточно.

Формат и структура:

• структура фида соответствует формату YRL;

• фид содержит только валидные объявления (все поля заполнены согласно формату YRL);

• в фиде передются только те параметры, которые указаны в объявлении;

• для нескольких значений одного параметра (например, фотографий) используется несколько одинаковых тегов.

Содержание:

• каждое объявление посвящено одному объекту недвижимости;

• каждое объявление уникально;

• в объявлениях от агентств недвижимости явно указано агентство.

Оформление текстов:

• для оформления текстов объявлений и характеристик объектов разрешено истользовать только тег , при этом символы < и > следует кодировать соответственно таблице замены символов в YRL‑файле;

• другие HTML-теги не поддерживаются.

Обновление:

• чтобы изменить объявление, обновите текущее — не удаляйте его и не создавайте дубликат;

• обновленное объявление должно иметь тот же internal‑id.

Актуальность

Фид должен содержать актуальные объявления — с достоверной информацией о реальном объекте, доступном для покупки или аренды.

Минимальные доли актуальных объявлений:

• 80 % — для объявлений о продаже недвижимости;

• 70 % — для объявлений об аренде недвижимости.

Объявление считается неактуальным, если:

• объект уже продан или сдан в аренду;

• по указанному телефонному номеру невозможно дозвониться;

• цена в объявлении существенно отличается от запрашиваемой;