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

Материал из Megatec
Перейти к: навигация, поиск
[досмотренная версия][досмотренная версия]
Строка 21: Строка 21:
 
==Список методов==
 
==Список методов==
  
===Выгрузка списка стран===
+
===Выгрузка списка стран (GetCountries)===
 
Метод производит выгрузку всех направлений туроператора <br />
 
Метод производит выгрузку всех направлений туроператора <br />
 
* Формат запроса:
 
* Формат запроса:
Строка 64: Строка 64:
 
         "id": 30,
 
         "id": 30,
 
         "name": "Франция"
 
         "name": "Франция"
       },             
+
       }          
 +
  ]
 +
}
 +
</syntaxhighlight>
 +
</TD></TR></TABLE>
 +
</div></div><br />
 +
 
 +
===Выгрузка списка курортов (GetResorts)===
 +
Метод производит выгрузку всех направлений туроператора <br />
 +
* Формат запроса:
 +
** ?action=GetResorts
 +
* Параметры:
 +
** '''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",
 +
  "resorts":    [            
 +
            {
 +
        "id": {Int32},
 +
        "name": {String}
 +
        "countryId": {Int32}
 +
      },
 +
      ...
 +
  ]
 +
}
 +
</syntaxhighlight>
 +
Корневой элемент '''getResortsResult''' содержит произвольное количество элементов '''resort''', каждый из которых описывает курорт атрибутами '''id''' (идентификатор курорта), '''name''' (название курорта) и '''countryId''' (идентификатор страны, в котором расположен курорт).
 +
</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": 1,
 +
        "name": "Каринтия",
 +
        "countryId": 90
 +
      },         
 +
            {
 +
        "id": 42,
 +
        "name": "Хаммамед",
 +
        "countryId": 97
 +
      },
 +
            {
 +
        "id": 40,
 +
        "name": "Сусс",
 +
        "countryId": 97
 +
      }         
 
   ]
 
   ]
 
}
 
}
Строка 70: Строка 125:
 
</TD></TR></TABLE>
 
</TD></TR></TABLE>
 
</div></div><br />
 
</div></div><br />
 +
  
  

Версия 15:44, 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}
      }, 
      ... 
   ] 
}

Корневой элемент getResortsResult содержит произвольное количество элементов resort, каждый из которых описывает курорт атрибутами id (идентификатор курорта), name (название курорта) и countryId (идентификатор страны, в котором расположен курорт).


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