Внимание!
Максимально допустимый диапазон между датами заезда - 30 дней.
Максимально допустимый диапазон между количество ночей - 8 ночей.
Установлено ограничение — 50 запросов в минуту с одного ip-адреса.
Запрос на подбор тура
https://search.tez-tour.com/tariffsearch/getResult?accommodationId=2&after=20.05.2023&before=29.05.2023&cityId=345&countryId=1104&nightsMin=8&nightsMax=12&
currency=5561&priceMin=0&priceMax=120000&hotelClassId=2569&hotelClassBetter=true&rAndBId=2424&rAndBBetter=true
Обязательные параметры:
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 уровня отеля(звездность);
rAndBId=2424 – id пансиона;
Необязательные параметры:
regionId=1234 – id региона СПО. Для каждой страны регион СПО несет свою смысловую нагрузку(в интерфейсе выглядит как список «Тур»). Не может быть использован вместе с tourId.
tourId=1285 – id региона. Можно указать несколько регионов: tourId=14259&tourId=14385. Для двойного проживания указывать tourId=14259,14385. Не может быть использован вместе с spoRegionId.
hotelId=1234 – id отеля. Можно указать несколько регионов: hotelId=1234&hotelId=12345;
birthdays=12.06.2005,12.07.2015,12.03.2002 – параметр должен быть указан только в случае поиска туров с детьми (до 4 дат рождения).
hotelClassBetter=true/false – позволяет(либо не позволяет) выдавать в результате подбора отели классом выше указанного(в интерфейсе выглядит как флажок «и лучше»); По умолчанию false
rAndBBetter=true/false – позволяет(либо не позволяет) выдавать в результате подбора предложения с пансионом уровнем выше указанного(в интерфейсе выглядит как флажок «и лучше»); По умолчанию false
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=true/false – позволяет искать предложения, для которых нет подходящих вылетов обратно (в интерфейсе выглядит как флажок «нет билетов обратно»);. По умолчанию false
noTicketsTo=true/false – позволяет искать предложения, для которых нет подходящих вылетов туда (в интерфейсе выглядит как флажок «нет билетов туда»);. По умолчанию false
hotelInStop=true/false – позволяет искать предложения, для которых отели в стопе (в интерфейсе выглядит как флажок «отели в стопе»); . По умолчанию false
recommendedFlag=true/false - позволяет искать отели только с признаком "TEZ рекомендует". По умолчанию false. По умолчанию false
onlineConfirmFlag=true/false - позволяет искать отели только с признаком "Мгновенное подтверждение". По умолчанию false
promoFlag=true/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": true,
"comment": "TEZ приоритет"
},
"exclusive": { //tez эксклюзив
"value": false
},
"flexComission": { //гибкая комиссия
"value": false
},
"fixComission": { //фиксированная комиссия
"value": false
},
"luxuryHotel": { //роскошный отель
"value": false
},
"externalFlights": { // Регулярные рейсы (Внимание!!! Значение true - для предложения необходим дополнительный подбор регулярных рейсов)
"value": true,
"comment": "Регулярные рейсы"
},
"sber": { // Сбербанк
"value": false
},
"blackFriday": { // Чёрная пятница
"value": false
},
"extraServices": { // Дополнительные услуги
"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 - дата и время последнего изменения данных настроек