Доска бесплатных объявлений BON.ua
Разместить объявление
Правила заполнения xml файла

Для всех значений данных в XML должно использоваться маскирование. Для самого файла должна использоваться кодировка UTF-8.

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

1. Фид должен содержать только актуальные объявления.

2. В данных не допускается присутствие HTML-тегов.

3. URL фида должен быть постоянным и доступным по протоколу HTTP.

4. Объявления, поступающие от Партнёров через фиды, должны обновляться, а не удаляться и создаваться заново.

Маскирование символов

Для фида должна использоваться кодировка UTF-8. Как это принято для всех файлов XML, все значения данных (включая URL) должны использовать маскирование сущностей для символов, перечисленных в таблице ниже.

Символ   Маскирование
Амперсанд & &
Одинарные кавычки ' '
Двойные кавычки " "
Больше > >
Меньше < &lt;
Описание тегов и возможных значений для заполнения xml файла:

Заголовок документа (XML header)

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

Заголовок должен начинаться с первой строки, с нулевого символа.

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

<?xml version="1.0" encoding="UTF-8"?>
    <realities date-create="2017-12-21T23:39:15+03:00">
        ...
    </realities>

Формат даты

Формат даты YYYY-MM-DDTHH:mm:ss+03:00. Стандартный формат ISO 8601

Дата и время создания файла на стороне доски объявлений.

YYYY — год

MM — месяц

DD — день

HH — час

mm — минута

ss — секунда

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

Также элемент realities должен содержать хотя-бы один элемент reality, описывающий содержимое объявления. Каждому элементу reality соответствует одно объявление в базе партнера.


Описание тегов:
<realities>
Корневой контейнер c датой создания xml
<reality>
Контейнер одного объявления
<local_reality_id>
Ваш идентефикатор объявления, только цыфры
</local_reality_id>
<state>
АР Крым, Винницкая, Волынская, Днепропетровская, Донецкая, Житомирская, Закарпатская, Запорожская, Ивано-Франковская, Киевская, Кировоградская, Луганская, Львовская, Николаевская, Одесская, Полтавская, Ровенская, Сумская, Тернопольская, Харьковская, Херсонская, Хмельницкая, Черкасская, Черниговская, Черновицкая
</state>
<city>
Город с заглавной буквы, например, Житомир
</city>
<category>
Категория со всеми уровнями через "/", например Оборудование/Металлоискатели
</category>
<title>
Заголовок, должен быть от 3 до 70 символов
</title>
<description>
Описание, должно быть от 16 до 2000 тысяч символов
</description>
<telephone>
Телефон, до 5 штук через запятую, от 6 цыфр за телефон
</telephone>
<photos_urls>
<loc>
Ссылка на фотографию должна быть https, не более 10 штук, должны быть вложены в <photos_urls>
</loc>
<no>
Если у вас нет фото оставляет только теги <photos_urls> </photos_urls>
</no>
</photos_urls>
<characteristics>
Контейнер для свойств категории
</characteristics>
<hash>
hash объявления для отслеживания изминения
</hash>
<image_hash>
hash изображений объявления для отслеживания изминения
</image_hash>
<paid_services>
Блок который содержит в себе платьные услуги
<top>
</top>
<type>
</type>
<attention>
</attention>
<original_text>
</original_text>
</paid_services>
</reality>
</realities>
Выберите город и категорию для показа правил заполнения тега
<characteristics>
<characteristics>
</characteristics>
Выберите конечную категорию!