Внимание!

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

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

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

 


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

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

https://search.tez-tour.com/tariffsearch/getResult?priceMin=0&priceMax=150000%26currency=5561&nightsMin=6&nightsMax=14&hotelClassId=269506&accommodationId=2&rAndBId=15350&tourType=1&locale=ru&cityId=345&countryId=12695&after=04.05.2020&before=05.05.2020&tourId=14259%2C14358&hotelClassBetter=true&rAndBBetter=true&hotelInStop=false&specialInStop=false&noTicketsTo=false&noTicketsFrom=false&promoFlag=true&version=2&searchTypeId=6&birthdays=

Так же можно использовать параметр 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": "don.teztour.com", //имя сервера, на который был отправлен запрос
  "data": [ //список результатов
    [ //один результат
      "05.05.2020", //дата заезда в формате дата
      [
      ],
      "Вт", //день недели для даты заезда
      8, //количество ночей в туре
      "13.05", //дата возврата
      [ //блок с информацией о регионах
        "Паттайя", //название региона проживания
        "PATTAYA+BANGKOK (2 NIGHTS)", //название региона проживание из тарифа
        14259, //идентификатор региона проживания из справочника 2. Регионы
        694, //идентификатор типа тура из справочника 22. Типы туров
        "Бангкок (Регулярные рейсы)", //название региона прилёта
        486691, //идентификатор региона прилёта из справочника 2. Регионы
        "Бангкок (Регулярные рейсы)", //название региона вылета
        486691, // идентификатор региона вылета из справочника 2. Регионы
        "Паттайя" //название региона проживания
      ],
      [ //блок с информацией об отеле
        "https://www.tez-tour.com/hotel.html?id=390092", //ссылка на описание отеля
        "THE MANGROVE HOTEL 3 *", //название и звёздность отеля
        "https://s.tez-tour.com/hotel/7024249/z1-A-Guest_room-07-Adjusted01-Connecting_Double_rm_9054_small.jpg", //ссылка на маленкое изображение отеля
        390092, //идентификатор отеля
        "/hotel.html?id=390092" //сокращеннная ссылка на отель без домена
      ],
      [ //блок с информацией о пансионе
        "BB", //значение пансиона из справочника 6. Пансионы
        "Только завтраки", //описание пансиона из справочника 6. Пансионы
        2424, //идентификатор пансиона из справочника 6. Пансионы
        31920 //идентификатор пансиона из справочника 9. Связка "Отель-Пансион"
      ],
      [ //блок с информации о типе номера
        14592, //идентификатор типа номера
        "Superior", //название типа номера из справочника 10. Связка "Отель-Тип номера"
        62108 //идентификатор типа номера из справочника 10. Связка "Отель-Тип номера"
      ],
      [ //блок с информацией о группе возрастов
        [ //блок с информацией о группе возрастов по типу (ADT, CHD, INF)
          2, //количество туристов в группе
          0, //минимальный возраст в группе
          0 //максимальный возраст в греппе
        ]
      ],
      { //блок с ценами
        "currency": "$", //валюты
        "currencyId": 5561, //идентификатор валюты 
        "total": "1389", //общая цена в валюте currencyId
        "residences": [
          "0"
        ],
        "flightsTo": [
          {
            "description": "adult",
            "touristCount": 2,
            "price": "0"
          }
        ],
        "flightsFrom": [
          {
            "description": "adult",
            "touristCount": 2,
            "price": "0"
          }
        ],
        "insurance": "0",
        "other": "0",
        "priceTypes": [ //блок с информацией о включенных в стоимость услугах (true - включена , false - не включена)
          true, //услуга проживание
          true, //услуга перелёт
          true, //услуга трансфер
          true //услуга страховка
        ],
        "specialSell": true
      },
      [ //блок с ссылками на создание заявки через онлайн кабинет
        [ //первая ссылка на бронирование 
          "https://online.tez-tour.com/armmanager/workplace/section/new-order?depCity=345&arrivalCity=345&hotStType=2&locale=ru&ftt=3636<t=3636&ftv=3520<v=341&sk=1&rar=486691&rdr=486691&cResId=115776929220&priceOfferId=14630378&cFlyIds=122361858&hResId=35471",
          "BANGKOK PALACE 3 * BB"
        ],
        [ //вторая ссылка на бронирование
          "https://online.tez-tour.com/armmanager/workplace/section/new-order?depCity=345&arrivalCity=345&hotStType=2&locale=ru&ftt=3636<t=3636&ftv=3520<v=341&sk=1&rar=486691&rdr=486691&cResId=115776929220&priceOfferId=14630378&cFlyIds=122361858&hResId=86015",
          "ROYAL BENJA HOTEL 3 * BB"
        ]
      ],
      "Есть", //наличие мест в отеле
      [ //список доступных классов кресел, чартерные рейсы
        {
          "to": { //блок с информацией туда
            "first": { //класс кресла
              "seatSet": "Available", //наличие мест (No - нет, Few - мало, Available - Есть)
              "charge": "0" //доплата
            },
            "business": {
              "seatSet": "Available",
              "charge": "0"
            },
            "econom": {
              "seatSet": "Available",
              "charge": "0",
              "childCharge": "0",
              "infantCharge": "0"
            },
            "premiumEconom": {
              "seatSet": "Available",
              "charge": "0"
            },
            "price": "209"
          },
          "from": { //блок с информацией обратно
            "first": {
              "seatSet": "Available",
              "charge": "0"
            },
            "business": {
              "seatSet": "Available",
              "charge": "0"
            },
            "econom": {
              "seatSet": "Available",
              "charge": "0",
              "childCharge": "0",
              "infantCharge": "0"
            },
            "premiumEconom": {
              "seatSet": "Available",
              "charge": "0"
            },
            "price": "209"
          }
        }
      ],
      { //блок содержит дополнительную информацию о предложение (содержит логические переменные: true - является , false - не является; comment и text - комментарий к дополнительной информаци)
        "baseHotel": { //tez рекомендует
          "value": true,
          "comment": "Tez рекомендует"
        },
        "earlyBooking": { //раннее бронирование
          "value": false
        },
        "onlineConfirm": { //мгновенное подтверждение
          "value": true,
          "comment": "мгновенное подтверждение"
        },
        "pack": { //пакетный тур
          "value": false
        },
        "topPriority": { //tez приоритет
          "value": false
        },
        "exclusive": { //tez эксклюзив
          "value": false
        },
        "flexComission": { //гибкая комиссия
          "value": false
        },
        "fixComission": { //фиксированная комиссия
          "value": false
        },
        "luxuryHotel": { //роскошный отель
          "value": false
        },
        "externalFlights": { //регулярный перелёт (Внимание!!! Значение true - для предложения необходим дополнительный подбор регулярных рейсов)
          "value": true,
          "comment": "Регулярные рейсы"
        },
        "sber": { //акция сбербанк
          "value": false 
        },
        "blackFriday": { //устарвшие поля
          "value": false
        },
        "balttour": { //устарвшие поля
          "value": false
        },
        "promos": [ //блок с акциями
        ]
      },
      2, //количество проживаний
      [
        "Москва",
        "Россия"
      ],
      59176, //идентификатор примечения в тарифе
      "Отдых в Паттайе + 2 ночи в Бангкоке. Действуют специальные скидки на экскурсии в Паттайе. Подробнее", //текст примечения
      "",
      [
        2,
        true
      ],
      "",
      [
        3636, //идентификатор трансфера в отель из справочника 25. Типы трансферов
        3636 //идентификатор трансфера из отель из справочника 25. Типы трансферов
      ],
      [
        3520, //идентификатор трансфера в отель из справочника 26. Справочник машин
        341 //идентификатор трансфера из отель из справочника 26. Справочник машин
      ],
      {}
    ],
 "info": [ //блок с информацией о запросе
    [
      "Время выполненения",
      "0.87"
    ],
    [
      "Кол-во результатов",
      "100"
    ],
    [
      "Примечания",
      "доплата за авиабилет с одного человека в одну сторону"
    ],
    [
      "Еще результаты",
      "true"
    ],
    [
      "timestamp",
      "23.03.2020 10:26:32"
    ]
  ],
  "scalePrice": 0, //признак округления цены
  "departureCityId": 345, //идентификатор города вылета
  "arrivalCountryId": 12695 //идентификатор страны прилёта
}


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

Для вызова общего справочника в формате json используется URL: https://search.tez-tour.com/tariffsearch/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: https://search.tez-tour.com/tariffsearch/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: https://search.tez-tour.com/tariffsearch/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: https://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 - дата и время последнего изменения данных настроек