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

Версия статьи от 25-05-2019.

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

Введение

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

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

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

Установка

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

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

Выгрузка списка стран (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 – идентификатор города (опциональный, передача в запрос нескольких id не обрабатывается, в этом случае возвращаются все результаты. Если указан, то запрашивается только одна запись)
• Возвращаемый результат:
  • id – идентификатор города
  • name – название города (рус)
  • lname – название города (анг)
  • countryId – идентификатор страны, в котором расположен город

Пример

Вызов метода GetResorts http://localhost:9000/TourSearchOwin/searchApi?action=GetResorts Возвращаемый результат метода GetResorts (в формате JSON) { "version": "1.08", "resorts": [ { "id": 1, "name": "Каринтия", "lname": "Carinthia", "countryId": 90 }, { "id": 42, "name": "Хаммамед", "lname": "Hammamet", "countryId": 97 }, { "id": 40, "name": "Сусс", "lname": "Sousse", "countryId": 97 } ] }

Выгрузка типов тура (GetTourTypes) начиная с релиза 15.4

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

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

Пример

Вызов метода GetTourTypes http://localhost:9000/TourSearchOwin/searchApi?action=GetTourTypes&departureCityIds=1&countryId=90&resortIds=-1 Возвращаемый результат метода GetTourTypes (в формате JSON) { "version": "1.08", "TourTypes": [ { "id": 1, "name": "Стандартный тур" }, { "id": 5, "name": "Экскурсионный тур", "lname": "Hammamet" }, { "id": 40, "name": "Пляжный отдых" } ] }

Выгрузка актуальных дат заездов (GetDates) начиная с релиза 15.4

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

• Формат запроса:
  •  ?action=GetDates
• Принимаемые параметры:
  • departureCityIds * – идентификатор города(ов) отправления (из метода GetDepartCities)
  • countryId * – идентификатор страны прибытия (из метода GetCountries)
  • resortIds * – идентификатор города(ов) прибытия (из метода GetResorts), при значении -1 будут переданы все города в рамках данной страны
  • tourTypeIds * – идентификатор типа(ов) тура (из метода GetTourTypes), при значении -1 будут переданы все типы тура в рамках данной страны
• Возвращаемый результат:
  • массив актуальных дат заезда в формате dd.MM.yyyy

Пример

Вызов метода GetDates http://localhost:9000/TourSearchOwin/searchApi?action=GetDates&departureCityIds=1&countryId=90&resortIds=-1&tourTypeIds=22 Возвращаемый результат метода GetDates (в формате JSON) { "version": "1.08", "dates": [ "01.08.2019", "02.08.2019", "03.08.2019", "04.08.2019", "05.08.2019", "06.08.2019", "07.08.2019", "08.08.2019", "09.08.2019", "10.08.2019" ] }

Выгрузка актуальных продолжительностей (GetDurations) начиная с релиза 15.4

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

• Формат запроса:
  •  ?action=GetDurations
• Принимаемые параметры:
  • departureCityIds * – идентификатор города(ов) отправления (из метода GetDepartCities)
  • countryId * – идентификатор страны прибытия (из метода GetCountries)
  • resortIds * – идентификатор города(ов) прибытия (из метода GetResorts), при значении -1 будут переданы все города в рамках данной страны
  • tourTypeIds * – идентификатор типа(ов) тура (из метода GetTourTypes), при значении -1 будут переданы все типы тура в рамках данной страны
  • tourDates * – массив дат заездов в формате dd.MM.yyyy (из метода GetDates)
• Возвращаемый результат:
  • массив актуальных продолжительностей

Пример

Вызов метода GetDurations http://localhost:9000/TourSearchOwin/searchApi?action=GetDurations&departureCityIds=1&countryId=90&resortIds=-1&tourTypeIds=22&tourDates=22.05.2019,28.05.2019 Возвращаемый результат метода GetDurations (в формате JSON) { "version": "1.08", "durations": [ 8, 9, 10, 11, 12, 13, 14 ] }

Выгрузка программ туров (GetTourPrograms) начиная с релиза 15.4

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

• Формат запроса:
  •  ?action=GetTourPrograms
• Принимаемые параметры:
  • id * – идентификатор программы тура (обязательный, передача в запрос нескольких id не обрабатывается, в этом случае возвращается ошибка. Если указан, то запрашивается только одна запись)
• Либо
  • departureCityIds * – идентификатор города(ов) отправления (из метода GetDepartCities)
  • countryId * – идентификатор страны прибытия (из метода GetCountries)
  • resortIds * – идентификатор города(ов) прибытия (из метода GetResorts), при значении -1 будут переданы все города в рамках данной страны
  • tourTypeIds * – идентификатор типа(ов) тура (из метода GetTourTypes), при значении -1 будут переданы все типы тура в рамках данной страны
  • fromDateTime – дата (в формате dd.MM.yyyy HH:mm:ss), начиная с которой будут выгружаться изменения (то есть будут получены только те доступные программы туров, которые изменялись, начиная с указанной даты)
• Возвращаемый результат:
  • id – ключ программы туров
  • name – название программы туров
  • updateDate – дата последнего изменения программы туров (или связанных с ней компонентов)
  • beginDate – дата начала заездов по программе туров (в формате dd.MM.yyyy)
  • endDate – дата окончания заездов по программе туров (в формате dd.MM.yyyy)
  • tourTypeIds – типы туров для данной программы туров
  • routes – массив возможных маршрутов в данной программе туров
    • departureCountryKey – страна начала поездки (для каждой страны начала поездки в одной программе тура будет отдельный маршрут)
    • departureCityKey – город начала поездки (для каждого города начала поездки в одной программе тура будет отдельный маршрут)
    • destinationCountryKeys – страны по туру (если в туре несколько услуг класса отель и они в разных странах, то будут возвращаться все страны отелей)
    • destinationCityKeys – города по туру (если в туре отели в нескольких городах, то будут возвращаться все города отелей)

Пример

Вызов метода GetTourPrograms http://localhost:9000/TourSearchOwin/searchApi?action=GetTourPrograms&departureCityIds=1&countryId=90&resortIds=-1&tourTypeIds=22&fromDateTime=22.05.2019 12:00:00 Возвращаемый результат метода GetTourPrograms (в формате JSON) { "version": "1.08", "TourPrograms": [{ "id": 100004493, "name": "Автобусный тур", "updateDate": "2019-05-20T17:17:02.087", "beginDate": "01.06.2019", "endDate": "01.08.2019", "tourTypeIds": [2, 22], "routes": [{ "departureCountryId": 460, "departureCityId": 1, "destinationCountryIds": [90], "destinationCityIds": [35] }] }, { "id": 100005542, "name": "Общая проверка системы", "updateDate": "2019-05-15T15:54:10.81", "beginDate": "01.03.2018", "endDate": "15.08.2019", "tourTypeIds": [22], "routes": [{ "departureCountryId": 460, "departureCityId": 1, "destinationCountryIds": [90], "destinationCityIds": [35, 440, 562] }] }] }

Выгрузка списка курортов (GetAreas) начиная с релиза 15.3

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

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

Пример

Вызов метода GetAreas http://localhost:9000/TourSearchOwin/searchApi?action=GetAreas Возвращаемый результат метода GetAreas (в формате JSON) { "version": "1.08", "areas": [ { "id": 232, "name": "Малина", "lname": "Малина", "countryId": 90 }, { "id": 233, "name": "Облако", "lname": "Облако", "countryId": 90 }, { "id": 1, "name": "Каринтия", "lname": "en_Каринтия", "countryId": 90 }, { "id": -1, "name": "Без курорта", "lname": "", "countryId": -1 } ] }

Выгрузка списка категорий отелей (GetHotelCategories)

Метод возвращает список категорий отелей (примеры: 3*, 4*, Apts и т.д.).

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

Пример

Вызов метода GetHotelCategories http://localhost:9000/TourSearchOwin/searchApi?action=GetHotelCategories Возвращаемый результат метода GetHotelCategories (в формате JSON) { "version": "1.08", "hotelCategories": [ { "id": 59, "name": "5*" "globalCode": "5*" }, { "id": 58, "name": "4*" "globalCode": null }, { "id": 57, "name": "3*" "globalCode": null } ] }

Выгрузка списка отелей (GetHotels)

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

• Формат запроса:
  •  ?action=GetHotels
• Принимаемые параметры:
  • id – идентификатор отеля (опциональный, передача в запрос нескольких id не обрабатывается, в этом случае возвращаются все результаты. Если указан, то запрашивается только одна запись)
• Возвращаемый результат:
  • id – идентификатор отеля
  • name – название отеля
  • hotelCategoryId – идентификатор категории отеля
  • hotelCategoryName – название категории отеля
  • resortId – идентификатор города, в котором расположен отель
  • resortName – название города, в котором расположен отель
  • areaId – идентификатор курорта, в котором расположен отель
  • areaName – название курорта, в котором расположен отель
  • address – адрес отеля
  • phone – телефон отеля
  • email – e-mail отеля
  • fax – факс отеля
  • http – адрес в интернете отеля

Пример

Вызов метода GetHotels http://localhost:9000/TourSearchOwin/searchApi?action=GetHotels Возвращаемый результат метода GetHotels (в формате JSON) { "version": "1.08", "hotels": [ { "id": 672, "name": "'Opal", "hotelCategoryId": 59, "hotelCategoryName": "4*+", "resortId": 35, "resortName": "Вена", "areaId": -1, "areaName": "Без курорта", "address": "53 av, Sova str.", "phone": "010(999)653-26-35", "email": "service@opal.net", "fax": null, "http": null }, { "id": 106, "name": "OPERA LAFAYETTE", "hotelCategoryId": 23, "hotelCategoryName": "5*", "resortId": 35, "resortName": "Вена", "areaId": -1, "areaName": "Без курорта", "address": null, "phone": null, "email": null, "fax": null, "http": null }, { "id": 709, "name": "Am Brilliantengrund", "hotelCategoryId": 23, "hotelCategoryName": "5*", "resortId": 35, "resortName": "Вена", "areaId": -1, "areaName": "Без курорта", "address": null, "phone": null, "email": null, "fax": null, "http": null }, { "id": 2362, "name": "Gastehaus Franz Riml", "hotelCategoryId": 59, "hotelCategoryName": "4*+", "resortId": 35, "resortName": "Вена", "areaId": -1, "areaName": "Без курорта", "address": null, "phone": null, "email": null, "fax": null, "http": null } ] }

Выгрузка списка типов номеров (GetRooms) начиная с релиза 15.3

Метод возвращает список всех доступных типов номеров, на которые есть актуальные цены.

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

Пример

Вызов метода GetRooms http://localhost:9000/TourSearchOwin/searchApi?action=GetRooms Возвращаемый результат метода GetRooms (в формате JSON) { "version": "1.08", "rooms": [ { "id": 129, "code": "DBL", "name": "DBL", "mainplaces": 2, "extraplaces": 1 }, { "id": 175, "code": "DBL+CHD", "name": "DBL+CHD", "mainplaces": null, "extraplaces": null }, { "id": 132, "code": "DBL+EXB", "name": "DBL+EXB", "mainplaces": 2, "extraplaces": 4 }, { "id": 2, "code": "Double1", "name": "Double2", "mainplaces": 2, "extraplaces": 3 }, { "id": 133, "code": "SNGL", "name": "SNGL", "mainplaces": null, "extraplaces": null }, { "id": 54, "code": "SNGL+2 Child ", "name": "Sngl+2 Child", "mainplaces": 1, "extraplaces": 0 }, { "id": 173, "code": "TPL", "name": "TPL", "mainplaces": null, "extraplaces": null } ] }

Выгрузка списка типов номеров (GetRoomTypes) начиная с релиза 15.3

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

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

Пример

Вызов метода GetRoomTypes http://localhost:9000/TourSearchOwin/searchApi?action=GetRoomTypes Возвращаемый результат метода GetRoomTypes (в формате JSON) { "version": "1.08", "roomTypes": [ { "id": 4129, "code": "Cottage Premier Deluxe", "name": "Cottage Premier Deluxe" }, { "id": 39, "code": "Deluxe", "name": "Deluxe" }, { "id": 2711, "code": "Luxe", "name": "Luxe" }, { "id": 4470, "code": "Standard Room", "name": "Standard Room" } ] }

Выгрузка списка типов номеров (GetHtPlaces) начиная с релиза 15.3

Метод возвращает список всех доступных типов размещений, на которые есть актуальные цены.

• Формат запроса:
  •  ?action=GetHtPlaces
• Принимаемые параметры:
  • id – идентификатор типа размещения (опциональный, передача в запрос нескольких id не обрабатывается, в этом случае возвращаются все результаты. Если указан, то запрашивается только одна запись)
• Возвращаемый результат:
  • id – идентификатор типа размещения
  • code – код типа размещения
  • name – название типа размещения
  • adultmainplaces – количество основных мест для взрослых
  • adultextraplaces – количество дополнительных мест для взрослых
  • childtmainplaces – количество основных мест для детей
  • childextraplaces – количество дополнительных мест для детей
  • mainplaces – общее количество основных мест для взрослых и детей
  • extraplaces – общее количество дополнительных мест для взрослых и детей
  • childAges – коллекция возможных возрастов детей в размещении (указывается полный возраст, то есть 12 - это 12,99)
    • from – нижняя граница возраста первого ребенка
    • to – верхняя граница возраста первого ребенка
    • from – нижняя граница возраста второго ребенка
    • to – верхняя граница возраста второго ребенка

Пример

Вызов метода GetHtPlaces http://localhost:9000/TourSearchOwin/searchApi?action=GetHtPlaces Возвращаемый результат метода GetHtPlaces (в формате JSON) { "version": "1.08", "hotelPlaces": [ { "id": 1239, "code": "1 ADL", "name": "1 ADL", "adultmainplaces": 1, "adultextraplaces": 0, "childtmainplaces": 0, "childextraplaces": 0, "mainplaces": 1, "extraplaces": 0, "childAges": [ { "from": null, "to": null }, { "from": null, "to": null } ] }, { "id": 1372, "code": "2 ad + child (0-0.99)", "name": "2 ad + child (0-0.99)", "adultmainplaces": 2, "adultextraplaces": 0, "childtmainplaces":