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

Материал из Megatec
Перейти к: навигация, поиск
(Показать все непроверенные изменения)
[досмотренная версия][досмотренная версия]
Строка 19: Строка 19:
 
==Настройка==
 
==Настройка==
  
−
==Список методов==
+
==Загрузка справочников==
  
 
===Выгрузка списка стран (GetCountries)===
 
===Выгрузка списка стран (GetCountries)===
Строка 94: Строка 94:
 
}
 
}
 
</syntaxhighlight>
 
</syntaxhighlight>
−
Корневой элемент '''getResortsResult''' содержит произвольное количество элементов '''resort''', каждый из которых описывает курорт атрибутами '''id''' (идентификатор курорта), '''name''' (название курорта) и '''countryId''' (идентификатор страны, в котором расположен курорт).
+
Корневой элемент '''resorts''' содержит произвольное количество элементов '''resort''', каждый из которых описывает курорт атрибутами '''id''' (идентификатор курорта), '''name''' (название курорта) и '''countryId''' (идентификатор страны, в котором расположен курорт).
 
</TD></TR></TABLE>
 
</TD></TR></TABLE>
 
</div></div><br />
 
</div></div><br />
Строка 125: Строка 125:
 
</TD></TR></TABLE>
 
</TD></TR></TABLE>
 
</div></div><br />
 
</div></div><br />
 +
 +
===Выгрузка списка категорий отелей (GetHotelCategories)===
 +
Метод возвращает список категорий отелей (примеры: 3*, 4*, Apts и т.д.).
 +
* Формат запроса:
 +
** ?action=GetHotelCategories
 +
* Параметры:
 +
** '''id''' – идентификатор категории отеля (опциональный, если указан, то запрашивается только одна запись)
 +
 +
<div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Формат выдачи (JSON)
 +
<div class="mw-collapsible-content">
 +
<TABLE STYLE="border: 0.1em dashed #2F6FAB; margin: 8px; padding: 8px" WIDTH="99%"><TR><TD>
 +
<syntaxhighlight lang="java" enclose="div">
 +
{
 +
  "version": "1.0",
 +
  "hotelCategories":    [           
 +
            {
 +
        "id": {Int32},
 +
        "name": {String}
 +
      },
 +
      ...
 +
  ]
 +
}
 +
</syntaxhighlight>
 +
Корневой элемент '''hotelCategories''' содержит произвольное количество элементов '''hotelCategory''', каждый из которых описывает категорию отеля атрибутами '''id''' (идентификатор) и '''name''' (название).
 +
</TD></TR></TABLE>
 +
</div></div><br />
 +
 +
<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>
 +
<syntaxhighlight lang="java" enclose="div">
 +
{
 +
  "version": "1.0",
 +
  "countries":    [
 +
            {
 +
        "id": 97,
 +
        "name": "Тунис"
 +
      },           
 +
            {
 +
        "id": 90,
 +
        "name": "Австрия"
 +
      },
 +
            {
 +
        "id": 30,
 +
        "name": "Франция"
 +
      }           
 +
  ]
 +
}
 +
</syntaxhighlight>
 +
</TD></TR></TABLE>
 +
</div></div><br />
 +
  
  

Версия 16:10, 8 августа 2016

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

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


Введение

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

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

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

Установка

Настройка

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

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

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

  • Формат запроса:
    •  ?action=GetCountries
  • Параметры:
    • id – идентификатор страны (опциональный, если указан, то запрашивается только одна запись)
Формат выдачи (JSON) 
{
   "version": "1.0",
   "countries":    [            
            { 
         "id": {Int32}, 
         "name": {String} 
      }, 
      ... 
   ] 
}


Пример 
{
   "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": "Франция"
      }            
   ]
}


Источник — «http://wiki.megatec.ru/index.php?title=Мастер-Тур(15):API_для_отдачи_цен_в_поисковые_системы&oldid=18293»