@@ Строка 1: / Строка 1: @@
-<span style="color:red;font-size:120%">Статья находится на стадии разработки.</span><br />
 Версия статьи от {{REVISIONDAY}}-{{REVISIONMONTH}}-{{REVISIONYEAR}}.
@@ Строка 9: / Строка 7: @@
 ==Введение==
-Данный web-сервис разработан для разработки собственного сайта туроператору на основе API.
+Данный web-сервис служит для разработки собственного сайта туроператору на основе API.
 ==Установка==
-Для работы с web-сервисом необходимо установить [[Мастер-Тур(15):Установка#Установка службы поиска|службу поиска]].<br />
+Для работы с web-сервисом необходимо на отдающей стороне установить [[Мастер-Тур(15):Установка#Установка службы поиска|службу поиска]].<br />
 После установки web-сервис будет доступен по адресу ''<nowiki>http://значение настройки "serviceAddress" в TourSearchOwin/"название метода"</nowiki>'' (пример: ''http://localhost:9000/TourSearchOwin/Settings'')
+==Swagger==
+Работу методов можно проверить с помощью Swagger по пути: ''http://localhost:9000/TourSearchOwin/SwaggerUI''
 ==Список методов==
@@ Строка 20: / Строка 21: @@
 [[Файл:mb_273.png|1000px|Последовательность вызова методов сервиса]]
+===Информация о состоянии службы поиска (statusCache)===
-===Выгрузка настроек службы поиска (Settings)===
+Метод выводит информацию о состоянии службы поиска при ее загрузке.
-Метод производит выгрузку настроек службы поиска.
 * Формат запроса:
-** .../TourSearchOwin/Settings?
+** GET .../TourSearchOwin/statusCache?
 * Принимаемые параметры:
 ** нет принимаемых параметров
 * Возвращаемый результат:
-** '''ChildAgesSetting''' – регулируется настройкой [[Мастер-Тур(15):Программа туров. Панель администрирования#Общие настройки|максимальный возраст ребенка]] (массив возрастов, при которых турист будет считаться ребенком
+** '''Initialized''' – информация о том, загружена ли служба или нет ('''false''' – инициализация кешей не завершена, '''true''' – инициализация кешей завершена)
-** '''DurationSetting''' – регулируется настройкой [[Мастер-Тур(15):Программа туров. Панель администрирования#Общие настройки|максимальная продолжительность тура]] (массив продолжительностей, доступных в фильтрах для поиска)
+** '''Status''' – состояние службы. Возможные значения: ''Запущена инициализация кэшей'', ''Инициализация кэшей завершена''
-** '''RoundServiceSetting''' – признак округления цены (количество знаков после запятой)
+** '''CacheName''' – информация о том, какой именно кеш сейчас считается (название)
-** '''CacheReady''' – статус готовности службы поиска к работе (true/false)
+** '''Iteration''' – порядковый номер считаемого справочника кеша
-** '''EnableFiterTree''' – устаревшая настройка, будет убрана (по умолчанию всегда false)
+** '''CacheCount''' – общее количество кешей
-** '''EnableActualFilters''' – включены ли актуальные фильтры (true/false)
+** '''ProcessMessage''' – детализация. Информацию можно разделить на 3 блока:
-** '''CorrectLicense''' – проверка лицензии (true/false)
+*** Загрузка всех справочных данных, кроме расчета маршрутов и актуальных фильтров. В этом случае сообщение будет ''Загрузка кэшей из БД''
-** '''CorrectLicenseMessage''' – сообщение, если проверка лицензии не прошла
+*** Расчет маршрутов. ''CacheName'' – ''HotelScheme'', сообщение будет ''tours load: 956 / 1234''
-** '''IsCorrectUser''' – проверка наличия пользователя в таблице ''Userlist'', под которым запущена служба поиска (true/false)
+*** Расчет актуальных фильтров. ''CacheName'' – ''ActualFilters'', сообщение будет ''Actual filter processed: 783012 / 3865687"''
-** '''IsShowCitizenAuthTourist''' – настройка запрашивать гражданство при регистрации частного лица (true/false)
-** '''IsShowFewCountPlaces''' – настройка отображения числового значения оставшихся мест, когда достигнуто значение «Мало» (true/false)
-** '''IsShowBusTransferPlaces''' – использовать фильтр наличие мест на автобусный переезд в поиске (true/false)
-** '''UseBusSeatChecks''' – план рассадки автобусного переезда (0 – не отображать, 1 – отображать без проверки, 2 – отображать с проверкой)
-** '''UseTransferSeatChecks''' – план рассадки трансфера (0 – не отображать, 1 – отображать без проверки, 2 – отображать с проверкой)
-** '''IsShowFiltersByCity''' – отображать фильтр по городам на главной странице поиска (true/false)
-** '''CheckRealCourses''' – включена ли проверка курсов реальных валют при поиске (true/false)
-** '''CommonImagesFolderPath''' – путь к папке для хранения изображений
-** '''UseApplyFiltersButton''' – отображать кнопку «Применить фильтры» (true/false)
-** '''AutoSearchFiltersTimeout''' – задержка между выбором дополнительных фильтров и выводом результатов (в секундах)
-** '''UseFastSearchAlgoritm''' – использовать быстрый алгоритм поиска (true/false)
-** '''MaxSearchDatesCountClient''' – максимальное количество дат, которое будет обрабатываться в клиенте поиска
-** '''MaxDurationsCountClient''' – максимальное количество продолжительностей, которое будет обрабатываться в клиенте поиска
 <div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
@@ Строка 56: / Строка 43: @@
 Вызов метода Settings
 <syntaxhighlight lang="java" enclose="div">
-http://localhost:9000/TourSearchOwin/Settings
+GET http://localhost:9000/TourSearchOwin/statusCache
 </syntaxhighlight>
-Возвращаемый результат метода Settings (в формате JSON)
+Возвращаемый результат метода statusCache (в формате JSON)
 <syntaxhighlight lang="java" enclose="div">
 {
-   "ChildAgesSetting":    [
+    "Initialized": false,
-,
+    "Status": "Запущена инициализация кэшей",
-,
+    "CacheName": "ToursSearchView",
-,
+    "Iteration": 10,
-,
+    "CacheCount": 112,
-,
+    "ProcessMessage": "Загрузка кэшей из БД"
-,
+}
-,
+{
-,
+    "Initialized": false,
-,
+    "Status": "Запущена инициализация кэшей",
-,
+    "CacheName": "HotelScheme",
-,
+    "Iteration": 109,
-,
+    "CacheCount": 112,
-,
+    "ProcessMessage": "tours load: 956 / 1234"
-,
+}
-,
+{
+    "Initialized": false,
-   ],
+    "Status": "Запущена инициализация кэшей",
-   "DurationSetting":    [
+    "CacheName": "ActualFilters",
-,
+    "Iteration": 112,
-,
+    "CacheCount": 112,
-,
+    "ProcessMessage": "Actual filter processed: 783012 / 3865687"
-,
+}
-,
+{
-,
+    "Initialized": true,
-,
+    "Status": "Инициализация кэшей завершена",
-,
+    "CacheName": null,
-,
+    "Iteration": 0,
-,
+    "CacheCount": 0,
-,
+    "ProcessMessage": null
-,
+}
-,
+</syntaxhighlight>
-,
+</TD></TR></TABLE>
-,
+</div></div><br />
-,
-,
+===Авторизация (Token)===
-,
+Метод производит получение авторизационного токена ([https://tools.ietf.org/html/rfc6749#section-1.3.3 описание стандарта]).
-,
+* Формат запроса:
+** POST .../TourSearchOwin/Token?
-   ],
+* Принимаемые параметры headers ( '''*''' – обязательный):
-   "RoundServiceSetting": 2,
+** '''Content-Type *''' – application/x-www-form-urlencoded
-   "CacheReady": true,
-   "EnableFiterTree": false,
+* Принимаемые параметры POST запроса ( '''*''' – обязательный):
-   "EnableActualFilters": true,
+** '''grant_type *''' – текст ''password''
-   "CorrectLicense": true,
+** '''username *''' – логин представителя партнера или частного лица
-   "CorrectLicenseMessage": "0deb1f882da1ec6301c961780507a180",
+** '''password *''' – пароль представителя партнера или частного лица
-   "IsCorrectUser": true,
-   "IsShowCitizenAuthTourist": true,
+* Возвращаемый результат:
-   "IsShowFewCountPlaces": true,
+** '''access_token''' – токен
-   "IsShowBusTransferPlaces": true,
+** '''token_type''' – тип токена
-   "UseBusSeatChecks": 1,
+** '''expires_in''' – код
-   "UseTransferSeatChecks": 2,
+** '''userKey''' – ключ пользователя
-   "IsShowFiltersByCity": true,
+** '''userType''' – тип пользователя (0 – представитель партнера, 1 – частное лицо)
-   "CheckRealCourses": true,
+** '''.issued''' – дата получения
-   "CommonImagesFolderPath": "\\\\server\\Icons",
+** '''.expires''' – дата действия до
-   "UseApplyFiltersButton": false,
-   "AutoSearchFiltersTimeout": 1,
+<div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
-   "UseFastSearchAlgoritm": true,
+<div class="mw-collapsible-content">
-   "MaxSearchDatesCountClient": 10,
+<TABLE STYLE="border: 0.1em dashed #2F6FAB; margin: 8px; padding: 8px" WIDTH="99%"><TR><TD>
-   "MaxDurationsCountClient": 14
+Вызов метода Token
-}
+<syntaxhighlight lang="java" enclose="div">
-</syntaxhighlight>
+POST http://localhost:9000/TourSearchOwin/Token HTTP/1.1
-</TD></TR></TABLE>
+Content-Type: application/x-www-form-urlencoded
+grant_type=password&username=test&password=1
+</syntaxhighlight>
+Возвращаемый результат метода Token (в формате JSON)
+<syntaxhighlight lang="java" enclose="div">
+{
+	"access_token": "AQAAANCMnd8BFdERjHoAwE_Cl-sBAAAAdsCC8X7m9E-2bg0-uS0VfgAAAAAAAAADZgAAwAAAA-
+EqAAAAAASAAACgAAAAEAAAAO4S-VrqBhQuhqliqrAKKfIgAQAAn-gfgP-rYjk-Krr1Ck2A-IGCw6FBhamUOzFxgTtk1hR-
+GLMryFIH8VK5GmHdHubZWj4S7XcazGL1Kn5-VlbiYdW2ZVWpYlk638aV-XS2kpZ9YrKgViiM_x8RH5TPo4-
+LhE7V-SjiB_CP_qs58DRKcyohq3Tz9QaiFgH1Ko7O2XKjTBG7SHyQPDPYjaqg9kDxmzq0UcIT6Fm4YkDxmm9-
+CW7u3cEFWcpiqKOc2VvZFKPPHc07uDOO4w9FXPhpXZwOqrJBxzhbr73RuhzPs_e-hgxKaIlsMaK5b0v5ReAMy1kuY0ebXA",",
+	"token_type": "bearer",
+	"expires_in": 1209599,
+	"userKey": "333",
+        "userType": "0",
+	".issued": "Thu, 05 Apr 2018 12:05:31 GMT",
+	".expires": "Thu, 19 Apr 2018 12:05:31 GMT"
+}
+</syntaxhighlight>
+</TD></TR></TABLE>
 </div></div><br />
-===Выгрузка списка валют (Currency)===
+===Выгрузка настроек службы поиска (Settings)===
-Метод возвращает список используемых валют.
+Метод производит выгрузку настроек службы поиска.
 * Формат запроса:
-** .../TourSearchOwin/Currency
+** GET .../TourSearchOwin/Settings?
 * Принимаемые параметры:
 ** нет принимаемых параметров
 * Возвращаемый результат:
-** '''Code''' – код валюты
+** '''ChildAgesSetting''' – регулируется настройкой [[Мастер-Тур(15):Программа туров. Настройки|максимальный возраст ребенка]] (массив возрастов, при которых турист будет считаться ребенком
-** '''Name''' – наименование валюты
+** '''DurationSetting''' – регулируется настройкой [[Мастер-Тур(15):Программа туров. Настройки|максимальная продолжительность тура]] (массив продолжительностей, доступных в фильтрах для поиска)
-** '''IsMain''' – признак валюты «Главная»
+** '''RoundServiceSetting''' – признак округления цены (количество знаков после запятой)
-** '''IsNational''' – признак валюты «Национальная»
+** '''CacheReady''' – статус готовности службы поиска к работе (true/false)
-** '''IsoCode''' – ISO код валюты
+** '''EnableFiterTree''' – устаревшая настройка, будет убрана (по умолчанию всегда false)
-** '''Key''' – идентификатор валюты
+** '''EnableActualFilters''' – включены ли актуальные фильтры (true/false)
-** '''IsShowInSearch''' – признак показывать ли валюту в поиске
+** '''CorrectLicense''' – проверка лицензии (true/false)
+** '''CorrectLicenseMessage''' – сообщение, если проверка лицензии не прошла
+** '''IsCorrectUser''' – проверка наличия пользователя в таблице ''Userlist'', под которым запущена служба поиска (true/false)
+** '''IsShowCitizenAuthTourist''' – настройка запрашивать гражданство при регистрации частного лица (true/false)
+** '''IsShowFewCountPlaces''' – настройка отображения числового значения оставшихся мест, когда достигнуто значение «Мало» (true/false)
+** '''IsShowBusTransferPlaces''' – использовать фильтр наличие мест на автобусный переезд в поиске (true/false)
+** '''UseBusSeatChecks''' – план рассадки автобусного переезда (0 – не отображать, 1 – отображать без проверки, 2 – отображать с проверкой)
+** '''UseTransferSeatChecks''' – план рассадки трансфера (0 – не отображать, 1 – отображать без проверки, 2 – отображать с проверкой)
+** '''IsShowFiltersByCity''' – отображать фильтр по городам на главной странице поиска (true/false)
+** '''CheckRealCourses''' – включена ли проверка курсов реальных валют при поиске (true/false)
+** '''CommonImagesFolderPath''' – путь к папке для хранения изображений
+** '''UseApplyFiltersButton''' – отображать кнопку «Применить фильтры» (true/false)
+** '''AutoSearchFiltersTimeout''' – задержка между выбором дополнительных фильтров и выводом результатов (в секундах)
+** '''UseFastSearchAlgoritm''' – использовать быстрый алгоритм поиска (true/false)
+** '''MaxSearchDatesCountClient''' – максимальное количество дат, которое будет обрабатываться в клиенте поиска
+** '''MaxDurationsCountClient''' – максимальное количество продолжительностей, которое будет обрабатываться в клиенте поиска
+** '''UseHotelCategoryGlobalCodeInDopFilter''' – использовать глобальные коды категорий отелей в поиске
+** '''UsePansionGlobalCodeInDopFilter''' – использовать глобальные коды питаний в поиске
+** '''CheckTouristDataInBasket''' – проверять корректность данных туристов
+** '''SimpleRegistration''' – упрощенная регистрация частного лица
+** '''ShowHotelImagesInSearch''' – показывать описание и изображения отелей в поиске
+** '''CacheReadyMessage''' – сообщение о готовности службы поиска или службы расчета актуальных фильтров. Варианты возвращаемых значений:
+*** ''<add key="enableActualFilters" value="true" />'' - CacheReady: true = CacheReadyMessage: "Кеш инициализирован"; CacheReady: false = CacheReadyMessage: "Кеш еще не инициализирован"
+*** ''<add key="enableActualFilters" value="false" />'' - Служба актуальных фильтров недоступна (выключена, неверно указана ссылка на нее и т.п.) CacheReadyMessage: "Служба актуальных фильтров недоступна"; Служба актуальных фильтров доступна но не готова - CacheReadyMessage: "Кеш службы актуальных фильтров не инициализирован"; Служба актуальных фильтров готова, а основная служба не готова - CacheReadyMessage: "Кеш ещё не инициализирован"; Служба актуальных фильтров готова, и основная служба готова - CacheReadyMessage: "Кеш ещё инициализирован".
+** '''nodeId''' – уникальный идентификатор узла в кластере балансировки нагрузки [[Мастер-Тур(15):Балансировщик нагрузки HaProxy|HaProxy]]
+** '''FullPaymentPeriod''' – полная оплата с даты бронирования (может быть null)
+** '''FullPaymentCheckin''' – полная оплата до даты заезда (может быть null)
+** '''PrePaymentPeriod''' – предоплата с даты бронирования (может быть null)
+** '''PrePaymentCheckin''' – предоплата до даты заезда (может быть null)
+** '''PrePaymentCu"''' – значение предоплаты в y.e. (может быть null)
+** '''PrePaymentPercent''' – значение предоплаты в процентах (может быть null)
 <div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
 <div class="mw-collapsible-content">
 <TABLE STYLE="border: 0.1em dashed #2F6FAB; margin: 8px; padding: 8px" WIDTH="99%"><TR><TD>
-Вызов метода Currency
+Вызов метода Settings
 <syntaxhighlight lang="java" enclose="div">
-http://localhost:9000/TourSearchOwin/Currency
+GET http://localhost:9000/TourSearchOwin/Settings
 </syntaxhighlight>
-Возвращаемый результат метода Currency (в формате JSON)
+Возвращаемый результат метода Settings (в формате JSON)
 <syntaxhighlight lang="java" enclose="div">
-[
+{
-       {
+   "ChildAgesSetting":    [
-       "Code": "EU",
+,
-      "Name": "Euro",
+,
-      "IsMain": false,
+,
-      "IsNational": false,
+,
-      "IsoCode": "EUR",
+,
-      "Key": 2,
+,
-      "IsShowInSearch": true
+,
-    },
+,
-      {
+,
-      "Code": "рб",
+,
-      "Name": "Рубль",
+,
-      "IsMain": false,
+,
-      "IsNational": true,
+,
-      "IsoCode": "RUR",
+,
-      "Key": 14,
+,
-      "IsShowInSearch": true
-    },
+   ],
-      {
+   "DurationSetting":    [
-      "Code": "$",
+,
-      "Name": "US Dollar",
+,
-      "IsMain": true,
+,
-      "IsNational": false,
+,
-      "IsoCode": "USD",
+,
-      "Key": 1,
+,
-      "IsShowInSearch": true
+,
-   }
+,
-]
+,
+,
+,
+,
+,
+,
+,
+,
+,
+,
+,
+   ],
+   "RoundServiceSetting": 2,
+   "CacheReady": true,
+   "EnableFiterTree": false,
+   "EnableActualFilters": true,
+   "CorrectLicense": true,
+   "CorrectLicenseMessage": "0deb1f882da1ec6301c961780507a180",
+   "IsCorrectUser": true,
+   "IsShowCitizenAuthTourist": true,
+   "IsShowFewCountPlaces": true,
+   "IsShowBusTransferPlaces": true,
+    "UseBusSeatChecks": 1,
+   "UseTransferSeatChecks": 2,
+   "IsShowFiltersByCity": true,
+   "CheckRealCourses": true,
+   "CommonImagesFolderPath": "\\\\server\\Icons",
+   "UseApplyFiltersButton": false,
+   "AutoSearchFiltersTimeout": 1,
+   "UseFastSearchAlgoritm": true,
+   "MaxSearchDatesCountClient": 10,
+   "MaxDurationsCountClient": 14
+   "UseHotelCategoryGlobalCodeInDopFilter": false
+    "UsePansionGlobalCodeInDopFilter": false
+   "CheckTouristDataInBasket": true
+   "SimpleRegistration": false
+   "ShowHotelImagesInSearch": true
+   "CacheReadyMessage":	"Кеш инициализирован"
+    "nodeId": 2147483647,
+    "FullPaymentPeriod": null,
+    "FullPaymentCheckin": 5,
+    "PrePaymentPeriod": null,
+    "PrePaymentCheckin": 10,
+    "PrePaymentPercent": 50.0,
+    "PrePaymentCu": null
+}
 </syntaxhighlight>
 </TD></TR></TABLE>
 </div></div><br />
-===Выгрузка квотируемых услуг системы (QuotedServices)===
+===Выгрузка списка валют в онлайне (Currency)===
-Метод производит выгрузку услуг с признаком «Квотируемая»
+Метод возвращает список используемых валют.
 * Формат запроса:
-** .../TourSearchOwin/QuotedServices
+** GET .../TourSearchOwin/Currency
 * Принимаемые параметры:
 ** нет принимаемых параметров
 * Возвращаемый результат:
-** '''Key''' – идентификатор услуги
+** '''Code''' – код валюты
-** '''Code''' – код услуги
+** '''Name''' – наименование валюты
-** '''Name''' – наименование услуги (русский)
+** '''IsMain''' – признак валюты «Главная»
-** '''NameLat''' – наименование услуги (английский)
+** '''IsNational''' – признак валюты «Национальная»
-** '''IsDuration''' – наличие продолжительности у услуги
+** '''IsoCode''' – ISO код валюты
-** '''IsCity''' – наличие города у услуги
+** '''IsShowInSearch''' – признак показывать ли валюту в поиске
-** '''IsSubCode1''' – признак наличия ''SubCode1'' у услуги (вид проживания у отеля, тариф у авиаперелета)
+** '''Symbol''' – символ валюты (обрабатывается с 15.7)
-** '''IsSubCode2''' – признак наличия ''SubCode2'' у услуги (тип питания у отеля)
+** '''Key''' – идентификатор валюты
-** '''Quoted''' – признак квотируемости услуги
-** '''CheckGeoPoint''' – наличие геоточек у услуги
-** '''IsRoute''' – признак маршрутной услуги
-** '''LittlePercent''' – число в %, при которых будет считаться количество мест «Мало»
-** '''LittlePlace''' – число, при котором будет считаться количество мест «Мало»
-** '''LittleAnd''' – признак наличия мест «Мало» – будем ли учитывать количество мест вместе с процентным соотношением между общим и оставшимся количеством мест
-** '''IsPartnerBasedOn''' – признак сопоставления партнера услуги в зависимости от отеля
-** '''Control''' – идентификатор статуса услуги
 <div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
 <div class="mw-collapsible-content">
 <TABLE STYLE="border: 0.1em dashed #2F6FAB; margin: 8px; padding: 8px" WIDTH="99%"><TR><TD>
-Вызов метода QuotedServices
+Вызов метода Currency
 <syntaxhighlight lang="java" enclose="div">
-http://localhost:9000/TourSearchOwin/QuotedServices
+GET http://localhost:9000/TourSearchOwin/Currency
 </syntaxhighlight>
-Возвращаемый результат метода QuotedServices (в формате JSON)
+Возвращаемый результат метода Currency (в формате JSON)
 <syntaxhighlight lang="java" enclose="div">
 [
        {
-       "Key": 1,
+       "Code": "EU",
-       "Code": "А_П",
+       "Name": "Euro",
-       "Name": "Авиаперелет",
+       "IsMain": false,
-       "NameLat": "Flight",
+      "IsNational": false,
-       "IsDuration": false,
+       "IsoCode": "EUR",
-       "IsCity": true,
+       "IsShowInSearch": true,
-       "IsSubCode1": true,
+       "Symbol": "€",
-       "IsSubCode2": false,
+       "Key": 2
-       "Quoted": true,
+   },
-       "CheckGeoPoint": true,
+      {
-       "IsRoute": true,
+       "Code": "рб",
-       "LittlePercent": null,
+       "Name": "Рубль",
-      "LittlePlace": 10,
+       "IsMain": false,
-       "LittleAnd": true,
+       "IsNational": true,
-       "IsPartnerBasedOn": false,
+       "IsoCode": "RUR",
-       "Control": 1
+       "IsShowInSearch": true,
+       "Symbol": "₽",
+       "Key": 14
     },
        {
-      "Key": 3,
+       "Code": "$",
-       "Code": "HOTEL",
+       "Name": "US Dollar",
-       "Name": "Отель/Круиз",
+       "IsMain": true,
-      "NameLat": "Hotel/Cruise",
+       "IsNational": false,
-       "IsDuration": true,
+       "IsoCode": "USD",
-       "IsCity": true,
+       "IsShowInSearch": true,
-      "IsSubCode1": true,
+       "Symbol": "$",
-      "IsSubCode2": true,
+       "Key": 1
-       "Quoted": true,
-      "CheckGeoPoint": true,
-       "IsRoute": true,
-       "LittlePercent": 99,
-      "LittlePlace": 5,
-       "LittleAnd": false,
-      "IsPartnerBasedOn": false,
-      "Control": 1
     }
 ]
@@ Строка 258: / Строка 327: @@
 </div></div><br />
-===Выгрузка городов отправления (departureCities)===
-Метод производит выгрузку всех доступных городов отправления для поискового запроса.
+===Выгрузка курсов валют (CurrencyRates) начиная с 15.7===
+Полный аналог метода [[Мастер-Тур(15):API для отдачи цен в поисковые системы#Выгрузка курсов валют (GetCurrencyRates)|Выгрузка курсов валют (GetCurrencyRates)]]<br />
+Метод возвращает список курсов валют, актуальных на дату запроса. Курсы отображаются только для тех валют, которые отмечены в справочнике признаком ''Отображать в онлайне''
 * Формат запроса:
-** .../TourSearchOwin/departureCities?
+** GET .../TourSearchOwin/CurrencyRates
 * Принимаемые параметры:
-** нет принимаемых параметров
+** '''dateFrom''' – начальная дата, от которой вывести список курсов валют, в формате DD.MM.YYYY, необязательный параметр (если не указан, берется за текущий день)
+** '''dateTo''' – конечная дата, до которой вывести список курсов валют, в формате DD.MM.YYYY, необязательный параметр (если не указан, берется за текущий день)
+** '''otherBaseCurrencyId''' – идентификатор любой валюты, эмулирующей работу национальной валюты, необязательный параметр. Если заполнен, то в результатах выдачи параметр ''baseCurrencyId'' будет заменяться на валюту из параметра ''otherBaseCurrencyId'' (обрабатывается с релиза 15.9).
 * Возвращаемый результат:
-** '''Key''' – идентификатор города
+** '''baseCurrencyId''' – идентификатор национальной валюты, либо произвольной валюты, указанной в настройке ''basketCurrency'' в конфигурационном файле (обрабатывается с релиза 15.6)
-** '''Name''' – название города
+** '''currencyId''' – идентификатор валюты, курс которой приводится
+** '''rate''' – курс валюты (отношение '''currencyId''' к '''baseCurrencyId''')
+** '''date''' – дата, на которую был зарегистрирован выводимый курс валюты
 <div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
 <div class="mw-collapsible-content">
 <TABLE STYLE="border: 0.1em dashed #2F6FAB; margin: 8px; padding: 8px" WIDTH="99%"><TR><TD>
-Вызов метода departureCities
+Вызов метода CurrencyRates
 <syntaxhighlight lang="java" enclose="div">
-http://localhost:9000/TourSearchOwin/departureCities
+http://localhost:9000/TourSearchOwin/CurrencyRates?dateFrom=18.09.2024&dateTo=19.09.2024
 </syntaxhighlight>
-Возвращаемый результат метода departureCities (в формате JSON)
+Возвращаемый результат метода CurrencyRates (в формате JSON)
 <syntaxhighlight lang="java" enclose="div">
 [
-      {
+    {
-      "Key": -1,
+        "BaseCurrencyId": 14,
-      "Name": "Без перелета"
+        "CurrencyId": 1,
-   },
+        "Rate": 91.429200,
-      {
+        "Date": "18.09.2024"
-      "Key": 312,
+    },
-      "Name": "Астрахань"
+    {
-   },
+        "BaseCurrencyId": 14,
-      {
+        "CurrencyId": 2,
-      "Key": 1,
+        "Rate": 101.505700,
-      "Name": "Москва"
+        "Date": "18.09.2024"
-   }
+    },
-]
+    {
-</syntaxhighlight>
+        "BaseCurrencyId": 14,
+        "CurrencyId": 1,
+        "Rate": 91.671200,
+        "Date": "19.09.2024"
+    },
+    {
+        "BaseCurrencyId": 14,
+        "CurrencyId": 2,
+        "Rate": 102.039000,
+        "Date": "19.09.2024"
+    }
+]
+</syntaxhighlight>
 </TD></TR></TABLE>
 </div></div><br />
-===Выгрузка списка стран (Destination)===
+===Выгрузка списка всех валют (getAllCurrencies)===
-Метод производит выгрузку всех доступных направлений туроператора.
+Метод возвращает список всех валют.
 * Формат запроса:
-** .../TourSearchOwin/Destination?
+** GET .../TourSearchOwin/AllCurencies/getAllCurrencies
-* Принимаемые параметры ( '''*''' – обязательный):
+* Принимаемые параметры:
-** '''term *''' – фильтрация результатов по контекстному поиску (по умолчанию параметр пустой)
+** нет принимаемых параметров
-** '''departureCities *''' – идентификатор города отправления (из контроллера ''.../TourSearchOwin/departureCities?'')
 * Возвращаемый результат:
-** '''Name''' – название страны
+** '''Code''' – код валюты
-** '''Key''' – идентификатор страны
+** '''Name''' – наименование валюты
-** '''DestinationType''' – тип результата (всегда возвращается в JSON = 1, в xml = country)
+** '''IsMain''' – признак валюты «Главная»
+** '''IsNational''' – признак валюты «Национальная»
+** '''IsoCode''' – ISO код валюты
+** '''IsShowInSearch''' – признак показывать ли валюту в поиске
+** '''Symbol''' – символ валюты (обрабатывается с 15.7)
+** '''Key''' – идентификатор валюты
 <div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
 <div class="mw-collapsible-content">
 <TABLE STYLE="border: 0.1em dashed #2F6FAB; margin: 8px; padding: 8px" WIDTH="99%"><TR><TD>
-Вызов метода Destination
+Вызов метода getAllCurrencies
 <syntaxhighlight lang="java" enclose="div">
-http://localhost:9000/TourSearchOwin/Destination?pageNumber=1&term=&showAll=false&departureCities=1
+GET http://localhost:9000/TourSearchOwin/AllCurencies/getAllCurrencies
 </syntaxhighlight>
-Возвращаемый результат метода Destination (в формате JSON)
+Возвращаемый результат метода getAllCurrencies (в формате JSON)
 <syntaxhighlight lang="java" enclose="div">
 [
        {
-       "Name": "Болгария",
+      "Code": "EU",
-       "Key": 359,
+       "Name": "Euro",
-       "DestinationType": 1
+      "IsMain": false,
+      "IsNational": false,
+      "IsoCode": "EUR",
+       "IsShowInSearch": true,
+      "Symbol": "€",
+       "Key": 2
     },
        {
-       "Name": "Индия",
+      "Code": "рб",
-       "Key": 26,
+       "Name": "Рубль",
-       "DestinationType": 1
+      "IsMain": false,
+      "IsNational": true,
+      "IsoCode": "RUR",
+       "IsShowInSearch": true,
+      "Symbol": "₽",
+       "Key": 14
     },
        {
-       "Name": "Финляндия",
+      "Code": "$",
-       "Key": 64,
+       "Name": "US Dollar",
-       "DestinationType": 1
+       "IsMain": true,
-    }
+      "IsNational": false,
+      "IsoCode": "USD",
+      "IsShowInSearch": true,
+      "Symbol": "$",
+       "Key": 1
+   },
+   {
+       "Code": "гр",
+       "Name": "Гривна",
+       "IsMain": false,
+       "IsNational": false,
+       "IsoCode": "UAH",
+       "IsShowInSearch": true,
+       "Symbol": "₴",
+       "Key": 6
+    }
 ]
 </syntaxhighlight>
@@ Строка 337: / Строка 455: @@
 </div></div><br />
-===Выгрузка списка городов (ActualizeCities)===
-Метод возвращает список всех доступных городов по определенному городу отправления и стране прибытия.
+===Получение сконвертированных цен (convertFilterPrice)===
+Метод возвращает сконвертированные цен для допфильтра ''Цена'' (используется в canary)
 * Формат запроса:
-** .../TourSearchOwin/ActualizeCities?
+** GET .../TourSearchOwin/AllCurencies/convertFilterPrice
 * Принимаемые параметры ( '''*''' – обязательный):
-** '''cityKeys *''' – идентификатор города отправления (полученный из метода ''.../TourSearchOwin/departureCities?'')
+** '''SourceRateKey *''' – ключ исходной валюты конвертации
-** '''Key *''' – идентификатор страны прибытия (полученный из метода ''.../TourSearchOwin/Destination?'')
+** '''TargetRateKey *''' – ключ валюты, в которую будет произведена конвертация
-** '''Name *''' – название страны прибытия (полученный из метода ''.../TourSearchOwin/Destination?'')
+** '''MinPrice *''' – значение минимальной цены, которое будет участвовать в конвертации
-** '''term *''' – фильтрация результатов по контекстному поиску (по умолчанию параметр пустой)
+** '''MaxPrice *''' – значение максимальной цены, которое будет участвовать в конвертации
 * Возвращаемый результат:
-** '''Key''' – идентификатор города
+** '''m_Item1''' – сконвертированная минимальная цена
-** '''Name''' – название города
+** '''m_Item12''' – сконвертированная максимальная цена
 <div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
 <div class="mw-collapsible-content">
 <TABLE STYLE="border: 0.1em dashed #2F6FAB; margin: 8px; padding: 8px" WIDTH="99%"><TR><TD>
-Вызов метода ActualizeCities
+Вызов метода convertFilterPrice
 <syntaxhighlight lang="java" enclose="div">
-http://localhost:9000/TourSearchOwin/ActualizeCities?cityKeys=1&Key=90&Name=Австрия&term=
+GET http://localhost:9000/TourSearchOwin/AllCurencies/convertFilterPrice?SourceRateKey=2&TargetRateKey=1&MinPrice=10&MaxPrice=200
 </syntaxhighlight>
-Возвращаемый результат метода ActualizeCities (в формате JSON)
+Возвращаемый результат метода convertFilterPrice (в формате JSON)
 <syntaxhighlight lang="java" enclose="div">
-[
+{
-      {
+    "m_Item1": 12.035142616440004814057046576,
-      "Key": -1,
+    "m_Item2": 240.70285232880009628114093152
-      "Name": "Все"
+}
-   },
-      {
-      "Key": 35,
-      "Name": "Вена"
-   },
-      {
-      "Key": 440,
-      "Name": "Зельден"
-   }
-]
 </syntaxhighlight>
 </TD></TR></TABLE>
 </div></div><br />
-===Выгрузка типов туров (ActualizeTourType)===
+===Выгрузка квотируемых услуг системы (QuotedServices)===
-Метод возвращает список типов туров по определенному городу отправления, стране и городу прибытия.
+Метод производит выгрузку услуг с признаком «Квотируемая»
 * Формат запроса:
-** .../TourSearchOwin/ActualizeTourType?
+** GET .../TourSearchOwin/QuotedServices
-* Принимаемые параметры ( '''*''' – обязательный):
+* Принимаемые параметры:
-** '''departureCityKeys *''' – идентификатор города отправления (полученный из метода ''.../TourSearchOwin/departureCities?'')
+** нет принимаемых параметров
-** '''Key *''' – идентификатор страны прибытия (полученный из метода ''.../TourSearchOwin/Destination?'')
-** '''Name *''' – название страны прибытия (полученный из метода ''.../TourSearchOwin/Destination?'')
-** '''Type *''' – тип результата (всегда возвращается в JSON = 1, в xml = country)
-** '''destinationCity *''' – идентификатор города прибытия (полученный из метода ''.../TourSearchOwin/ActualizeCities?''), по умолчанию передается ''-1'', то есть все города в рамках данной страны
-** '''term *''' – фильтрация результатов по контекстному поиску (по умолчанию параметр пустой)
 * Возвращаемый результат:
-** '''Key''' – идентификатор типа тура
+** '''Key''' – идентификатор услуги
-** '''Name''' – название типа тура
+** '''Code''' – код услуги
-** '''ParentId''' – идентификатор группы, к которой относится данный типа тура (если тип тура не относится к группе, то возвращается ''null'')
+** '''Name''' – наименование услуги (русский)
+** '''NameLat''' – наименование услуги (английский)
+** '''IsDuration''' – наличие продолжительности у услуги
+** '''IsCity''' – наличие города у услуги
+** '''IsSubCode1''' – признак наличия [[#Приложение 1: параметры услуги (ServiceType, Code, SubCode1, SubCode2)|SubCode1]] у услуги
+** '''IsSubCode2''' – признак наличия [[#Приложение 1: параметры услуги (ServiceType, Code, SubCode1, SubCode2)|SubCode2]] у услуги
+** '''Quoted''' – признак квотируемости услуги
+** '''CheckGeoPoint''' – наличие геоточек у услуги
+** '''IsRoute''' – признак маршрутной услуги
+** '''IsPartnerBasedOn''' – признак сопоставления партнера услуги в зависимости от отеля
+** '''Control''' – идентификатор статуса услуги
 <div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
 <div class="mw-collapsible-content">
 <TABLE STYLE="border: 0.1em dashed #2F6FAB; margin: 8px; padding: 8px" WIDTH="99%"><TR><TD>
-Вызов метода ActualizeTourType
+Вызов метода QuotedServices
 <syntaxhighlight lang="java" enclose="div">
-http://localhost:9000/TourSearchOwin/ActualizeTourType?departureCityKeys=1&Key=90&Name=Австрия&Type=1&destinationCity=-1&terms=
+GET http://localhost:9000/TourSearchOwin/QuotedServices
 </syntaxhighlight>
-Возвращаемый результат метода ActualizeTourType (в формате JSON)
+Возвращаемый результат метода QuotedServices (в формате JSON)
 <syntaxhighlight lang="java" enclose="div">
 [
        {
-       "Key": -1,
+       "Key": 1,
-       "Name": "Все",
+      "Code": "А_П",
-       "ParentId": null
+       "Name": "Авиаперелет",
+       "NameLat": "Flight",
+      "IsDuration": false,
+      "IsCity": true,
+      "IsSubCode1": true,
+      "IsSubCode2": false,
+      "Quoted": true,
+      "CheckGeoPoint": true,
+      "IsRoute": true,
+      "IsPartnerBasedOn": false,
+      "Control": 1
     },
        {
-       "Key": 2,
+       "Key": 3,
-       "Name": "Стандартный тур",
+      "Code": "HOTEL",
-       "ParentId": null
+       "Name": "Отель/Круиз",
-   },
+      "NameLat": "Hotel/Cruise",
-       {
+      "IsDuration": true,
-       "Key": 16,
+      "IsCity": true,
-       "Name": "Экскурсионный тур",
+       "IsSubCode1": true,
-       "ParentId": 35
+      "IsSubCode2": true,
+       "Quoted": true,
+       "CheckGeoPoint": true,
+       "IsRoute": true,
+      "IsPartnerBasedOn": false,
+       "Control": 1
     }
 ]
@@ Строка 423: / Строка 552: @@
 </div></div><br />
-===Выгрузка актуальных дат заездов (TourDate)===
+===Выгрузка актуальных городов отправления (departureCities)===
-Метод производит выгрузку доступных дат заездов для поискового запроса.
+Метод производит выгрузку всех доступных городов отправления для поискового запроса.
 * Формат запроса:
-** .../TourSearchOwin/TourDate?
+** GET .../TourSearchOwin/departureCities?
-* Принимаемые параметры ( '''*''' – обязательный):
+* Принимаемые параметры:
-** '''departureCity *''' – идентификатор города отправления (полученный из метода ''.../TourSearchOwin/departureCities?'')
+** нет принимаемых параметров
-** '''destinationCity *''' – идентификатор города прибытия (полученный из метода ''.../TourSearchOwin/ActualizeCities?''), по умолчанию передается ''-1'', то есть все города в рамках данной страны
-** '''Key *''' – идентификатор страны прибытия (полученный из метода ''.../TourSearchOwin/Destination?'')
-** '''Name *''' – название страны прибытия (полученный из метода ''.../TourSearchOwin/Destination?'')
-** '''Type *''' – тип результата (всегда возвращается в JSON = 1, в xml = country)
-** '''tourTypes *''' – идентификатор типа тура (полученный из метода ''.../TourSearchOwin/ActualizeTourType?''), по умолчанию передается ''-1'', то есть все типы тура в рамках данной страны
-** '''term *''' – фильтрация результатов по контекстному поиску (по умолчанию параметр пустой)
 * Возвращаемый результат:
-** массив дат
+** '''Key''' – идентификатор города
+** '''Name''' – название города
 <div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
 <div class="mw-collapsible-content">
 <TABLE STYLE="border: 0.1em dashed #2F6FAB; margin: 8px; padding: 8px" WIDTH="99%"><TR><TD>
-Вызов метода TourDate
+Вызов метода departureCities
 <syntaxhighlight lang="java" enclose="div">
-http://localhost:9000/TourSearchOwin/TourDate?departureCity=1&destinationCity=-1&Key=90&Name=Австрия&Type=1&tourTypes=-1&term=
+GET http://localhost:9000/TourSearchOwin/departureCities
 </syntaxhighlight>
-Возвращаемый результат метода TourDate (в формате JSON)
+Возвращаемый результат метода departureCities (в формате JSON)
 <syntaxhighlight lang="java" enclose="div">
 [
-   "21.02.2018",
+      {
-   "22.02.2018",
+      "Key": -1,
-   "23.02.2018",
+      "Name": "Без перелета"
-   "24.02.2018",
+   },
-   "25.02.2018",
+      {
-   "26.02.2018",
+      "Key": 312,
-   "27.02.2018",
+      "Name": "Астрахань"
-    "28.02.2018"
+   },
+      {
+      "Key": 1,
+      "Name": "Москва"
+    }
 ]
 </syntaxhighlight>
@@ Строка 461: / Строка 589: @@
 </div></div><br />
-===Выгрузка актуальных продолжительностей (Duration)===
+===Выгрузка актуальных стран (Destination)===
-Метод производит выгрузку доступных продолжительностей для поискового запроса.
+Метод производит выгрузку всех доступных направлений туроператора.
 * Формат запроса:
-** .../TourSearchOwin/Duration?
+** GET .../TourSearchOwin/Destination?
 * Принимаемые параметры ( '''*''' – обязательный):
-** '''departureCity *''' – идентификатор города отправления (полученный из метода ''.../TourSearchOwin/departureCities?'')
+** '''departureCities *''' – идентификатор города(ов) отправления (из контроллера [[#Выгрузка актуальных городов отправления (departureCities)|''.../TourSearchOwin/departureCities?'']])
-** '''destinationCity *''' – идентификатор города прибытия (полученный из метода ''.../TourSearchOwin/ActualizeCities?''), по умолчанию передается ''-1'', то есть все города в рамках данной страны
+** '''type''' – настройка easySearchFilter (0/не указано - настройка выключена, 1 - настройка включена)
-** '''Key *''' – идентификатор страны прибытия (полученный из метода ''.../TourSearchOwin/Destination?'')
+** '''term''' – фильтрация результатов по контекстному поиску (по умолчанию параметр пустой)
-** '''Name *''' – название страны прибытия (полученный из метода ''.../TourSearchOwin/Destination?'')
-** '''Type *''' – тип результата (всегда возвращается в JSON = 1, в xml = country)
-** '''tourDate *''' – массив дат заезда (полученные из метода ''.../TourSearchOwin/TourDate?''). Если параметры передаются через url, то каждое значение необходимо передавать отдельным параметром.
-** '''tourTypes *''' – идентификатор типа тура (полученный из метода ''.../TourSearchOwin/ActualizeTourType?''), по умолчанию передается ''-1'', то есть все типы тура в рамках данной страны
-** '''term *''' – фильтрация результатов по контекстному поиску (по умолчанию параметр пустой)
 * Возвращаемый результат:
-** массив продолжительностей
+** '''Name''' – название страны
+** '''Key''' – идентификатор страны
+** '''DestinationType''' – тип результата (внутренний параметр, не изменяемый, всегда возвращается значение = 1)
+** '''IsExist''' – не используется
+** '''Data''' – массив данных для контекстного поиска
+*** '''CityKey''' – код города
+*** '''CityName''' – Название
+*** '''HotelKey''' – код отеля
+*** '''HotelName''' – название отеля
+*** '''ResortKey''' – код курорта
+*** '''ResortName''' – название курорта
 <div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
 <div class="mw-collapsible-content">
 <TABLE STYLE="border: 0.1em dashed #2F6FAB; margin: 8px; padding: 8px" WIDTH="99%"><TR><TD>
-Вызов метода Duration
+Вызов метода Destination
 <syntaxhighlight lang="java" enclose="div">
-http://localhost:9000/TourSearchOwin/Duration?departureCity=1&destinationCity=-1&Key=90&Name=Австрия&Type=1&tourDate=25.02.2018&tourDate=26.02.2018&tourTypes=-1&term=
+GET http://localhost:9000/TourSearchOwin/Destination?departureCities=1
 </syntaxhighlight>
-Возвращаемый результат метода Duration (в формате JSON)
+Возвращаемый результат метода Destination (в формате JSON)
 <syntaxhighlight lang="java" enclose="div">
 [
-,
+      {
-,
+      "Data": null,
-,
+      "DestinationType": 1,
-,
+      "IsExist": false,
-,
+      "Key": 90,
+      "Name": "Австрия"
+    },
+      {
+      "Data": null,
+      "DestinationType": 1,
+      "IsExist": false,
+      "Key": 53,
+      "Name": "Тайланд"
+    },
+      {
+      "Data": null,
+      "DestinationType": 1,
+      "IsExist": false,
+      "Key": 460,
+      "Name": "Россия"
+    }
 ]
+GET http://localhost:9000/TourSearchOwin/Destination?departureCities=1&type=1
 </syntaxhighlight>
-</TD></TR></TABLE>
+Возвращаемый результат метода Destination (в формате JSON) с включенной настройкой easySearchFilter
-</div></div><br />
+<syntaxhighlight lang="java" enclose="div">
+[
+ {
+  "Name": "Австрия",
+  "Key": 90,
+  "DestinationType": 1,
+  "IsExist": false,
+  "Data":
+        [
+         {
+          "CityKey": 35,
+          "CityName": "Вена",
+          "HotelKey": 178,
+          "HotelName": "Ananas, 5+++*",
+          "ResortKey": 232,
+          "ResortName": "Малина"
+         },
+         {
+          "CityKey": 35,
+          "CityName": "Вена",
+          "HotelKey": 20748,
+          "HotelName": "Dev, 1-4*Boutique",
+          "ResortKey": 0,
+          "ResortName": ""
+         },
+       ],
+ }
+ {
+  "Name": "Тайланд",
+  "Key": 53,
+  "DestinationType": 1,
+  "IsExist": false,
+  "Data":
+        [
+          {
+            "CityKey": 415,
+            "CityName": "Пхукет",
+            "HotelKey": 5263,
+            "HotelName": "7Q Hotel, HV",
+            "ResortKey": 123,
+            "ResortName": "Пхукет"
+           }
+        ],
+ },
+ {
+  "Name": "Россия",
+  "Key": 460,
+  "DestinationType": 1,
+  "IsExist": false,
+  "Data":
+        [
+          {
+            "CityKey": 295,
+            "CityName": "Санкт-Петербург",
+            "HotelKey": 20365,
+            "HotelName": "Бристоль, 3*",
+            "ResortKey": 0,
+            "ResortName": ""
+           }
+        ],
+ },
+ {
+  "Name": "ОАЭ",
+  "Key": 2,
+  "DestinationType": 1,
+  "IsExist": false,
+  "Data":
+        [
+          {
+           "CityKey": 12,
+           "CityName": "ДУБАЙ",
+           "HotelKey": 1257,
+           "HotelName": "Avari, APTH3",
+           "ResortKey": 0,
+           "ResortName": ""
+          },
+       ],
+ }
+]
+</syntaxhighlight>
+</TD></TR></TABLE>
+</div></div><br />
-===Поиск туров (Tour)===
+===Выгрузка актуальных городов (ActualizeCities)===
-Метод поиска туров использует множество параметров для поиска и фильтрации туров. Метод возвращает наиболее дешевые предложения, найденные по предоставленным параметрам и сгруппированные по отелям в порядке возрастания цены.
+Метод возвращает список всех доступных городов по определенному городу отправления и стране прибытия.
 * Формат запроса:
-** .../TourSearchOwin/Tour?
+** GET .../TourSearchOwin/ActualizeCities?
 * Принимаемые параметры ( '''*''' – обязательный):
-** '''DepartureCityKeys *''' – идентификатор города отправления (полученный из метода ''.../TourSearchOwin/departureCities?'')
+** '''cityKeys *''' – идентификатор города(ов) отправления (полученный из метода ''.../TourSearchOwin/departureCities?'')
-** '''Dates *''' – массив дат заезда (полученные из метода ''.../TourSearchOwin/TourDate?''). Если параметры передаются через url, то каждое значение необходимо передавать отдельным параметром.
+** '''Key *''' – идентификатор страны прибытия (полученный из метода ''.../TourSearchOwin/Destination?'')
-** '''Durations *''' – массив продолжительностей (полученные из метода ''.../TourSearchOwin/Duration?''). Если параметры передаются через url, то каждое значение необходимо передавать отдельным параметром.
+** '''term''' – фильтрация результатов по контекстному поиску (по умолчанию параметр пустой)
-** '''PageNumber *''' – номер возвращаемой страницы (по умолчанию возвращается 1)
-** '''PageSize *''' – количество возвращаемых результатов на одной странице (возвращается 20)
-** '''HotelScheme''' – пустой по умолчанию. Заполняется при вызове вариантов размещений в рамках одного отеля. Передаются следующие параметры: '''TemplateId''' – идентификатор шаблона услуги, '''DurationInNight''' – продолжительность отеля в ночах, '''Code''' – ключ отеля, '''PacketKey''' – ключ пакета, '''PartnerKey''' – ключ партнера
-** '''TourKey''' – пустой по умолчанию. Заполняется при вызове вариантов размещений в рамках одного отеля: ключ программы тура
-** '''TourDuration''' – пустой по умолчанию. Заполняется при вызове вариантов размещений в рамках одного отеля: продолжительность тура в днях
-** '''isFromBasket *''' – происходит ли обращение из корзины или из поиска туров (true/false)
-** '''isFillSecondaryFilters *''' – заполнены ли дополнительные фильтры (true/false)
-** '''DestinationType *''' – тип результата (всегда возвращается в JSON = 1, в xml = country)
-** '''DestinationKey *''' – идентификатор страны прибытия (полученный из метода ''.../TourSearchOwin/Destination?'')
-** '''AdultCount *''' – количество взрослых
-** '''ChildAges''' – возраст детей. Если детей несколько, и параметры передаются через url, то каждое значение необходимо передавать отдельным параметром.
-** '''CurrencyName''' – код валюты
-** '''AviaQuota *''' – информация о квотах на авиаперелет (значения параметров: ''"1"'' — фильтр "Есть", ''"5"'' — фильтр "Есть+запрос", ''"7"'' — фильтр "Все")
-** '''HotelQuota *''' – информация о квотах на отель (значения параметров: ''"1"'' — фильтр "Есть", ''"5"'' — фильтр "Есть+запрос", ''"7"'' — фильтр "Все")
-** '''BusTransferQuota''' – информация о квотах на автобусный переезд (значения параметров: ''"1"'' — фильтр "Есть", ''"5"'' — фильтр "Есть+запрос", ''"7"'' — фильтр "Все")
-** '''MinPrice *''' – минимальная цена (по умолчанию не задана, передается ''NaN'')
-** '''TourType''' – идентификатор типа тура (полученный из метода ''.../TourSearchOwin/ActualizeTourType?''), по умолчанию передается ''-1'', то есть все типы тура в рамках данной страны. Возможна множественная передача параметров.
-** '''CityIds''' – идентификатор города прибытия (полученный из метода ''.../TourSearchOwin/ActualizeCities?''), по умолчанию передается ''-1'', то есть все города в рамках данной страны. Возможна множественная передача параметров.
-** '''TimeDepartureFrom''' – время отправления с (по умолчанию возвращается 00:00)
-** '''TimeDepartureTo''' – время отправления по (по умолчанию возвращается 23:59)
-** '''TimeArrivalFrom''' – время прибытия с (по умолчанию возвращается 00:00)
-** '''TimeArrivalTo''' – время прибытия по (по умолчанию возвращается 23:59)
-** '''ArrivalFlightNoTransfer''' – производить поиск без пересадок в прямом направлении (true/false, по умолчанию false)
-** '''DepartureFlightNoTransfer''' – производить поиск без пересадок в обратном направлении (true/false, по умолчанию false)
 * Возвращаемый результат:
-** '''CheckMessages''' – сообщения для логики проверки тура (не используется)
+** '''Key''' – идентификатор города
-** '''Message''' – сообщение об ошибке
+** '''Name''' – название города
-*** '''Key''' – код ошибки
-*** '''Value''' – сообщение об ошибке
+<div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
-** '''Result''' – результаты поиска
+<div class="mw-collapsible-content">
-*** '''Key''' – идентификатов программы тура
+<TABLE STYLE="border: 0.1em dashed #2F6FAB; margin: 8px; padding: 8px" WIDTH="99%"><TR><TD>
-*** '''Name''' – название программы тура
+Вызов метода ActualizeCities
-*** '''TourUrl''' – ссылка на программу тура
+<syntaxhighlight lang="java" enclose="div">
-*** '''BookingConditions''' – условия бронирования программы туров
+GET http://localhost:9000/TourSearchOwin/ActualizeCities?cityKeys=1&Key=90
-*** '''StartDate''' – дата начала тура
+</syntaxhighlight>
-*** '''Duration''' – продолжительность тура (в днях)
+Возвращаемый результат метода ActualizeCities (в формате JSON)
-*** '''DurationInNight''' – продолжительность проживания (в ночах)
+<syntaxhighlight lang="java" enclose="div">
-*** '''Types''' – идентификатор типа туров
+[
-*** '''Cost''' – цена тура
+      {
-*** '''Rate''' – код валюты тура
+      "Key": -1,
-*** '''CityDepature''' – город отправления
+      "Name": "Все"
-**** '''Key''' – идентификатор города отправления
+   },
-**** '''Value''' – название города отправления
+      {
-*** '''CountryId''' – всегда возвращается ключ 0
+      "Key": 35,
-*** '''Services''' – услуги в туре
+      "Name": "Вена"
-**** '''DepartureCity''' – город отправления
+   },
-***** '''Key''' – идентификатор
+      {
-***** '''Value''' – название
+      "Key": 440,
-**** '''DepartureCountry''' – страна отправления
+      "Name": "Зельден"
-***** '''Key''' – идентификатор
+   }
-***** '''Value''' – название
+]
-**** '''ArrivalCity''' – город прибытия
+</syntaxhighlight>
-***** '''Key''' – идентификатор
+</TD></TR></TABLE>
-***** '''Value
+</div></div><br />
+===Выгрузка актуальных типов туров (ActualizeTourType)===
+Метод возвращает список типов туров по определенному городу отправления, стране и городу прибытия.
+* Формат запроса:
+** GET .../TourSearchOwin/ActualizeTourType?
+* Принимаемые параметры ( '''*''' – обязательный):
+** '''departureCityKeys *''' – идентификатор города(ов) отправления (полученный из метода ''.../TourSearchOwin/departureCities?'')
+** '''Key *''' – идентификатор страны прибытия (полученный из метода ''.../TourSearchOwin/Destination?'')
+** '''Type *''' – тип результата (внутренний параметр, не изменяемый, всегда указывать значение = 1)
+** '''destinationCity *''' – идентификатор города(ов) прибытия (полученный из метода ''.../TourSearchOwin/ActualizeCities?''), по умолчанию передается ''-1'', то есть все города в рамках данной страны
+** '''terms''' – фильтрация результатов по контекстному поиску (по умолчанию параметр пустой)
+* Возвращаемый результат:
+** '''Key''' – идентификатор типа тура
+** '''Name''' – название типа тура
+** '''ParentId''' – идентификатор группы, к которой относится данный тип тура (если тип тура не относится к группе, то возвращается ''null'')
+<div class="toccolours mw-
                          {
                 "DepartureCity":                {
-                   "Key": 35,
+                   "Key": 1,
-                   "Value": "Вена"
+                   "Value": "Москва"
                 },
                 "DepartureCountry":                {
-                   "Key": 90,
+                   "Key": 460,
-                   "Value": "Австрия"
+                   "Value": "Россия"
                 },
                 "ArrivalCity":                {
-                   "Key": 1,
+                   "Key": 35,
-                   "Value": "Москва"
+                   "Value": "Вена"
                 },
                 "ArrivalCountry":                {
-                   "Key": 460,
+                   "Key": 90,
-                   "Value": "Россия"
+                   "Value": "Австрия"
                 },
                 "DepartureAirport":                {
+                  "Key": "SVO4",
+                  "Value": "Шереметьево-24"
+               },
+               "ArrivalAirport":                {
                    "Key": "VIE1",
                    "Value": "Vena1"
-               },
-               "ArrivalAirport":                {
-                  "Key": "DME",
-                  "Value": "Домодедово"
                 },
                 "Airline":                {
-                   "Key": "7U",
+                   "Key": "BA7",
-                   "Value": "Авиаэнерго"
+                   "Value": "BRITISH  AIRWAYS"
                 },
                 "Aircraft":                {
-                   "Key": "727",
+                   "Key": "319",
-                   "Value": "Boeing"
+                   "Value": "AIRBUS "
                 },
                 "Flight":                {
-                   "Key": 774,
+                   "Key": 882,
-                   "Value": "222"
+                   "Value": "4444"
                 },
-                "DepartureTime": "00:00:00",
+                "DepartureTime": "10:00:00",
-                "ArrivalTime": "00:00:00",
+                "ArrivalTime": "12:00:00",
-                "EndDateTime": "2018-02-28T00:00:00",
+                "EndDateTime": "2018-02-25T12:00:00",
                 "FlightDetails": [               {
                    "Tariff":                   {
@@ Строка 1016: / Строка 1378: @@
                       "Name": "Экономический класс"
                    },
-                   "Cost": 0,
+                   "Cost": 10,
                    "QuotaStatus":                   {
                       "PlacesStatus": 4,
                       "FreePlaces": 0,
-                      "TotalPlaces": 0
+                      "IsFewPlaces": false
                    },
-                   "PartnerId": 10760,
+                   "PartnerId": 12668,
                    "ByPax": true,
                    "Partner":                   {
@@ Строка 1030: / Строка 1392: @@
                 }],
                 "FlightSetting":                {
-                   "ServiceId": 4,
+                   "ServiceId": 3,
-                   "PatternId": 5,
+                   "PatternId": 13,
-                   "FlightId": 4
+                   "FlightId": 13
                 },
                 "FlightSourceMode": 1,
-                "Id": 4,
+                "Id": 3,
                 "SvKey": 1,
                 "IsSubCode1": true,
                 "IsSubCode2": false,
                 "IsPartnerBasedOn": false,
-                "Day": 4,
+                "Day": 1,
                 "DurationInNight": 0,
-                "BeginDateTime": "2018-02-28T00:00:00",
+                "BeginDateTime": "2018-02-25T10:00:00",
                 "IsHooded": false,
                 "IsDeleted": false,
                 "IsNotCalculate": false,
                 "PacketId": 779,
-                "Index": 4
+                "Index": 0
-             }
+             },
-         ],
+                        {
-         "NotRouteServices":          [
+               "Hotel":                {
-            [            {
+                  "Key": 709,
-               "ServiceName": "страховка",
+                  "Value": "Am Brilliantengrund"
-               "City": null,
+                },
-                "Country": 6245,
+                "City":                {
-                "Code":                {
+                   "Key": 35,
-                   "Key": 297,
+                   "Value": "Вена"
-                   "Value": "Страховка от несчастного случая"
                 },
-                "ByScheduler": false,
+                "Stars":                {
-                "Details": [               {
+                  "Key": -1,
-                   "SubCode1":                   {
+                  "Value": null
-                      "Key": 18,
+               },
-                      "Value": "2"
+                "Resort":                {
+                  "Key": -1,
+                  "Value": null
+               },
+               "ImageURL": "",
+               "Http": null,
+               "Description": "",
+               "Country":                {
+                  "Key": 90,
+                  "Value": "Австрия"
+               },
+               "HotelDetails": [               {
+                   "HotelRoom": 46463,
+                  "Room":                   {
+                      "Key": 129,
+                      "Value": "DBL"
                    },
-                   "SubCode2":                   {
+                   "RoomCategory":                   {
-                      "Key": null,
+                      "Key": 3493,
-                      "Value": ""
+                      "Value": "Cosy"
                    },
-                   "Date": null,
+                   "AccomodationType":                   {
-                   "IsShowTransportPlan": true,
+                     "Key": 1256,
-                  "Cost": 389.57,
+                     "Value": "2+1_K",
-                  "QuotaStatus":                   {
+                      "AdultCount": 2,
-                     "PlacesStatus": 1,
+                      "ChildCount": 1
-                      "FreePlaces": 0,
-                      "TotalPlaces": 0
                    },
-                   "PartnerId": 12668,
+                  "Pansion":                   {
-                   "ByPax": true,
+                     "Key": 4,
+                     "Value": "Завтрак"
+                  },
+                  "AbsolutePenalties": null,
+                  "Cost": 19.47,
+                  "QuotaStatus":                   {
+                     "PlacesStatus": 4,
+                     "FreePlaces": 0,
+                     "IsFewPlaces": false
+                  },
+                   "PartnerId": 12667,
+                   "ByPax": false,
                    "Partner":                   {
-                      "Key": 0,
+                      "Key": 12667,
-                      "Value": null
+                      "Value": "Партнер-покупатель1"
                    }
                 }],
-                "ParentId": null,
+                "HotelTypes": [               {
-               "PartnerBasedOnServiceTemplateId": null,
+                  "Key": 5,
-                "Id": 10,
+                  "Value": "Рекомендуемые"
-                "SvKey": 6,
+               }],
+                "Id": 1,
+                "SvKey": 3,
                 "IsSubCode1": true,
                 "IsSubCode2": true,
@@ Строка 1093: / Строка 1480: @@
                 "Day": 1,
                 "DurationInNight": 3,
-                "BeginDateTime": "2018-02-25T00:00:00",
+                "BeginDateTime": "2018-02-25T12:00:00",
-                "EndDateTime": "2018-02-28T00:00:00",
+                "EndDateTime": "2018-02-28T12:00:00",
                 "IsHooded": false,
-                "IsDeleted": true,
+                "IsDeleted": false,
-                "IsNotCalculate": true,
+                "IsNotCalculate": false,
-                "PacketId": 882,
+                "PacketId": 779,
-                "Index": 2
+                "Index": 1
-             }],
+             },
-            [            {
+                        {
-                "ServiceName": "экскурсия",
+               "DepartureCity":                {
-                "City":                {
+                  "Key": 35,
-                   "Key": 1046,
+                  "Value": "Вена"
-                   "Value": "Санто-Доминго"
+               },
+                "DepartureCountry":                {
+                  "Key": 90,
+                  "Value": "Австрия"
+               },
+               "ArrivalCity":                {
+                  "Key": 1,
+                  "Value": "Москва"
+               },
+                "ArrivalCountry":                {
+                   "Key": 460,
+                   "Value": "Россия"
                 },
-                "Country": 6245,
+                "DepartureAirport":                {
-               "Code":                {
+                   "Key": "VIE1",
-                   "Key": 743,
+                   "Value": "Vena1"
-                   "Value": "4"
                 },
-                "ByScheduler": false,
+                "ArrivalAirport":                {
-                "Details": [               {
+                  "Key": "DME",
-                   "SubCode1":                   {
+                  "Value": "Домодедово"
-                     "Key": 37,
+               },
-                     "Value": "Мини-автобус 10 чел."
+                "Airline":                {
-                  },
+                   "Key": "7U",
-                  "SubCode2":                   {
+                   "Value": "Авиаэнерго"
-                     "Key": null,
+               },
-                     "Value": ""
+               "Aircraft":                {
-                  },
+                  "Key": "727",
-                   "Date": null,
+                  "Value": "Boeing"
-                  "IsShowTransportPlan": false,
+               },
-                   "Cost": 85.22,
+               "Flight":                {
+                  "Key": 774,
+                  "Value": "222"
+               },
+               "DepartureTime": "00:00:00",
+               "ArrivalTime": "00:00:00",
+               "EndDateTime": "2018-02-28T00:00:00",
+               "FlightDetails": [               {
+                  "Tariff":                   {
+                     "Key": 89,
+                     "Code": "Y",
+                     "Name": "Экономический класс"
+                  },
+                   "Cost": 0,
                    "QuotaStatus":                   {
-                      "PlacesStatus": 1,
+                      "PlacesStatus": 4,
                       "FreePlaces": 0,
-                      "TotalPlaces": 0
+                      "IsFewPlaces": false
                    },
-                   "PartnerId": 12667,
+                   "PartnerId": 10760,
                    "ByPax": true,
                    "Partner":                   {
@@ Строка 1137: / Строка 1547: @@
                    }
                 }],
-                "ParentId": null,
+                "FlightSetting":                {
-                "PartnerBasedOnServiceTemplateId": null,
+                  "ServiceId": 4,
-                "Id": 7,
+                  "PatternId": 5,
-                "SvKey": 4,
+                  "FlightId": 4
-                "IsSubCode1": true,
+               },
+                "FlightSourceMode": 1,
+                "Id": 4,
+                "SvKey": 1,
+                "IsSubCode1": true,
                 "IsSubCode2": false,
-                "IsPartnerBasedOn": true,
+                "IsPartnerBasedOn": false,
-                "Day": 1,
+                "Day": 4,
                 "DurationInNight": 0,
-                "BeginDateTime": "2018-02-25T00:00:00",
+                "BeginDateTime": "2018-02-28T00:00:00",
-               "EndDateTime": "2018-02-26T00:00:00",
                 "IsHooded": false,
-                "IsDeleted": true,
+                "IsDeleted": false,
-                "IsNotCalculate": true,
+                "IsNotCalculate": false,
                 "PacketId": 779,
-                "Index": 3
+                "Index": 4
-             }]
+             }
           ],
-          "MinCostServicesComposition":          [
+          "NotRouteServices":          [
-                        {
+            [            {
-                "Key":                {
+                "ServiceName": "страховка",
-                   "TemplateId": 3,
+               "City": null,
-                   "PatternId": 13,
+               "Country":                {
-                   "SettingId": 13
+                   "Key": 90,
+                   "Value": "Австрия"
+               },
+               "Code":                {
+                  "Key": 297,
+                   "Value": "Страховка от несчастного случая"
                 },
-                "Value":                {
+                "ByScheduler": false,
-                   "Cost": 240,
+                "Details": [               {
-                   "ServiceType": 1,
+                   "SubCode1":                   {
-                   "Code": 882,
+                     "Key": 18,
-                   "SubCode1": 89,
+                     "Value": "2"
-                   "SubCode2": 1,
+                  },
-                  "PacketId": 779,
+                  "SubCode2":                   {
+                     "Key": null,
+                     "Value": ""
+                  },
+                   "Date": null,
+                   "IsShowTransportPlan": true,
+                   "Cost": 16,
+                   "QuotaStatus":                   {
+                     "PlacesStatus": 1,
+                     "FreePlaces": 0,
+                     "IsFewPlaces": false
+                  },
                    "PartnerId": 12668,
-                   "CountryId": 90,
+                   "ByPax": true,
-                   "CityId": 35,
+                   "Partner":                   {
-                   "Day": 1,
+                     "Key": 0,
-                  "DurationInNight": 0
+                     "Value": null
-                }
+                   }
-             },
+               }],
-                        {
+               "ParentId": null,
-                "Key":                {
+               "PartnerBasedOnServiceTemplateId": null,
-                   "TemplateId": 1,
+               "Id": 10,
-                   "PatternId": 0,
+               "SvKey": 6,
-                  "SettingId": 0
+               "IsSubCode1": true,
+               "IsSubCode2": true,
+               "IsPartnerBasedOn": false,
+               "Day": 1,
+               "DurationInNight": 3,
+               "BeginDateTime": "2018-02-25T00:00:00",
+               "EndDateTime": "2018-02-28T00:00:00",
+               "IsHooded": false,
+               "IsDeleted": true,
+               "IsNotCalculate": true,
+               "PacketId": 882,
+                "Index": 2
+             }],
+            [            {
+                "ServiceName": "экскурсия",
+               "City":                {
+                   "Key": 1046,
+                   "Value": "Санто-Доминго"
                 },
-                "Value":                {
+                "Country":                {
-                   "Cost": 19.47,
+                   "Key": 90,
-                  "ServiceType": 3,
+                   "Value": "Австрия"
-                  "Code": 709,
-                  "SubCode1": 46463,
-                  "SubCode2": 4,
-                  "PacketId": 779,
-                  "PartnerId": 12667,
-                  "CountryId": 90,
-                   "CityId": 35,
-                  "Day": 1,
-                  "DurationInNight": 3
-               }
-            },
-                        {
-               "Key":                {
-                  "TemplateId": 4,
-                  "PatternId": 5,
-                  "SettingId": 4
                 },
-                "Value":                {
+                "Code":                {
-                   "Cost": 0,
+                   "Key": 743,
-                   "ServiceType": 1,
+                   "Value": "4"
-                  "Code": 774,
+               },
-                   "SubCode1": 89,
+               "ByScheduler": false,
-                  "SubCode2": 35,
+               "Details": [               {
-                  "PacketId": 779,
+                   "SubCode1":                   {
-                   "PartnerId": 10760,
+                     "Key": 37,
-                  "CountryId": 460,
+                     "Value": "Мини-автобус 10 чел."
-                  "CityId": 1,
+                  },
-                   "Day": 4,
+                   "SubCode2":                   {
-                   "DurationInNight": 0
+                     "Key": null,
-               }
+                     "Value": ""
-            }
+                  },
-         ],
+                   "Date": null,
-         "FlightWeight": 2,
+                   "IsShowTransportPlan": false,
-         "LinkingFlightsRules":          {
+                  "Cost": 85.22,
-            "notCombineDifferentAirlineRule":             {
+                  "QuotaStatus":                   {
-               "airlines": ["AY2"],
+                     "PlacesStatus": 1,
-               "flightSettings": [],
+                     "FreePlaces": 0,
-               "enabled": true
+                     "IsFewPlaces": false
-            },
+                  },
-            "checkPlusMinus1CharterRule":             {
+                  "PartnerId": 12667,
-               "FlightSettingPairs": [],
+                  "ByPax": true,
-               "enabled": false
+                  "Partner":                   {
-            },
+                     "Key": 0,
-            "notCombineDifferentTariffGroupRule":             {
+                     "Value": null
-                "FlightSettings": [],
+                  }
-                "enabled": true
+               }],
-            },
+               "ParentId": null,
-            "notCombineDifferentPartnerRule":             {
+                "PartnerBasedOnServiceTemplateId": null,
-                "FlightSettings": [],
+                "Id": 7,
-                "enabled": false
+               "SvKey": 4,
-            },
+                "IsSubCode1": true,
-            "departureCityEqualsArrivalCityRule":             {
+                "IsSubCode2": false,
-                "FlightSettingPairs": [],
+               "IsPartnerBasedOn": true,
-                "enabled": false
+                "Day": 1,
-            },
+                "DurationInNight": 0,
-            "combineOnlySpecificChartersRule":             {
+               "BeginDateTime": "2018-02-25T00:00:00",
-               "settings": [],
+                "EndDateTime": "2018-02-26T00:00:00",
-                "enabled": false
+               "IsHooded": false,
-            }
+               "IsDeleted": true,
-         },
+               "IsNotCalculate": true,
-         "RouteSubVariants": []
+               "PacketId": 779,
-      }
+               "Index": 3
-   ],
+            }]
-   "SecondaryFiltersResult":    {
+         ],
-      "TourTypes": [      {
+         "MinCostServicesComposition":          [
-         "Id": 2,
+                        {
-         "Name": "Стандартный тур",
+               "Key":                {
-         "ParentId": null,
+                  "TemplateId": 3,
-         "Type": "TourType"
+                  "PatternId": 13,
-      }],
+                  "SettingId": 13
-      "TourPrograms":       [
+               },
-                      {
+               "Value":                {
-            "Key": 100000004,
+                  "ServiceType": 1,
-            "Name": "Общая проверка системы",
+                  "Code": 882,
-            "TourUrl": "www.megatec.ru",
+                  "SubCode1": 89,
-            "BookingConditions": "<p>Условия бронирования тура.<\/p>",
+                  "SubCode2": 1,
-            "IsLandOnly": false,
+                  "PacketId": 779,
-            "IsRestrictMultiHotels": false,
+                  "PartnerId": 12668,
-            "IsHotelTemplates": true,
+                  "CountryId": 90,
-            "IsRouteServices": true,
+                  "CityId": 35,
-            "MultiHotelDelta": 0,
+                  "Day": 1,
-            "Rate": "EU",
+                  "DurationInNight": 0
-            "DateStart": "2018-01-30T00:00:00Z",
+               }
-            "DateEnd": "2018-02-27T00:00:00Z",
-            "Status":             {
-               "Key": 3,
-               "Value": "Доступен для продажи"
              },
-            "Templates":             [
+                        {
-               {"$id": "5"},
+                "Key":                {
-                {"$id": "6"},
+                   "TemplateId": 1,
-               {"$id": "7"},
+                   "PatternId": 0,
-               {"$id": "8"},
+                   "SettingId": 0
-               {"$id": "9"}
-            ],
-            "Types": [            {
-               "Id": 2,
-               "Name": "Стандартный тур",
-               "ParentId": null,
-               "Type": "TourType"
-            }],
-            "LinkingFlightsRules":             {
-               "notCombineDifferentAirlineRule":                {
-                   "airlines": ["AY2"],
-                   "flightSettings": [],
-                   "enabled": true
                 },
-                "checkPlusMinus1CharterRule":                {
+                "Value":                {
-                   "FlightSettingPairs": [],
+                   "ServiceType": 3,
-                   "enabled": false
+                   "Code": 709,
-               },
+                   "SubCode1": 46463,
-               "notCombineDifferentTariffGroupRule":                {
+                   "SubCode2": 4,
-                   "FlightSettings": [],
+                   "PacketId": 779,
-                   "enabled": true
+                   "PartnerId": 12667,
-               },
+                   "CountryId": 90,
-               "notCombineDifferentPartnerRule":                {
+                   "CityId": 35,
-                   "FlightSettings": [],
+                   "Day": 1,
-                   "enabled": false
+                   "DurationInNight": 3
-               },
-               "departureCityEqualsArrivalCityRule":                {
-                   "FlightSettingPairs": [],
-                   "enabled": false
-               },
-               "combineOnlySpecificChartersRule":                {
-                   "settings": [],
-                   "enabled": false
                 }
              },
-            "XmlSettings": "информация о туре в формате xml",
+                        {
-            "Type": "TourProgram"
+               "Key":                {
-         }
+                  "TemplateId": 4,
-      ],
+                  "PatternId": 5,
-      "TourDurations": [4],
+                  "SettingId": 4
-      "TourDates": ["2018-02-25T00:00:00"],
+               },
-      "HotelCities": [      {
+               "Value":                {
-          "key": 35,
+                  "ServiceType": 1,
-          "Country":          {
+                  "Code": 774,
-             "key": 90,
+                  "SubCode1": 89,
-            "name": "Австрия",
+                  "SubCode2": 35,
-            "Code": "AUS",
+                  "PacketId": 779,
-             "CitizenName": "Австрия",
+                  "PartnerId": 10760,
-            "CitizenNameLat": "AUSTRIA",
+                  "CountryId": 460,
-             "PassportMinDurCheckFrom": 0,
+                  "CityId": 1,
-            "CheckINN": false,
+                  "Day": 4,
-            "PassportMinDur": null,
+                  "DurationInNight": 0
-             "INNName": "ИНН",
+               }
-            "Web": 1,
+            }
-             "WebImage": "/pics/animate/austria.gif",
+         ],
-            "WebHTTP": "",
+          "FlightWeight": 2,
-             "AnkLang": 0,
+          "LinkingFlightsRules":          {
-            "Type": "Country"
+             "notCombineDifferentAirlineRule":             {
-          },
+               "airlines": ["AY2"],
-          "name": "Вена",
+               "flightSettings": [],
-          "Code": "VIE",
+               "enabled": true
-          "Web": 0,
+            },
-          "RSKey": 0,
+             "checkPlusMinus1CharterRule":             {
-          "WebImage": null,
+               "FlightSettingPairs": [],
-          "IsDeparture": 1,
+               "enabled": false
-          "Type": "City"
+            },
+             "notCombineDifferentTariffGroupRule":             {
+               "FlightSettings": [],
+               "enabled": true
+            },
+             "notCombineDifferentPartnerRule":             {
+               "FlightSettings": [],
+               "enabled": false
+            },
+             "departureCityEqualsArrivalCityRule":             {
+               "FlightSettingPairs": [],
+               "enabled": false
+            },
+             "combineOnlySpecificChartersRule":             {
+               "settings": [],
+               "enabled": false
+            }
+          },
+          "RouteSubVariants": [],
+         "Routes": 1,
+          "IsRemoteHotels": false,
+         "IsTourImages": false,
+          "MaskKeys": null
+      }
+   ],
+   "SecondaryFiltersResult":    {
+      "TourTypes": [      {
+          "Id": 2,
+          "Name": "Стандартный тур",
+          "ParentId": null,
+          "Type": "TourType"
        }],
-       "HotelResorts": [      {
+       "TourPrograms":       [
-         "Key": -1,
+                      {
-         "CountryKey": 0,
+            "Key": 100000004,
-         "Name": "Не указан",
+            "Name": "Общая проверка системы",
-         "NameLat": null,
+            "TourUrl": "www.megatec.ru",
-         "Type": "Resort"
+            "BookingConditions": "<p>Условия бронирования тура.<\/p>",
-      }],
+            "IsLandOnly": false,
-      "HotelCategories":       [
+            "IsRestrictMultiHotels": false,
-                  {
+            "IsHotelTemplates": true,
-             "Key": 23,
+            "IsRouteServices": true,
-            "Name": "1*",
+            "MultiHotelDelta": 0,
-            "PrintNumber": 1,
+            "Rate": "EU",
-            "Type": "HotelCatigory"
+            "DateStart": "2018-01-30T00:00:00Z",
-         },
+            "DateEnd": "2018-02-27T00:00:00Z",
-                   {
+            "Status":             {
-            "Key": 56,
+               "Key": 3,
-            "Name": "2*",
+               "Value": "Доступен для продажи"
-            "PrintNumber": 2,
+            },
-            "Type": "HotelCatigory"
+            "Templates":             [
-         },
+               {"$id": "5"},
-                   {
+               {"$id": "6"},
-            "Key": 66,
+               {"$id": "7"},
-            "Name": "4*Boutique",
+               {"$id": "8"},
-            "PrintNumber": null,
+               {"$id": "9"}
-             "Type": "HotelCatigory"
+            ],
-          }
+             "Types": [            {
+               "Id": 2,
+               "Name": "Стандартный тур",
+               "ParentId": null,
+               "Type": "TourType"
+            }],
+            "LinkingFlightsRules":             {
+               "notCombineDifferentAirlineRule":                {
+                  "airlines": ["AY2"],
+                  "flightSettings": [],
+                   "enabled": true
+               },
+               "checkPlusMinus1CharterRule":                {
+                  "FlightSettingPairs": [],
+                  "enabled": false
+               },
+               "notCombineDifferentTariffGroupRule":                {
+                  "FlightSettings": [],
+                  "enabled": true
+               },
+               "notCombineDifferentPartnerRule":                {
+                  "FlightSettings": [],
+                  "enabled": false
+               },
+               "departureCityEqualsArrivalCityRule":                {
+                   "FlightSettingPairs": [],
+                  "enabled": false
+               },
+               "combineOnlySpecificChartersRule":                {
+                  "settings": [],
+                  "enabled": false
+               }
+            },
+             "Type": "TourProgram"
+          }
        ],
-       "Hotels":       [
+       "TourDurations": [4],
+      "TourDates": ["2018-02-25T00:00:00"],
+      "HotelCities": [      {
+         "key": 35,
+         "Country":          {
+            "key": 90,
+            "name": "Австрия",
+            "Code": "AUS",
+            "CitizenName": "Австрия",
+            "CitizenNameLat": "AUSTRIA",
+            "PassportMinDurCheckFrom": 0,
+            "CheckINN": false,
+            "PassportMinDur": null,
+            "INNName": "ИНН",
+            "Web": 1,
+            "WebImage": "/pics/animate/austria.gif",
+            "WebHTTP": "",
+            "AnkLang": 0,
+            "Type": "Country"
+         },
+         "name": "Вена",
+         "Code": "VIE",
+         "Web": 0,
+         "RSKey": 0,
+         "WebImage": null,
+         "IsDeparture": 1,
+         "Type": "City"
+      }],
+      "HotelResorts": [      {
+         "Key": -1,
+         "CountryKey": 0,
+         "Name": "Не указан",
+         "NameLat": null,
+         "Type": "Resort"
+      }],
+      "HotelCategories":       [
                    {
-             "Key": 705,
+            "Key": 23,
-             "Country":             {
+            "Name": "1*",
+            "PrintNumber": 1,
+            "Type": "HotelCatigory"
+         },
+                  {
+            "Key": 56,
+            "Name": "2*",
+            "PrintNumber": 2,
+            "Type": "HotelCatigory"
+         },
+                  {
+            "Key": 66,
+            "Name": "4*Boutique",
+            "PrintNumber": null,
+            "Type": "HotelCatigory"
+         }
+      ],
+      "Hotels":       [
+                  {
+             "Key": 705,
+             "Country":             {
                 "key": 90,
                 "name": "Австрия",
@@ Строка 1764: / Строка 2288: @@
 </div></div><br />
-===Выгрузка первоначального варианта в корзину для бронирования (Tour)===
+* Детализация параметра serviceDescriptions из url:
-Метод поиска, который возвращает варианты только по данной турпрограмме и схеме отеля.
+** '''TemplateId''' – идентификатор шаблона услуги (этот параметр можно взять из контроллера Tour->Result->RouteSubVariants->CostServicesComposition->Key->TemplateId)
+** '''PatternId''' – идентификатор паттерна услуги (этот параметр можно взять из контроллера Tour->Result->RouteSubVariants->CostServicesComposition->Key->PatternId)
+** '''SettingId''' – идентификатор услуги (этот параметр можно взять из контроллера Tour->Result->RouteSubVariants->CostServicesComposition->Key->SettingId)
+** '''ServiceType''' – тип услуги (этот параметр можно взять из контроллера Tour->Result->RouteSubVariants->CostServicesComposition->Value->ServiceType)
+** '''Code''' – код услуги (этот параметр можно взять из контроллера Tour->Result->RouteSubVariants->CostServicesComposition->Value->Code)
+** '''SubCode1''' – доп. описание 1 услуги (этот параметр можно взять из контроллера Tour->Result->RouteSubVariants->CostServicesComposition->Value->SubCode1)
+** '''SubCode2''' – доп. описание 2 услуги (этот параметр можно взять из контроллера Tour->Result->RouteSubVariants->CostServicesComposition->Value->SubCode2)
+** '''CountryId''' – ключ страны (этот параметр можно взять из контроллера Tour->Result->RouteSubVariants->CostServicesComposition->Value->CountryId)
+** '''CityId''' – ключ города (этот параметр можно взять из контроллера Tour->Result->RouteSubVariants->CostServicesComposition->Value->CityId)
+** '''PacketId''' – ключ пакета (этот параметр можно взять из контроллера Tour->Result->RouteSubVariants->CostServicesComposition->Value->PacketId)
+** '''PartnerId''' – ключ партнера (этот параметр можно взять из контроллера Tour->Result->RouteSubVariants->CostServicesComposition->Value->PartnerId)
+** '''Day''' – день предоставления (этот параметр можно взять из контроллера Tour->Result->RouteSubVariants->CostServicesComposition->Value->Day)
+** '''DurationInNight''' – продолжительность в ночах (этот параметр можно взять из контроллера Tour->Result->RouteSubVariants->CostServicesComposition->Value->DurationInNight)
+Пример: serviceDescriptions=1_0_0_3_107274_1400134_1526_460_1_1830_14752_1_8
+===Выгрузка транспортного плана (TransportPlan) до релиза 15.7 включительно===
+Метод производит выгрузку транспортного плана.
 * Формат запроса:
-** .../TourSearchOwin/Tour?
+** GET .../TourSearchOwin/TransportPlan?
 * Принимаемые параметры ( '''*''' – обязательный):
-** '''DepartureCityKeys *''' – идентификатор города отправления (полученный из метода ''.../TourSearchOwin/departureCities?'')
+** '''code''' – код услуги
-** '''DestinationType *''' – тип результата (всегда возвращается в JSON = 1, в xml = country)
+** '''dateBegin''' – дата услуги
-** '''DestinationKey *''' – идентификатор страны прибытия (полученный из метода ''.../TourSearchOwin/Destination?'')
+** '''serviceType''' – тип услуги
-** '''Dates *''' – массив дат заезда (полученные из метода ''.../TourSearchOwin/TourDate?''). Если параметры передаются через url, то каждое значение необходимо передавать отдельным параметром.
+** '''transportKey''' – ключ справочника транспорт
-** '''Durations *''' – массив продолжительностей (полученные из метода ''.../TourSearchOwin/Duration?''). Если параметры передаются через url, то каждое значение необходимо передавать отдельным параметром.
-** '''AdultCount *''' – количество взрослых
+* Возвращаемый результат:
-** '''ChildAges''' – возраст детей. Если детей несколько, и параметры передаются через url, то каждое значение необходимо передавать отдельным параметром.
+** '''TransportKey''' – ключ справочника транспорт
-** '''CurrencyName *''' – код валюты
+** '''Title''' – описание
-** '''HotelQuota *''' – информация о квотах на отель (значения параметров: ''"1"'' — фильтр "Есть", ''"5"'' — фильтр "Есть+запрос", ''"7"'' — фильтр "Все")
+** '''AreasCount''' – количество уровней
-** '''AviaQuota *''' – информация о квотах на авиаперелет (значения параметров: ''"1"'' — фильтр "Есть", ''"5"'' — фильтр "Есть+запрос", ''"7"'' — фильтр "Все")
+** '''RowsCount''' – количество рядов
-** '''BusTransferQuota''' – информация о квотах на автобусный переезд (значения параметров: ''"1"'' — фильтр "Есть", ''"5"'' — фильтр "Есть+запрос", ''"7"'' — фильтр "Все")
+** '''ColumnsCount''' – количество мест в ряду
-** '''HotelScheme *''' – объект схемы отеля
+** '''BusySeats''' – не используется
-*** '''TemplateId''' – идентификатор шаблона услуги
+** '''Cells''' – массив описаний всех мест
-*** '''DurationInNight''' – продолжительность отеля в ночах
+*** '''Row''' – ряд
-*** '''Code''' – ключ отеля
+*** '''Column''' – место в ряду
-*** '''PacketKey''' – ключ пакета
+*** '''Area''' – уровень места
-*** '''PartnerKey''' – ключ партнера
+*** '''Type''' – тип (None = 0, Seat = 1, Block = 4, Busy = 5)
-** '''TourKey''' – пустой по умолчанию. Заполняется при вызове вариантов размещений в рамках одного отеля: ключ программы тура
+*** '''Name''' – название/номер
-** '''TourDuration''' – пустой по умолчанию. Заполняется при вызове вариантов размещений в рамках одного отеля: продолжительность тура в днях
+** '''UserSeats''' – не используется
-** '''PageNumber *''' – номер возвращаемой страницы (по умолчанию возвращается 1)
+** '''BlockSeat''' – не используется
-** '''PageSize *''' – количество возвращаемых результатов на одной странице (возвращается 20)
-** '''isFromBasket *''' – происходит ли обращение из корзины или из поиска туров (true/false).
+<div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
-** '''isFillSecondaryFilters *''' – заполнены ли дополнительные фильтры (true/false)
+<div class="mw-collapsible-content">
+<TABLE STYLE="border: 0.1em dashed #2F6FAB; margin: 8px; padding: 8px" WIDTH="99%"><TR><TD>
+Вызов метода TransportPlan
+<syntaxhighlight lang="java" enclose="div">
+GET http://localhost:9000/TourSearchOwin/TransportPlan?code=1311&dateBegin=17.04.2018&serviceType=14&transportKey=39
+</syntaxhighlight>
+Возвращаемый результат метода TransportPlan (в формате JSON)
+<syntaxhighlight lang="java" enclose="div">
+{
+	"TransportKey": 39,
+	"Title": "__",
+	"AreasCount": 1,
+	"RowsCount": 12,
+	"ColumnsCount": 5,
+	"BusySeats": [],
+	"Cells": [{
+		"Row": 5,
+		"Column": 0,
+		"Area": 0,
+		"Type": 4,
+		"Name": "21"
+	},
+	{
+		"Row": 5,
+		"Column": 1,
+		"Area": 0,
+		"Type": 1,
+		"Name": "22"
+	},
+	{
+		"Row": 5,
+		"Column": 2,
+		"Area": 0,
+		"Type": 2,
+		"Name": ""
+	},
+	{
+		"Row": 5,
+		"Column": 3,
+		"Area": 0,
+		"Type": 1,
+		"Name": "23"
+	},
+	{
+		"Row": 5,
+		"Column": 4,
+		"Area": 0,
+		"Type": 1,
+		"Name": "24"
+	}],
+	"UserSeats": {
+	},
+	"BlockSeat": {
+	}
+}
+</syntaxhighlight>
+</TD></TR></TABLE>
+</div></div><br />
+===Выгрузка транспортного плана (TransportPlan) начиная с релиза 15.8===
+Метод производит выгрузку транспортного плана.
+* Формат запроса:
+** GET .../TourSearchOwin/TransportPlan?
+* Принимаемые параметры ( '''*''' – обязательный):
+** '''code''' – код услуги
+** '''dateBegin''' – дата услуги
+** '''serviceType''' – тип услуги
+** '''transportKey''' – ключ справочника транспорт
 * Возвращаемый результат:
-** '''CheckMessages''' – сообщения для логики проверки тура (не используется)
+** '''VehiclePlans''' – массив параметров зон плана
-** '''Message''' – сообщение об ошибке
+*** '''Key''' – ключ зоны
-*** '''Key''' – код ошибки
+*** '''TransportKey''' – ключ из справочника транспорт
-*** '''Value''' – сообщение об ошибке
+*** '''Row''' – количество рядов
-** '''Result''' – результаты поиска
+*** '''AreaNumber''' – номер уровня
-*** '''Key''' – идентификатов программы тура
+*** '''Name''' – название уровня
-*** '''Name''' – название программы тура
+*** '''PlanOrientation''' – ориентация плана (''false'' - горизонтальная, ''true'' - вертикальная)
-*** '''TourUrl''' – ссылка на программу тура
+*** '''Column''' – количество столбцов
-*** '''BookingConditions''' – условия бронирования программы туров
+*** '''IsAirCraft''' – является ли планом самолета (''false'' - нет, ''true'' - является)
-*** '''StartDate''' – дата начала тура
+*** '''Type''' – не используется
-*** '''Duration''' – продолжительность тура (в днях)
+** '''Seats''' – массив параметров посадочного места
-*** '''DurationInNight''' – продолжительность проживания (в ночах)
+*** '''Key''' – ключ места
-*** '''Types''' – идентификатор типа туров
+*** '''SeatType''' – тип места (None = 0, Seat = 1, Pass/comment = 2, Block = 4, Busy = 5)
-*** '''Cost''' – цена тура
+*** '''Index''' – индекс места
-*** '''Rate''' – код валюты тура
+*** '''Number''' – название ячейки с местом
-*** '''CityDepature''' – город отправления
+*** '''Type''' – тип "место"
-**** '''Key''' – идентификатор города отправления
+*** '''VPKey''' – ключ зоны
-**** '''Value''' – название города отправления
+*** '''Border''' – обводка границы (комбинация цифр, где 0 - нет обводки, 1 - обводка в 1 px, 2 - обводка в 2 px)
-*** '''CountryId''' – всегда возвращается ключ 0
-*** '''Services''' – услуги в туре
+<div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
-**** '''DepartureCity''' – город отправления
+<div class="mw-collapsible-content">
-***** '''Key''' – идентификатор
+<TABLE STYLE="border: 0.1em dashed #2F6FAB; margin: 8px; padding: 8px" WIDTH="99%"><TR><TD>
-***** '''Value''' – название
+Вызов метода TransportPlan
-**** '''DepartureCountry''' – страна отправления
+<syntaxhighlight lang="java" enclose="div">
-***** '''Key''' – идентификатор
+GET http://localhost:9000/TourSearchOwin/TransportPlan?code=1776&dateBegin=28.03.2022&serviceType=14&transportKey=35
-***** '''Value''' – название
+</syntaxhighlight>
-**** '''ArrivalCity''' – город прибытия
+Возвращаемый результат метода TransportPlan (в формате JSON)
-***** '''Key''' – идентификатор
+<syntaxhighlight lang="java" enclose="div">
-***** '''Value''' – название
+{
-**** '''ArrivalCountry''' – страна прибытия
+"VehiclePlans":

Мастер-Тур(15):API для разработки онлайн поиска и бронирования — различия между версиями