Мастер-Тур(15):API для отдачи цен в поисковые системы

Версия статьи от 19-02-2026.

Поддерживаемые версии ПК «Мастер-Тур»: Начиная с 15 версии

Введение

Данный web-сервис разработан для отдачи цен во внешние поисковые системы и выполняет следующие задачи:

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

Выдача результатов осуществляется в формате JSON

Установка

Для работы с web-сервисом необходимо на отдающей стороне установить службу поиска.
После установки web-сервис будет доступен по адресу http://значение настройки "serviceAddress" в TourSearchOwin/searchApi?action="название метода" (пример: http://localhost:9000/TourSearchOwin/searchApi?action=GetCountries)

Для поддержки систем с большой нагрузкой можно использовать сторонние "балансировщики нагрузки".
Пример настройки балансировщика HaProxy.

Swagger

Работу методов можно проверить с помощью Swagger по пути: http://localhost:9000/TourSearchOwin/SwaggerUI

Загрузка справочников

Выгрузка списка стран (GetCountries)

Метод производит выгрузку всех направлений туроператора.

• Формат запроса:
  •  ?action=GetCountries
• Принимаемые параметры:
  • id – идентификатор страны (опциональный, передача в запрос нескольких id не обрабатывается, в этом случае возвращаются все результаты. Если указан, то запрашивается только одна запись)
• Возвращаемый результат:
  • id – идентификатор страны
  • name – название страны (рус)
  • lname – название страны (анг)

Пример

Вызов метода GetCountries http://localhost:9000/TourSearchOwin/searchApi?action=GetCountries Возвращаемый результат метода GetCountries (в формате JSON) { "version": "1.08", "countries": [ { "id": 97, "name": "Тунис", "lname": "Tunisia" }, { "id": 90, "name": "Австрия", "lname": "Австрия" }, { "id": 30, "name": "Франция", "lname": "France" } ] }

Выгрузка списка городов вылета (GetDepartCities)

Метод производит выгрузку всех доступных городов вылета, а также содержит данные о том, какие направления доступны из каждого города вылета.

• Формат запроса:
  •  ?action=GetDepartCities
• Принимаемые параметры:
  • id – идентификатор города вылета (опциональный, передача в запрос нескольких id не обрабатывается, в этом случае возвращаются все результаты. Если указан, то запрашивается только одна запись)
• Возвращаемый результат:
  • id – идентификатор города
  • name – название города (рус)
  • lname – название города (анг)
  • countriesTo – идентификаторы стран, которые присутствуют в данном городе вылета
  • countryId – идентификатор страны города вылета
  • countryName – название страны города вылета
  • countryCode – код страны города вылета

Пример

Вызов метода GetDepartCities http://localhost:9000/TourSearchOwin/searchApi?action=GetDepartCities Возвращаемый результат метода GetDepartCities (в формате JSON) { "version": "1.08", "departCities": [ { "id": -1, "name": "Без перелета", "lname": "No flights", "countriesTo": [ 97, 90 ], "countryId": -1, "countryName": "", "countryCode": "" }, { "id": 1, "name": "Москва", "lname": "Moscow", "countriesTo": [ 90, 30 ], "countryId": 460, "countryName": "Россия", "countryCode": "RUS" } ] }

Выгрузка списка городов (GetResorts)

Метод возвращает список всех доступных городов.

• Формат запроса:
  •  ?action=GetResorts
• Принимаемые параметры:
  • id – идентификатор города (опциональный, пер�