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

Формат протоколу DIM.RIA.com XML складається з тегів XML. Для всіх значень даних в DIM.RIA.com XML має використовуватися маскування. Для самого файлу повинно використовуватися кодування кодування UTF-8.
  • Посилання на фото може містити лише латинські літери (a, b, c…), цифри, дефіси і символи підкреслення (_).
  • Максимальна довжина посилання — до 150 символів.
  • Формати фото: jpg, png, jpeg.
  • Кириличні символи (а, б, в…) в URL не допускаються.
  • URL не повинен містити пробіли.
  • Будь-які інші спецсимволи не допускаються.
  • Мінімальний розмір одного фото — 600x600 пікселів.
  • Максимальна вага одного фото — 10 Мбайт.
  • Посилання на фото повинно закінчуватись розширенням файла (.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 символів