Технические требования для xml-фида

В этом документе описывается формат фида для агрегатора gdejob.com.

Пример фида вы можете найти по ссылке: https://static.gdejob.com/partners/feed-example.xml

Формат является копией и полностью совместим с форматом YML от компании Яндекс. Формат основан на стандарте XML (Extensible Markup Language).

Описание формата файла списка вакансий

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

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

Документ должен содержать корневой элемент source.

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

Элемент source

Элемент source должен содержать три элемента:

  • creation-time — передает информацию о дате и времени создания данного файла.

  • host — указывает имя хоста доски объявлений.

  • vacancies — содержит объявления о вакансиях.

<source creation-time="2014-06-22 22:00:22 GMT+2" host="www.job.ru"> <vacancies> ... </vacancies> </source>

Формат даты

Дату и время следует указывать согласно стандарту ISO 8601, в формате YYYY-MM-DD HH:mm:ss GMT+-n, где:

  • YYYY — год,

  • MM — месяц,

  • DD — день,

  • HH — час,

  • mm — минута,

  • ss — секунда,

  • GMT+-n — указание часового пояса (например, для Москвы GMT+3).

Элемент vacancies

Список объявлений, размещенных на сайте. Содержит элементы типа vacancy.

<vacancies> <vacancy>...</vacancy> ... </vacancies>

Описание элементов, входящих в элемент vacancy

Элемент Обязательный Описание
url *

URL страницы с объявлением.

Адрес должен быть закодирован в соответствии со стандартом RFC-1738

job-name *

Название должности

description

Описание вакансии.

Внимание. Если в базе данных описание вакансии (обязанности, условия работы, требования и т. п.) не структурировано по отдельным полям, то всю информацию о вакансии следует размещать в этом теге

creation-date *

Дата создания объявления в формате ISO 8601

company *

Информация об организации, предоставляющей вакансию.

Во вложенных тегах детализируется информация об организации.

<company>
 <name/>
 <hr-agency/>
</company>
name * Относится к элементу company

Название организации.

Элемент обязателен только для тега company

hr-agency Относится к элементу company

Если организация является кадровым агентством, то указывается true, в противном случае  — false (элемент обязателен только для тега company)

address *

Адрес места работы.

Во вложенных тегах детализируется информация об адресе.

<address>
 <location/>
 <metro/>
 <lng/>
 <lat/>
</address>

В дополнение к адресу места работы можно указать географические координаты (широту и долготу)

location * Относится к элементу address

Адрес места работы: страна, город, улица, дом (обязательно указывается страна и город)

metro Относится к элементу address

Станция метро

lng Относится к элементу address

Географические координаты: долгота

lat Относится к элементу address

Географические координаты: широта

update-date

Дата обновления объявления в формате ISO 8601

salary

Размер зарплаты.

Формат записи, как и всех полей, требующих указания диапазона. Формат произвольный, например, «от x1 до x2», «x1 — x2», «от x1», «до x2»

currency

Валюта, в которой измеряется зарплата: RUR, USD, EUR или др.

employment

Занятость: полная, частичная, временная, стажировка

schedule

График работы: сменный, гибкий, удаленная работа, вахта

duty

Обязанности

requirement

Требования к соискателю.

Во вложенных тегах указываются отдельные требования.

<requirement> <age/> <sex/> <education/> <experience/> <qualification/> </requirement>
аge

Возраст в годах.

Формат записи, как и всех полей, требующих указания диапазона. Формат произвольный, например, «от x1 до x2», «x1 — x2», «от x1», «до x2»

sex

Пол

education

Образование

experience

Требуемый опыт работы в годах.

Формат записи, как и всех полей, требующих указания диапазона. Формат произвольный, например, «от x1 до x2», «x1 — x2», «от x1», «до x2»

qualification

Требования к квалификации, знания и навыки