Требования к передаче данных

Фид с объявлениями составляется на XML (Extensible Markup Language). XML не позволяет использовать первые 32 ASCII-символа в текстовых полях (исключения — табуляция, перевод строки, возврат каретки). Также стандарт строго требует кодировать в тексте следующие символы:

Кодировка

Кодировка файла — UTF-8.

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

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

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

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

Корневой элемент XML-фида (realty-feed) должен содержать элемент generation-date с датой создания фида (дата генерации фида, т.е. указывается дата последней генерации фида) и элементы offer, в каждом из которых должна находиться информация из одного объявления. Чтобы указать пространство имен в XML, используйте атрибут xmlns="https://www.kn.kz/schemas/feed/realty/2021".

<realty-feed xmlns="https://www.kn.kz/schemas/feed/realty/2021">
<generation-date>2010-10-05T16:36:00+04:00</generation-date>
 <offer>
  ...
 </offer>
 ...
</realty-feed>

Весь контент располагать внутри тега. Аттрибуты не указанные в этом руководстве будут игнорироваться при обработке фида.

Формат даты

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

• YYYY — год;

• MM — месяц;

• DD — день;

• HH — час;

• mm — минута;

• ss — секунда;

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

• Фид с объявлениями необходимо разместить на своем домене и предоставить в виде URL-ссылки.
• Структура фида должна соответствовать формату XML.
• Фид должен содержать только валидные объявления. Валидным считается объявление, для которого все поля фида заполнены согласно формату XML.
• В фиде надо передавать только те параметры, которые указаны в объявлении.

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

• Каждое объявление должно быть посвящено одному объекту недвижимости.
• В каждом объявлении, размещенном агентством недвижимости, должно присутствовать явное указание на агентство.
• Чтобы добавить новую информацию в объявление, необходимо обновить существующее объявление, но не удалять и не дублировать его. Обновленное объявление должно иметь тот же internal-id.
• В текстах объявлений и в описании характеристик объектов не должно быть HTML-кода.
• Фид должен содержать актуальные объявления. Актуальным считается объявление, содержащее достоверную информацию о реальном объекте, который можно купить или арендовать.

  Объявление считается неактуальным, если объект уже продан, сдан в аренду, по указанному телефонному номеру невозможно дозвониться, цена в объявлении существенно отличается от запрашиваемой, не совпадает адрес или другие параметры.