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

Статья находится на стадии разработки.
Версия статьи от 9-08-2016.

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

Введение

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

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

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

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

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

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

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

Пример

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

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

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

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

Формат выдачи (JSON)

{ "version": "1.0", "resorts": [ { "id": {Int32}, "name": {String} "countryId": {Int32} }, ... ] } Корневой элемент resorts содержит произвольное количество элементов resort, каждый из которых описывает курорт атрибутами id (идентификатор курорта), name (название курорта) и countryId (идентификатор страны, в котором расположен курорт).

Пример

{ "version": "1.0", "countries": [ { "id": 1, "name": "Каринтия", "countryId": 90 }, { "id": 42, "name": "Хаммамед", "countryId": 97 }, { "id": 40, "name": "Сусс", "countryId": 97 } ] }

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

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

• Формат запроса:
  •  ?action=GetHotelCategories
• Параметры:
  • id – идентификатор категории отеля (опциональный, если указан, то запрашивается только одна запись)

Формат выдачи (JSON)

{ "version": "1.0", "hotelCategories": [ { "id": {Int32}, "name": {String} }, ... ] } Корневой элемент hotelCategories содержит произвольное количество элементов hotelCategory, каждый из которых описывает категорию отеля атрибутами id (идентификатор) и name (название).

Пример

{ "version": "1.0", "countries": [ { "id": 97, "name": "Тунис" }, { "id": 90, "name": "Австрия" }, { "id": 30, "name": "Франция" } ] }