Получение статуса и результатов поискового запроса

Для того, чтобы получить статус или результаты (туры) по запущенному поисковому запросу, необходимо передать идентификатор requestid GET запросом на адрес:

http://tourvisor.ru/xml/result.php

Также передается параметр type, который определяет ответ. type=status – в ответе передается только статус запроса (для отслеживания прогресса поиска), type=result – в ответе передаются текущие результаты поиска + статус запроса. Если параметр type не указан, то выдаются результаты + статус (т.е. по умолчанию type=result).

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

Параметры запроса:

• requestid – идентификатор запроса, который мы получили при вызове search.php (этот параметр является обязательным!)
• type - что получаем в ответе. status - только статус запроса, result - результаты (туры) + статус. По умолчанию - result
• page – страница результатов поиска, которую нужно загрузить (по умолчанию = 1). За один раз выдается ограниченное количество отелей (см.следующий параметр onpage). Если этого количества недостаточно, можно загрузить больше результатов, указав page=2, затем page=3 и т.д. (этот параметр не является обязательным)
• onpage – сколько отелей выдавать на одной странице (по умолчанию 25) (этот параметр не является обязательным)
• nodescription – если этот параметр = 1, то краткое описание отеля не передается (удобно, если Вы его не используете, чтобы уменьшить объем передаваемой информации)
• operatorstatus – если = 1, передает расширенный статус по операторам (показывает какие операторы были найдены, минимальная цена и количество найденных отелей по каждому туроператору)

Блок статуса (status) содержит следующую информацию:

• state – статус поиска: searching – идет поиск, finished – поиск завершен
• hotelsfound – количество отелей, которое уже найдено
• toursfound – количество туров, которое уже найдено
• minprice – минимальная цена, найденная на текущий момент
• progress – прогресс поиска – сколько % завершено (например, 40 или 70)
• timepassed – сколько времени в секундах прошло с начала поиска
• массив operators – (если указан параметр operatorstatus=1) – содержит информацию об уже найденных туроператорах (код, минимальная цена, кол-во отелей).

Результаты выдаются сгруппированными по отелям.

Блок результатов (result) содержит массив элементов hotel, в которых содержится:

• hotelcode – код отеля
• price – цена в рублях (минимальная по этому отелю)
• countrycode – код страны
• countryname – название страны (на русском)
• regioncode – код курорта для данного отеля
• regionname – название курорта (на русском)
• hotelname – название отеля
• hotelstars – категория отеля (2,3,4 или 5)
• hotelrating – рейтинг отеля от 1 до 5 (дробный), если нет = 0
• hoteldescription – краткое описание отеля (если его нет, то пусто)
• fulldesclink – ссылка на полное описание отеля (если на Вашем сайте установлен модуль «Описания стран, курортов, отелей», то ссылка будет вести на Ваш сайт, иначе ссылка будет вести на наш нейтральный домен)
• reviewlink – ссылка на отзывы по отелю (правила те же, что для fulldesclink)
• picturelink – ссылка на картинку отеля (ширина 130px)

Блок hotel содержит блок tours, в котором содержится массив элементов tour (информация о турах для данного отеля):

• operatorcode – код туроператора
• operatorname – название туроператора
• flydate – дата вылета в формате дд.мм.гггг
• nights – кол-во ночей
• price – цена в рублях. Цена уже содержит топливный сбор и уже учитывает скидку, которая настроена в личном кабинете (т.е. алгоритм расчета совпадает с алгоритмом расчета для обычного поискового модуля, установленного на сайте).
• fuelcharge – топливный сбор в рублях (на весь тур)
• placement – название типа размещения
• adults – кол-во взрослых
• child – кол-во детей
• meal – тип питания (краткое наименование)
• mealrussian – полное русское наименование питания
• room – тип комнаты
• tourname – наименование тура
• tourlink – ссылка на описание тура на сайте туроператора (если есть)
• tourid – индивидуальный код тура (будет использоваться позднее для получения детальной информации о туре, списка авиарейсов и т.п.). Обратите внимание, что данный код, как правило, действует не более суток. Поэтому не следует использовать его для долговременного хранения.

Пример запроса статуса:

http://tourvisor.ru/xml/result.php?authlogin=test&authpass=1231&requestid=32023799&type=status

Пример ответа:

<data>

<status>

<state>finished</state>

<hotelsfound>99</hotelsfound>

<toursfound>463</toursfound>

<minprice>30481</minprice>

<progress>100</progress>

<timepassed>34</timepassed>

</status>

</data>

Пример запроса результатов поиска:

http://tourvisor.ru/xml/result.php?authlogin=test&authpass=1231&requestid=32023799&type=result

Пример ответа:

<data>

<status>

<state>finished</state>

<hotelsfound>99</hotelsfound>

<toursfound>463</toursfound>

<minprice>30481</minprice>

<progress>100</progress>

<timepassed>34</timepassed>

</status>

<result>

<hotel>

<hotelcode>470</hotelcode>

<price>30481</price>

<countrycode>1</countrycode>

<countryname>Египет</countryname>

<regioncode>5</regioncode>

<regionname>Хургада</regionname>

<hotelname>SULTANA BEACH RESORT</hotelname>

<hotelstars>3</hotelstars>

<hotelrating>2.2</hotelrating>

<hoteldescription>Очень простой и скромный отель для непритязательного экономного отдыха. Сервис средний, несколько однообразное питание. Отель расположен недалеко от города, где можно погулять или найти магазины со всем необходимым.</hoteldescription>

<fulldesclink>http://manyhotels.ru/#!/hotel=sultana-beach-resort</fulldesclink>

<reviewlink>http://manyhotels.ru/#!/hotel=sultana-beach-resort&showreviews=1</reviewlink>

<picturelink>http://manyhotels.ru/hotel_pics/small/470.jpg</picturelink>

<tours>

<tour>

<operatorcode>16</operatorcode>

<operatorname>Sunmar</operatorname>

<flydate>16.02.2014</flydate>

<nights>6</nights>

<price>30481</price>

<fuelcharge>0</fuelcharge>

<placement>DBL</placement>

<adults>2</adults>

<child>0</child>

<meal>HB</meal>

<mealrussian>Полупансион</mealrussian>

<room>standard room</room>

<tourname>Хургада</tourname>

<tourid>16347248245</tourid>

</tour>

<tour>

<operatorcode>16</operatorcode>

<operatorname>Sunmar</operatorname>

<flydate>19.02.2014</flydate>

<nights>6</nights>

<price>32005</price>

<fuelcharge>0</fuelcharge>

<placement>DBL</placement>

<adults>2</adults>

<child>0</child>

<meal>HB</meal>

<mealrussian>Полупансион</mealrussian>

<room>standard room</room>

<tourname>Хургада</tourname>

<tourid>16350657821</tourid>

</tour>

...

</tours>

</hotel>

</result>

</data>