Внимание!

Максимально допустимый диапазон между датами заезда - 30 дней.

Максимально допустимый диапазон между количество ночей - 8 ночей.

Установлено ограничение 20 запрос в минуту с одного ip-адреса.

 


Запрос на подбор тура

Для получение результата в формате json используется URL:

http://search.tez-tour.com/tariffsearch/getResult?accommodationId=2&after=21.03.2013&before=15.04.2013&cityId=345&countryId=1104¤cy=5561&hotelClassBetter=true&hotelClassId=2569&hotelInStop=false&locale=ru&nightsMax=15&nightsMin=7&noTicketsFrom=false&noTicketsTo=false&priceMax=999999&priceMin=0&rAndBBetter=true&rAndBId=2424&tourId=1285&formatResult=true&xml=false

Так же можно использовать параметр formatResult=false чтобы получить результат одной строкой Запрос состоит из следующих параметров:

Обязательные параметры:

countryId=1104 – id страны отдыха;

cityId=345 – id города вылета;

priceMin=0 – минимальная стоимость отдыха;

priceMax=999999 – максимальная стоимость отдыха;

before=31.05.2010 – верхняя планка диапазона даты заезда;

after=21.05.2010 – нижняя планка диапазона даты заезда;

currency=5561 – id валюты, в которой указана цена;

nightsMin=7 – минимальное количество ночей, проведенных в отеле;

nightsMax=15 – максимальное количество ночей, проведенных в отеле;

accommodationId=2 – id размещения;

hotelClassId=2569 – id уровня отеля(звездность);

hotelClassBetter=true / false – позволяет(либо не позволяет) выдавать в результате подбора отели классом выше указанного(в интерфейсе выглядит как флажок «и лучше»);

rAndBId=2424 – id пансиона;

rAndBBetter=true / false – позволяет(либо не позволяет) выдавать в результате подбора предложения с пансионом уровнем выше указанного(в интерфейсе выглядит как флажок «и лучше»);

regionId=1234 – id региона СПО. Для каждой страны регион СПО несет свою смысловую нагрузку(в интерфейсе выглядит как список «Тур»). Не может быть использован вместе с tourId.

tourId=1285 – id региона. Можно указать несколько регионов: tourId=14259&tourId=14385. Для двойного проживания указывать tourId=14259,14385. Не может быть использован вместе с spoRegionId.

hotelId=1234 – id отеля. Можно указать несколько регионов: hotelId=1234&hotelId=12345;

birthday1=22.06.2005 – день рождения ребенка. Параметр должен быть указан только если размещение предполагает наличие ребенка;

birthday2=12.06.2005 – день рождения второго ребенка. Параметр должен быть указан только если размещение предполагает наличие двух детей;

Необязательные параметры:

xml=true / false – формат результата подбора(ответа). True – ответ придет в формате xml, false – ответ придет в формате search.

formatResult= true / false – форматирование ответа. True – ответ будет отформатирован, false – ответ придет одной строкой. Актуально только для ответа в формате json.

groupByHotel=1 -  параметр группировки цен (1 - по отелю и количеству ночей, 2 - один отель, минимальная цена, 3 - по отелю и типу питанию)

tourType=1 - состав тура статичные значения (1 - Полный пакет, 2 - Проживание + трансфер, 3 - Проживание, 6 - Проживание + перелёт)

locale=ru / en – локализация. Ru – русская локализация, en – английская локализация(на стадии доработки).

showArrivalRegion=true/false-позволяет(либо не позволяет) искать ID региона прилета

noTicketsFrom=false / true – позволяет(либо не позволяет) искать предложения для которых нет подходящих вылетов обратно(в интерфейсе выглядит как флажок «нет билетов обратно»);

noTicketsTo=false / true – позволяет(либо не позволяет) искать предложения для которых нет подходящих вылетов туда(в интерфейсе выглядит как флажок «нет билетов туда»);

hotelInStop=false / true – позволяет(либо не позволяет) искать предложения для которых отели в стопе(в интерфейсе выглядит как флажок «отели в стопе»);

 

Результат подбора туров в формате json с расшифровкой:

{
  "success": true, //результаты подбора. Если подбору тура выполнен успешно, возвращается значение true. 
Если в результате подбора тура произошла ошибка - возвращается значение false и описание ошибки. "serverName": "amba.teztour.com", //название сервера "data": [ //содержит описание первого результата подбора тура [ 1, // номер результата подбора тура "06.04.2013", //дата заезда в отель "Сб", // день недели даты заезда в отель "", //дата вылета. Если совпадает с датой заезда, то значение не указано 7, //количество ночей "до 13.04", //дата отъезда из отеля "NAZAR BEACH CITY & RESORT HOTEL 4 *", //название отеля "http://www.tez-tour.com/hotel.html?id=9000184", //ссылка на отель на сайте компании "Standard", // тип номера [ [ "", // если результат предполагает несколько размещений при проживании, то здесь передается название отеля второго проживания "http://online.tez-tour.com/armmanager/workplace/section/new-order?cDateId=40204692237
&depCity=345&arrivalCity=345&hotStType=2&priceOfferId=10020707&locale=ru",
//ссылка на кабинет агентства для бронирования. "http://book.tez-tour.com/book/vc/common/spo?spoId=10020707&hotelRoomId=9004082#hotelContent9004082"
//ссылка на спецпредложение в старом кабинете агенства. Актуальность потеряла и будет удалена. ] ], "Анталия", //Региона размещения "ANTALYA", //Регион СПО 7, // 0 - пусто, 1 - мгновенное подтверждение, 2 - раннее бронирование, 4 -
тез рекомендует. Остальные цифры означают комбинацию предложенных вариантов, например, 7=4+2+1, т.е. предложение относится и
к мгновенному подтверждению, и к раннему бронированию, и к тез рекомендует.
Однако, вместо этого поля рекомендуется использовать информацию ниже, она более полная. Например,         
      // "baseHotel": {
         // "value": true,
         // "comment": "Tez рекомендует"
        // }, "AI", //Пансион "Все включено", //Описание пансиона "DBL<br><small>2+0+0</small>", //Размещение и количество человек. Поле неактуально, содержится для поддержки обратной совместимости. "$886", //стоимость тура без доплат. "SPO 1213", //Спецпредложение "Есть", //Наличие мест в отеле "Available", //Наличие мест в эконом-класе при вылете на отдых "No", //Наличие мест в премиум-эконом-классе при вылете на отдых "No", //Наличие мест в бизнес-классе при вылете на отдых "No", //Наличие мест в первом-классе при вылете на отдых "", //Доплаты за перелет в эконом-классе при вылете на отдых "", //Доплаты за перелет в премиум-эконом-классе при вылете на отдых "", //Доплаты за перелет в бизнес-эконом классе при вылете на отдых
      "", //Доплаты за перелет в первом-классе при вылете на отдых
      "Available", //Наличие мест в эконом-классе на обратном рейсе
      "No", //Наличие мест в премиум-эконом-классе на обратном рейсе
      "No", //Наличие мест в бизнес-классе на обратном рейсе
      "No", //Наличие мест в первом-классе на обратном рейсе
      "", //Доплаты за перелет эконом-классом на обратном рейсе
      "", //Доплаты за перелет премиум-эконом-классом на обратном рейсе
      "", //Доплаты за перелет бизнес-эконом классом на обратном рейсе
      "", //Доплаты за перелет первым классом на обратном рейсе
      "Tez рекомендует, раннее бронирование (особые условия бронирования), мгновенное подтверждение", 
//Неактуальное поле. Передается для обратной совместимости. Названия иконок в подборе 112201, // идентификатор спецпредложения 0, //пакетное предложение, говорящее о наличии перелета. Если 1 - значит предложения является пакетным. "http://s.tez-tour.com/hotel/3651/1311788176826_small.jpg", //Ссылка на главную фотографию отеля 886, // стоимость тура "$", // валюта тура [ // в данном блоке передается информация о количестве туристов. Блок может включать до 3х наборов значений.
Первым идет набор, соответсвующий категории туристов Adult, вторым идет набор значенией,
соответсвующий туристам категории big child, последним идет набор значений, соответсвующий категории small child.
Если одна из групп отсутсвует, значит туристов соответсвующей категории по условию тура не предусмотрено.
Описание каждого набора значений приведено ниже. [ 2, // количество туристов данной категории 0, // начальный возраст туристов данной категории. Для взрослых используется 0. 0 //максимальный возраст туристов данной категории. Для взрослых используется 0. ] ], 7, //день недели. { // в данном блоке приведеные дополнительные характеристики отеля "baseHotel": { "value": true, "comment": "Tez рекомендует" // дополнительная характеристика отеля }, "earlyBooking": { //условия раннего бронирования "value": true, "comment": "раннее бронирование (особые условия бронирования)", "text": [ "до 15.05", "Посмотреть правила" ] }, "onlineConfirm": { //мгновенное подверждение "value": true, "comment": "мгновенное подтверждение" }, "pack": { //является ли тур пакетным "value": false }, "topPriority": { //входит ли отель в группу TEZ Приоритет "value": false }, "exclusive": { //входит ли отель в группу TEZ Эксклюзив "value": false }, "flexComission": { //доступна ли по предложению гибкая комиссия "value": false }, "fixComission": { //доступна ли по предложению фиксированная комиссия "value": false } }, {}, - является ли пакет полным или нет. В данном случае пакет полный. 40204692237, // идентификатор контейнера спецпредложения 9000184, // идентификатор отеля 9004082, // hotelRoomType 9004081, // hotelPasion 68567, // возрастная категория groupTypeAge 2, //размещения
1285// регион прилёта
],


Общий справочник формате json

Для вызова общего справочника в формате json используется URL: http://search.tez-tour.com/toursearch/references?locale=ru&formatResult=true&xml=false

Так же можно использовать параметр formatResult=false чтобы получить результат одной строкой.

{
 "success": true
 "cities": [
   {
     "cityId": 345,
     "name": "Москва"ода
   },
   {
     "cityId": 392, 
     "name": "Нижний Новгород"
  }
 ],
 "countries": [
   {
     "countryId": 1104,
     "name": "Турция"
   },
   {
     "countryId": 5732,
     "name": "Египет"
   },
   {
     "countryId": 5733,
     "name": "Испания"
   }
 ],
 "currencies": [
   {
     "currencyId": 5561,
     "name": "Доллар США"
   },
   {
     "currencyId": 8390,
     "name": "Рубль"
   }
 ],
 "hotelClasses": [
   {
     "classId": 2566,
     "name": "1 *",
     "weight": -4
   },
   {
     "classId": 2567,
     "name": "2 *",
     "weight": -1
  }
 ],
 "rAndBs": [
   {
     "rAndBId": 15350,
     "name": "RO",
     "weight": 0
   },
   {
     "rAndBId": 2424,
     "name": "BB",
     "weight": 1
   }	

Описание Справочника

{
 "success": true
 "cities": [
   {
     "cityId": 345,		//id города
     "name": "Москва"		//название города
   },
   {
     "cityId": 392, 		//id города
     "name": "Нижний Новгород"	//название города
  }
 ],
 "countries": [
   {
     "countryId": 1104,	//id страны
     "name": "Турция"		//название страны
   },
   {
     "countryId": 5732, 	//id страны
     "name": "Египет"
   },
   {
     "countryId": 5733,
     "name": "Испания"	//название страны
   }
 ],
 "currencies": [
   {
     "currencyId": 5561,	//id валюты
     "name": "Доллар США"	//название валюты
   },
   {
     "currencyId": 8390, 	//id валюты
     "name": "Рубль"		//название валюты
   }
 ],
 "hotelClasses": [
   {
     "classId": 2566,		//id уровня отеля
     "name": "1 *",		//название уровня отеля
     "weight": -4		//вес(коэффициент) уровня отеля
   },
   {
     "classId": 2567,		//id уровня отеля
     "name": "2 *",		//название уровня отеля
     "weight": -1		//вес(коэффициент) уровня отеля
  }
 ],
 "rAndBs": [
   {
     "rAndBId": 15350,	//id пансиона
     "name": "RO",		//название пансиона
     "weight": 0		// вес(коэффициент) пансиона
   },
   {
     "rAndBId": 2424,		//id пансиона
     "name": "BB",		//название пансиона
     "weight": 1		// вес(коэффициент) пансиона
   }


Справочник по странам в формате json

Для вызова справочника в формате json используется URL: http://search.tez-tour.com/toursearch/byCountry?countryId=1104&cityId=345&locale=ru&xml=true

Так же можно использовать параметр formatResult=false чтобы получить результат одной строкой.

{
 "success": true,
 "tours": [
   {
     "name": "Дахаб",
     "tourId": [
       26313
     ],
     "fromCityId": [
       2552,
       9001185,
       786,
       1392,
       3711,
       2680,
       412,
       392,
       2141,
       6529,
       1107,
       3429,
       345,
       2729,
       3667,
       12044,
       1421,
       1754,
       1776,
       2672
     ]
   },
   {
     "name": "Эль Гуна",
     "tourId": [
       14351
     ],
     "fromCityId": [
       4800,
       17151,
       3711,
       1776,
       2680,
       1754,
       392,
       412,
       2141,
       2729,
       3667,
       345,
       786,
       2552,
       1107,
       9001185,
       521,
       2672,
       3429
     ]
   },
     ]
   }
 ],
 "regions": [
   {
     "regionId": 7078307,
     "name": "HURGHADA"
   },
   {
     "regionId": 7078308,
     "name": "SHARM EL-SHEIKH"
   },
   }
 ],
 "hotels": [
   {
     "tourId": 111466,
     "hotelId": 127648,
     "name": "ABOU DABBAB RESORT 3 *",
     "hcWeight": 2,
     "rbWeight": [
       7,
       1,
       3
     ]
   },
   {
     "tourId": 5735,
     "hotelId": 3012644,
     "name": "AIDA RESORT & HOTELS 3 *",
     "hcWeight": 2,
     "rbWeight": [
       7,
       3
     ]
   },
 ],
 "accommodations": [
   {
     "accommodationId": 1,
     "name": "SGL",
     "children": 0
   },
   {
     "accommodationId": 14317,
     "name": "SGL+CHD",
     "children": 1
   },
   {
     "accommodationId": 2,
     "name": "DBL",
     "children": 0
   },

Расшифровка списка по стране:

{
 "success": true,		//
 "tours": [			//
   {				//
     "name": "Дахаб",		// название региона
     "tourId": [
       26313			// id региона
     ],
     "fromCityId": [
       2552,			//id города вылета, из которого есть перелеты в этот регион
       9001185,		// id города вылета, из которого есть перелеты в этот регион
       786,
       1392,
       3711,
       2680,
       412,
       392,
       2141,
       6529,
       1107,
       3429,
       345,
       2729,
       3667,
       12044,
       1421,
       1754,
       1776,
       2672
     ]
   },
     ]
   }
 ],
 "regions": [
   {
     "regionId": 7078307,		//id региона СПО
     "name": "HURGHADA"		// название региона СПО
   },
   }
 ],
 "hotels": [
   {
     "tourId": 111466,		//id региона
     "hotelId": 127648,		//id отеля
     "name": "ABOU DABBAB RESORT 3 *",	//название отеля
     "hcWeight": 2,			//вес(коэффициент) уровня отеля
     "rbWeight": [
       7,				//вес(коэффициент) пансиона отеля
       1,				//вес(коэффициент) пансиона отеля
       3				//вес(коэффициент) пансиона отеля
     ]
   },
 "accommodations": [
   {
     "accommodationId": 1,		//id размещения
     "name": "SGL",			//название размещения
     "children": 0			//количество детей
   },
   


Список перелетов в формате search

Для вызова списка в формате json используется URL: http://search.tez-tour.com/toursearch/getFlightDeparture?cityId=345&countryId=5733&formatResult=true&xml=false Так же можно использовать параметр formatResult=false чтобы получить результат одной строкой.

Список перелетов

{
 "success": true,
 "data": [
   [
     2010,		//год
     [			//1й месяц
     ], 		//1й месяц
     [			//2й месяц
     ], 		//2й месяц
     [			//3й месяц
     ], 		//3й месяц
     [			//4й месяц
     ], 		//4й месяц
     [			//5й месяц
       28,		//число, на которое назначен перелет
       29, 		//число, на которое назначен перелет
       30		//число, на которое назначен перелет
     ], 		//5й месяц
     [
       2,
       3,
       4,
       5,
       6,
       8,
       9,
       10,
       11,
       12,
       13,
       15,
       16,
       17,
       18,
       19,
       20,
       22,
       23,
       24,
       25,
       26,
       27,
       29,
       30
     ],

 

Справочник с параметрами защиты подбора тура

URL: http://search.tez-tour.com/tariffsearch/protectSettings?countryId=1104&cityId=345&xml=false

countryId - страна отдыха

cityId - город вылета

Ответ:

{
  "success": true,
  "serverName": "amba.teztour.com",
  "settings": [
    {
      "key": "checkin.range.max",
      "value": 20
    },
    {
      "key": "checkout.max",
      "value": 540
    },
    {
      "key": "nights.range.max",
      "value": 8
    }
  ],
  "priceSettings": [
    {
      "currencyId": 46688,
      "maxValue": 1500000
    },
    {
      "currencyId": 132329,
      "maxValue": 1500000000
    },
    {
      "currencyId": 18864,
      "maxValue": 115000
    },
    {
      "currencyId": 53570,
      "maxValue": 150000
    },
    {
      "currencyId": 50159,
      "maxValue": 150000
    },
    {
      "currencyId": 8390,
      "maxValue": 3000000
    },
    {
      "currencyId": 5561,
      "maxValue": 150000
    }
  ],
  "timestamp": "29.11.2013 12:00:01"
}

Расшифровка ответа:

checkin.range.max - максимальный диапазон дат заезда в отель

checkout.max - максимальная дата выезда из отеля

nights.range.max - максимальный диапазон количества ночей проживания

priceSettings - максимальная ширина интервала стоимости тура в запросе для каждой валюты

currencyId - ID валюты

maxValue - ширина интервала

timestamp - дата и время последнего изменения данных настроек

Change background: