XML-импорт на DIM.RIA

Формат протокола DIM.RIA.com XML состоит из тегов XML. Для всех значений данных в DIM.RIA.com XML должно использоваться маскирование. Для самого файла должна использоваться кодировка кодировка UTF-8.
  • Ссылки на фото могут содержать только латинские буквы (a, b, c…), цифры, дефисы и символы подчеркивания (_).
  • Максимальная длина ссылки — до 150 символов.
  • Форматы фото: jpg, png, jpeg.
  • Кириллические символы (а, б, в…) в URL не допускаются.
  • URL не должен содержать пробелы.
  • Любые другие спецсимволы не допускаются.
  • Минимальный размер одного фото — 600x600 пикселей.
  • Ссылка на фото должна заканчиваться расширением файла (.jpg, .png, .jpeg).
  • Фото должно загружаться с 200-м HTTP статус кодом без каких-либо редиректов.
  • Фид должен содержать только актуальные объявления.
  • В данных не допускается присутствие HTML-тегов.
  • URL фида должен быть постоянным и доступным по протоколу HTTP.
  • Объявления от партнеров, поступающие через фиды, должны обновляться, а не удаляться и создаваться заново.
  • Значения всех тегов (параметров) должны быть указаны либо на русском либо на украинском языке. Мы автоматически переведем информацию на другой язык.
  •  
  • Для фида должна использоваться кодировка UTF-8. Как это принято для всех файлов XML, все значения данных (включая URL) должны использовать маскирование сущностей для символов, перечисленных в таблице ниже.
  • Символ Маскирование
    Амперсанд & &
    Одинарные кавычки ' '
    Одинарные кавычки " "
    Одинарные кавычки > >
    Одинарные кавычки < &lt;
  •  
  • Заголовок документа (XML header)
  • <?xml version='1.0' encoding='UTF-8'?>
  • Заголовок должен начинаться с первой строки, с нулевого символа.

    Документ должен содержать корневой элемент реальности realties.
    В корневом элементе обязательно должен присутствовать элемент generation_date, содержащий информацию о дате и времени создания данного файла.

  • <?xml version="1.0" encoding="UTF-8"?>
                        <realties xmlns="https://dom.ria.com/xml/xsd/"
                                xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
                                xsi:schemaLocation="https://dom.ria.com/xml/xsd/
                                https://dom.ria.com/xml/xsd/dom.xsd">
                        </realties>
                      
  •  
  • Формат даты YYYY-MM-DDTHH:mm:ss+03:00. Стандартный формат ISO 8601 (http://en.wikipedia.org/wiki/ISO_8601)
  • Дата и время создания файла на стороне доски объявлений.
  • YYYY — год
  • MM — месяц
  • DD — день
  • HH — час
  • mm — минута
  • ss — секунда
  • +03:00 — указание часового пояса (в данном случае — для Киева).
    Корневой элемент realties должен содержать елемент lang_id, где значение 4 - считывается как наполнение фида на украинском языке, а значение 2 - на русском. Без указания данного элемента по умолчанию считаем, что фид прописан на украинском языке. (Пример <lang_id>4</lang_id>)

  • Також елемент realties повинен містити хоча-б один елемент realty, описує вміст оголошення. кожному елементу realty відповідає одне оголошення в базі партнера.
  •                     <?xml version="1.0" encoding="UTF-8"?>
                        <realties xmlns="https://dom.ria.com/xml/xsd/"
                                xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
                                xsi:schemaLocation="https://dom.ria.com/xml/xsd/
                                https://dom.ria.com/xml/xsd/dom.xsd">
                            <generation_date>2023-07-25T11:10:39+03:00</generation_date>
                            <realty>
                                <advert_type>Продаж</advert_type>
                                <realty_type>Квартира</realty_type>
                            </realty>
                        </realties>
                      
Какие тэги можно использовать в моей рубрике?
Любой тип операции
Все категории
Все типы недвижимости
Всего доступно тегов: , из них обязательных:
activeFeedIndex = 0 / maxFeedIndex = 0 feedPhotoUrls=[]
form={ "realtyTypeParentId": 0, "realtyTypeId": 0, "operation": 0 }
feedRealty={}
xmlFeed=[]
Название тэга
Описание
Тип
Правила и допустимые значения
Базовые параметры
email * Электронный адрес пользователя, от которого будет размещено объявление Строка (string) Для успешного импорта нужно указать один из обязательных параметров: email или phone. На сайте DIM.RIA.com должен быть зарегистрирован пользователь с таким электронным адресом или номером телефона. Этот пользователь должен быть администратором или прикреплённым сотрудником в агентстве, для которого осуществляется импорт
phone * Номер телефона пользователя, от которого будет размещено объявление Строка (string) В поле phone допускается указание только одного мобильного номера телефона в формате "+38(0XX) XXX-XX-XX" или "(0XX) XXX-XX-XX" или "0XXXXXXXXX"
local_realty_id * ID объявления в базе партнера (в вашей базе) Строка (string) Не более 10 цифр
advert_type * Тип операції Строка (string)
realty_type * Тип недвижимости Строка (string)
realty_sale_type Тип объекта недвижемости Целое (integer) Содержит значения типа объекта для объявлений. Соответствие значений: 1- Вторичная недвижимость, 2 - Новострой. Значение по умолчанию: 1. Значения допустимы для рубрики "Квартиры", "Комнаты", "Дома", "Коммерческая недвижимость"
Фото
photos_urls Контейнер для фото Контейнер Минимум 5 фото
loc Ссылка на фото Строка (string) Может находится только внутри контейнера «photos_urls». В элементе «loc» указан адрес, по которому размещен файл фото. The URL must conform to RFC 2396 (http://www.ietf.org/rfc/rfc2396.txt). Может содержать атрибут «crc», в котором указывается контрольная сумма для файла фотографии. Если этот атрибут будет указан, то при последующих загрузках фида, в случае если значение контрольной суммы не изменилось, не будет происходить обращение к файлу фото. Таким образом снижается нагрузка на ресурс, на котором размещены фото.
Видео
youtube_link Ссылка на видео Строка (string) Полная ссылка на видео, загруженная на Youtube. Например ("https://www.youtube.com/watch?v=MfEKUnQCypw&list=UU2DjSrXJytSfu-9Fy7A_P0A&index=89")
Расположение
state * Название области Строка (string) Пример: «Винницкая», «Киевская», «Одесская»
city * Название города Строка (string) Пример: «Винница», «Киев»
district Район города Строка (string) Название района из базы DIM.RIA.com
metro Станция метро Строка (string) Название станции метро из базы DIM.RIA.com
street Название улицы Строка (string) Название улицы без ее типа
street_type Тип улицы Строка (string) «аллея», «бульвар», «въезд», «гавань», «дорога», «дуга», «майдан», «массив», «мост», «набережная», «остров», «парк», «переезд», «переулок», «плато», «площадь», «пляж», «поселок», «проезд», «проспект», «сквер», «тупик», «улица», «хутор», «шоссе», «1-й км.», «1-й въезд», «2-й въезд», «3-й въезд», «4-й въезд», «4-й проезд», «5-й проезд», «6-й проезд», «5-й въезд», «1-й тупик», «2-й тупик», «3-й тупик», «4-й тупик», «5-й тупик», «6-й тупик», «7-й тупик», «1-й переулок», «2-й переулок», «3-й переулок», «4-й переулок», «5-й переулок», «6-й переулок», «7-й переулок», «8-й переулок», «9-й переулок», «10-й переулок», «11-й переулок», «12-й переулок», «13-й переулок», «1-й проезд», «2-й проезд», «3-й проезд», «1-й проспект», «2-й проспект», «1-я линия», «2-я линия», «4-я линия», «5-я линия», «1-я улица», «2-я улица», «3-я улица», «4-я улица», «5-я улица», «6-я улица», «7-я улица», «8-я улица», «9-я улица», «10-я улица», «11-я улица», «12-я улица», «13-я улица», «14-я улица», «15-я улица», «16-я улица», «17-я улица», «18-я улица», «19-я улица», «20-я улица», «21-я улица», «22-я улица», «23-я улица», «24-я улица», «25-я улица», «26-я улица», «27-я улица», «28-я улица», «29-я улица», «30-я улица», «31-я улица», «32-я улица», «33-я улица», «34-я улица», «1-й спуск», «2-й спуск»
longitude Географические координаты (долгота) Число с плавающей точкой(float)
latitude Географические координаты (широта) Число с плавающей точкой(float)
radius_location Показывать зону(область), вместо точных координат Строка (string) «да», «нет». По умолчанию: нет
Описание
description Описание объекта (рус) Строка (string) Длина описания должна быть не более 2000 символов
description_uk Описание объекта (укр) Строка (string) Длина описания должна быть не более 2000 символов