Описание формата jooble-Search

Описание формата jooble-Search

1. Общие положения

Сервер jooble принимает запросы методом POST по адресу http://jooble. /Export/XmlSearchResult. ashx/, в котором передается поисковый запрос в формате XML.

Прежде чем начать тестировать данный сервис, Вам необходимо заполнить форму по этому адресу, где следует зарегистрировать список всех IP-адресов, с которых будут приниматься запросы.

2. Формат запроса

<request>

(предпочтительная кодировка)

<preferred_encoding>

utf-8|windows-1251

</preferred_encoding>

(поиск чего)

<entity>

v|r (v – вакансии (по умолчанию); r – резюме)

</entity>

(ключевые слова)

<keywords only_position="0|1">

(only_position="1" – выполнять поиск только в названии должности,

по умолчанию - 1)

<or>

Слова для поиска со спецификатором "или"

</or>

<and>

Слова для поиска со спецификатором "и"

</and>

<not>

Слова для поиска со спецификатором "не"

</not>

(обязательно должны быть указаны ключевые слова для одного из: "or" или "and")

</keywords>

(регион)

<region>

(страна)

<country>

Id страны (Пока единственное поддерживаемое значение - 1 Украина)

</country>

(город)

<city>

Id города (Список id городов – ниже, по умолчанию - 0 «все города»)

</city>

</region>

(зарплата в $)

<salary required="0|1">

(required="1" – выводить только те объявления, в которых указана ЗП,

по умолчанию - 0)

<low>

Число - нижняя граница ЗП

</low>

<high>

Число - верхняя граница ЗП

</high>

</salary>

(дата)

<date type="new|actual">

(new – применять нижеследующий спецификатор для даты добавления объявления в базу, actual – для даты последнего обновления объявления)

last1day|last2day|last3day|last7day|last14day|allday

(последний день, 2 дня, 3 дня, 7 дней, 14 дней, все дни – по умолчанию)

</date>

(номер страницы для возврата, по умолчанию - 1)

<page_no>

N - номер страницы

<page_no>

(количество объявлений на странице, по умолчанию - 10)

<msg_count>

10|20|30|50|100

<msg_count>

(режим сортировки, по умолчанию - relevant)

<sort>

relevant|date|salary

(relevant – по релевантности, date – по дате, salary – по ЗП)

</sort>

(в случае, если одно и то же объявление содержится на нескольких источниках, будут возвращены ссылки на каждый из них; данный параметры – максимально количество возвращаемых источников; по умолчанию - 3)

<src_count>

N - макс. кол-во источников

</src_count>

</request>

3. Формат результатов

В случае успешного выполнения запроса, возвращаются результаты в следующем формате:

<response generated="GMT"> (время когда были сгенерированы результаты в стандартном формате GMT, например: Thu, 19 Apr 2007 11:13:23 GMT)

(общие параметры выборки)

<general>

<msg_count>

N (общее количество объявлений в результатах)

<msg_count>

<page_count>

N (общее количество страниц)

<page_count>

<search_time>

N,NN (время обработки запроса в сек, например «0,35»)

</search_time>

</general>

(список результатов поиска)

<messages count="N" first_no="N" last_no="N">

(count – количество объявлений в выборке, first_no и last_no – порядковые номера первого и последнего объявлений выборки по отношению ко всем результатам

<msg id="Id объявления"> (внутренний уникальный Id)

<number>

порядковый номер

</number>

<position>

должность

</position>

<salary>

ЗП в $

</salary>

<region>

список названий городов через ","

</region>

<desc>

краткое описание (не больше 200 символов)

</desc>

<updated>

N (кол-во дней назад когда объявление было последний раз обновлено, т. е. 0 – сегодня, 1 – вчера, 2 дня назад и т. д.)

</updated>

(список источников (сайтов) на которых было найдено объявление)

<sources count="N">

<source no="N"> (порядковый номер источника)

<name>

Название источника

</name>

<url> (ссылка на объявление на сайте-источнике)

http://...

</url>

</source>

.....

</sources>

<server_url>

http://jooble. /...

(ссылка на сохраненный текст объявления на сайте jooble

аналог «сохранено на сервере»)

</server_url>

</msg>

.....

</messages>

(список релевантных запросу рекламних объявлений)

<advertisements count="N">

<adv id="Id рекламного объявления"> (внутренний уникальный Id)

<position>

должность

</position>

<salary>

ЗП в $

</salary>

<region>

список названий городов через ","

</region>

<desc>

краткое описание

</desc>

<logo_url>

http://jooble. /images/logos/...

(ссылка на рисунок не более 95х50 пикселей – логотип компании-рекламодателя)

</logo_url>

<url>

http://jooble. /DoAdvClick. aspx...

(ссылка на полный текст рекламного объявления)

</url>

</adv>

.....

</advertisements>

</response>

В случае возникновения ошибки, возвращается следующий XML:

<response generated="GMT">

<error code=”N”>

внутреннее описание проблемы

</error>

</response>

В данный момент предусмотрены следующие коды ошибок:

Id	Описание
1	Не указаны ключевые слова для поиска. Минимальными требованиями для выполнения запроса является указание хотя бы одного «значащего» ключевого слова в спецификаторы OR или AND.
2	Сервис временно недоступен
255	Непредусмотренная ошибка

4. Список поддерживаемых регионов

Id	Регион
5	Винница
11	Днепропетровск
12	Донецк
17	Житомир
18	Запорожье
19	Ивано-Франковск
23	Кировоград
29	Кременчуг
30	Кривой Рог
33	Луганск
34	Луцк
35	Львов
38	Мариуполь
40	Николаев
43	Одесса
47	Полтава
49	Ровно
53	Симферополь
58	Сумы
60	Тернополь
63	Ужгород
65	Харьков
67	Херсон
68	Хмельницкий
70	Черкассы
71	Чернигов
72	Черновцы
76	Ялта
78	Киев
79	Севастополь