Росс·Тур API
Сервис

hotels

Осуществляет поиск номеров по параметрам

Методы

Countries

Возвращает список стран

Пример запроса

http://api.ross-tur.ru/gate/?service=hotels&method=countries&format=json&apiKey=demo

Результат


                        {
                            "success": true,
                            "data": {
                                "list": [
                                    {"id":"56897","code":"au","name":"Австралия","alias":"Australia"}, 
                                    {"id":"56875","code":"at","name":"Австрия","alias":"Austria"}, 
                                    ...
                                 ]
                             }
                        }
Cities

Возвращает список городов указанной страны.

Параметры

country string

код страны

Пример запроса

http://api.ross-tur.ru/gate/?service=hotels&method=cities&format=json&apiKey=demo&country=at

Результат


                        {
                            "success": true,
                            "data": {
                                "list":[
                                    {"code":"AMBI","name":"Агнес Уотер","alias":"Agnes Water - QLD"},
                                    {"code":"ADL","name":"Аделаида","Adelaide - SA"}, 
                                     ...
                                ]
                            }
                        }
                        
    
search

Возвращает номера, доступные для бронирования

Параметры для первого поиска

country string

код страны

city string

код города

start string

Дата заезда. Указывается в любом формате даты, например: 05.10.2024

stop string

Дата выезда. Можно не указывать, если указано количество ночей следующим параметром.

nights integer

Продолжительность проживания. Можно не указывать, если указаны параметры start и stop.

rooms json

Параметры размещения в номерах, rooms = [{adult:1,children:[7,10]},{adult:2,children:[]}]. Если детей в размещении нет, то можно не указывать элемент children.

Параметры для осуществленного поиска

session string

Идентификатор сессии. Если вы хотите использовать уже имеющиеся результаты поиска для получения других страниц или фильтрации, то укажите его. При этом параметры для первого поиска указывать не нужно. Получить идентификатор можно при первом поиске.

Дополнительные параметры

limit integer

Максимальное количество отелей в результате. Если не указано - 200.

page integer

Страница результатов от 0. Смещение в позициях расчитывается по формуле page*limit.

cutempty array

Фильтр результата: cutempty = [address,description,image]. В данном примере из результата будут вырезаны все предложения, имеющие пустой адрес, описание или не имеющие фото.

  • address - не пустой адрес отеля
  • description - не пустое описание отеля
  • image - только отели с фото
  • isrus - удалять отели, если в alias, description, starname или address есть русские символы
  • isnorus - удалять отели, где в описании нет русских символов

languages string или array

Языки вывода информации в порядке предпочтения: languages = [cs,en]. В данном примере будут выведены только предложения на чешском или английском языках. Остальные будут вырезаны из результата. Код языка должен быть указан по стандарту ISO 639-1. Если не найдено информации на первом указанном языке, то в системе останется об этом информация для последующего перевода. В структуре отеля появится дополнительный параметр: "language": "en", указывающий на каком языке выведена информация.

output array

Кроме поля "list" с предложениями отелей, можно получать другую информацию, выдаваемую поисковой системой: output = [courses,opers]

  • courses - курсы валют ЦБР на дату поиска
  • dataform - переданные и обработанные параметры поиска
  • opers - данные поставщиков, предоставивших информацию в результатах поиска
  • attractions - список прилегающих объектов
  • forfilter - списки для наполнения фильтров
  • getvisacost - информация о визах

Пример запроса

http://api.ross-tur.ru/gate/?service=hotels&method=search&format=json&apiKey=demo&country=ru&city=SVX&start=21.03.2018&nights=5&rooms=[{adult:2},{adult:1,children:[3,6]},{adult:1},{adult:1}]
В данном примере осуществляется поиск отелей в Екатеринбурге для группы гостей: 1 номер для двух гостей + 1 номер для одного гостя с двумя детьми трех и шести лет + 2 номера для двух оставшихся гостей.

Результат


                        {
                            "success": true,
                            "data": {
                                "list": [ // Список отелей с предложениями
                                    {
                                        "id": 14805327, // Уникальный идентификатор отеля в системе
                                        "code": "810",
                                        "hotel_ind": "27_0", // Уникальный идентификатор отеля в результате
                                        "city_code": "3430",
                                        "city_id": 2021234
                                        "oper": 27, // Код поставщика
                                        "opername": "ilvestour", // Имя поставщика, если [glue_opers] то отель предложен несколькими операторами
                                        "pricemin": 1812, // Минимальная стоимость проживания в валюте отеля
                                        "currency": "RUR", // Валюта отеля
                                        "night": 5,
                                        "lat": "50.09281000000000005912", // Координаты отеля
                                        "lon": "14.45063000000000030809",
                                        "name": "Centara Grand Beach Resort & Villas Hua Hin", // Имя отеля
                                        "alias": "Centara Grand Beach Resort & Villas Hua Hin",
                                        "chains": "", // Название сети отелей
                                        "address": "1 Damnernkasem Road Hua Hin",
                                        "website":"",
                                        "description": "Местоположение отеля: 
Centara Grand Beach Resort & Villas Hua Hin (Хуахин, Таиланд) находится на пляже, всего в нескольких минутах от следующих достопримечательностей и объектов: Торговый центр в Хуахине и Памятник Поне Кингпетчу.  Этот 5-звездочный курорт находится в непосредственной близости от таких достопримечательностей, как Часовая башня Хуахина и Больница Сан-Пауло в Хуахине.
Номера: 
Почувствуйте себя как дома в одном из 249 номеров с кондиционером и другими удобствами, в числе которых камин и проекционные ТВ-панели. Бесплатный беспроводной интернет позволит всегда оставаться на связи, а спутниковое телевидение не даст скучать. Предоставляются следующие удобства и услуги: телефон, сейфы и письменный стол.
Удобства: 
Расслабьтесь в спа-центре, который предлагает массаж, процедуры по уходу за телом и процедуры по уходу за лицом. Вы непременно оцените предоставляемые возможности для спорта и отдыха, такие как 3 открытых плавательных бассейна, открытый теннисный корт и баня/парная. Этот курорт также предоставляет такие услуги и удобства, какбесплатный беспроводной доступ в интернет, услуги консьержа и уход/присмотр за детьми (за дополнительную плату).
Кафе и рестораны: 
Чтобы вкусно и с удовольствием пообедать, курорт предлагает к вашим услугам 4 ресторана(ов) и кафетерий/кафе. Кроме того, предоставляется круглосуточное обслуживание номеров. Загляните в бар/лаунж или бар у бассейна, чтобы расслабиться за любимым напитком. Ежедневно за дополнительную плату предлагается завтрак. Тип завтрака — шведский стол.
Бизнес, другие удобства и услуги: 
Для удобства гостей предоставляется следующее: бизнес-центр, бесплатные газеты в холле и химчистка или прачечная. Курорт предлагает вам 3 конференц-зала(-ов) для проведения встреч и мероприятий. Предоставляется бесплатная самостоятельная парковка.",
                                        "phone": "0066 (0)32512021",
                                        "image": [
                                          "http://image.metglobal.com/hotelimages/TH6LHD/10161127_0x0.jpg",
                                          "http://image.metglobal.com/hotelimages/TH6LHD/10161092_0x0.jpg",
                                          "http://image.metglobal.com/hotelimages/TH6LHD/10161110_0x0.jpg"
                                        ],
                                        "email": "",
                                        "ageto": 12, // Максимальный возраст детей
                                        "agefrom": 2, // минимальный возраст допускаемых в отель детей
                                        "starcode": "5",
                                        "starname": "5*",
                                        "room": [ // Список предложений отеля
                                            {
                                                "room_ind": "27_0_0", // Идентификатор предложения в результате.
                                                "oper": 27, // Идентификатор поставщика. Может отличаться от указанного в массиве отеля.
                                                "roomcount": "1", // Количество номеров в этом предложении
                                                "roomcode": "27_0_0", // Уникальный идентификатор предложения в результате
                                                "roomid": 1, // Идентификатор варианта заселения. При сложном поиске по нему группируются предложения для всех гостей.
                                                "roomoptionid": "27_0_1_0",
                                                "roomname": "2-Bedroom Duplex Suite -The Club", // Наименование предложения
                                                "adultcount": 2, // Количество взрослых, заселяемых в номер
                                                "childcount": 0, // Количество детей
                                                "onrequest": false, // Если true, то предложение под запрос поставщику
                                                "mealcode":"1",
                                                "mealname": "Завтрак", // Наименование питания
                                                "currency": "USD", // Валюта предложения
                                                "price": 5493, // Полная стоимость предложения в соответствующей валюте
                                                "priceinothercurrency": { // Та же стоимость в разных валютах
                                                    "USD":5493,
                                                    "EUR":4662,
                                                    "RUR":331885,
                                                    "GBP":4108
                                                },
                                                "status": "AV", // AV-возможно автоматическое бронирование, RQ-бронирование только в ручном режиме
                                                "autobron": 0 // Если 1, то возможно бронирование через API
                                            }
                                        ]
                                    }
                                }
                                ...
                            ],
                            "session": "df035be33..." // Идентификатор сессии, по которому можно получать эти данные
                        }
                    }        
                        
                        
HotelInfo

Подробная информация о гостинице

Параметры

id integer

Идентификатор гостиницы

или

code string

код гостиницы

oper integer

код оператора

Дополнительные параметры

languages string или array

Информация об отеле на других языках: languages = [cs,en]. В данном примере будет выведена информация так же на чешском и английском языках, если эти данные есть в системе. Код языка должен быть указан по стандарту ISO 639-1. Информация будет выведена в дополнительной структуре:


   "languages": {
        "cs": {
            "name": "",
            "address": "",
            "description": "",
            "descriptionfull": "",
            "service": [],
            "service1": [],
            "service2": [],
            "service3": []
        },
        "en":[]
    }
		

Пример запроса

http://api.ross-tur.ru/gate/?service=hotels&method=hotelinfo&format=json&apiKey=demo&id=14480035

Результат


{
    "success": true,
    "data": {
        "info": {
            "id": "14480035",
            "code": "the_plough_bb",
            "name": "The Plough B&B",
            "alias": "The Plough B&B",
            "country": {
                "id": "62519",
                "code": "[84]{IE}",
                "name": "Ирландия",
                "alias": "Ireland",
                "attach": {
                    "id": "56948",
                    "code": "ie",
                    "name": "Ирландия",
                    "alias": "Ireland"
                }
            },
            "city": {
                "id": "2002601",
                "code": "6174855",
                "name": "Вентри",
                "alias": "Ventry",
                "lat": "52.133348600000000",
                "lon": "-10.361324400000000"
            },
            "oper": {
                "id": "24",
                "name": "Ostrovok",
                "alias": "ostrovok",
                "usd": "59.8824",
                "eur": "70.7929",
                "gbp": "80.4520",
                "course_time": "15.12.2017 00:15"
            },
            "star": {
                "id": "8960",
                "code": "30",
                "name": "3*",
                "alias": "3*",
                "attach": {
                    "id": "144",
                    "code": "3",
                    "name": "3*",
                    "alias": "3 Звезды"
                }
            },
            "lat": "52.134181171456000",
            "lon": "-10.355066210032000",
            "chains": null,
            "images": ["https:\/\/cdn.ostrovok.ru\/t\/orig\/second\/8d\/8b\/8d8bd7647372dcbed48ac57e2150b537ce21abf7.jpeg", "https:\/\/cdn.ostrovok.ru\/t\/orig\/second\/8a\/9a\/8a9a6fe93821e7d5eeb2dfce144417d7e69df9a5.jpeg", "https:\/\/cdn.ostrovok.ru\/t\/orig\/second\/34\/fc\/34fcd33430b1d3f6f9bdbdb78443243ed96fe931.jpeg"],
            "address": "Ventry",
            "phone": "3,53 +12",
            "email": "theploughventry@gmail.com",
            "website": null,
            "description": "Расположение: \nТрехзвездочный отель «The Plough B&B» находится в 1 км от центра города.\nВ отеле: \nОбратите внимание, что в этом отеле запрещено курение.",
            "descriptionfull": "<h4>Расположение<\/h4>\n<p>Трехзвездочный отель «The Plough B&B» находится в 1 км от центра города.<\/p>\n<h4>В отеле<\/h4>\n<p>Обратите внимание, что в этом отеле запрещено курение.<\/p>",
            "service": ["Общее", "Интернет", "Питание"],
            "service1": ["Отопление", "\"Индивидуальная регистрация заезда и отъезда\"", "Пресса", "\"Чистка обуви\"", "\"Терраса для загара\"", "\"Упакованные ланчи\"", "\"Курение запрещено на всей территории\""],
            "service2": ["\"Бесплатный Wi-Fi\""],
            "service3": ["\"Диетическое меню (по запросу)\"", "\"Завтрак в номер\""]
        }
    }
}
                        
                        
CancellationInfo

Возвращает информацию о штрафах при отмене бронирования гостиницы. Перед использованием этого метода необходимо получить информацию от системы поиска методом search.

Параметры

session string

Идентификатор сессии.

room_ind string или array

Идентификатор предложения. При сложном поиске здесь нужно передать идентификаторы всех предложений для группы: room_ind=[12_0_0,12_0_1,12_0_8]. Предложения должны быть от одного отеля и у всех должен быть различен roomid.

Пример запроса

http://api.ross-tur.ru/gate/?service=hotels&method=cancellationinfo&format=json&apiKey=demo&session=0b104a32a8fe0de80886935c7&room_ind=[12_0_0,12_0_1,12_0_8]

Результат


{
    "success": true,
    "data": {
        "info": {
            "CommentContract": "",
            "LastDayWithoutPenalityCurrency": "",
            "LastDayWithoutPenality": "15.12.2017",
            "LastDayWithoutPenalityType": "Percent",
            "LastDayWithoutPenalityValue": 100,
            "flag_penality": 1,
            "flag_autobrone": 1,
            "orderid": "12b20302b2a6b37acda12da416f46172"
        }
    }
}
    
VisaCountries

Возвращает список стран, для которых есть информация о визе.

Пример запроса

http://api.ross-tur.ru/gate/?service=hotels&method=visacountries&format=json&apiKey=demo

Результат


                        {
                            "success": true,
                            "data": {
                                "list": [
                                    {"id":"56897","code":"au","name":"Австралия","alias":"Australia"}, 
                                    {"id":"56875","code":"at","name":"Австрия","alias":"Austria"}, 
                                    ...
                                 ]
                             }
                        }
VisaConsultCities

Возвращает список городов с консульствами для получения виз.

Параметры

country string

Код страны, для которой нужно получить визу. Список стран можно получить предыдущим методом.

Пример запроса

http://api.ross-tur.ru/gate/?service=hotels&method=visaconsultcities&format=json&apiKey=demo&country=de

Результат


    {
        "success": true,
        "data": {
            "list": [{
                    "id": "1395531",
                    "name": "Екатеринбург",
                    "alias": "Yekaterinburg"
                }, {
                    "id": "1395843",
                    "name": "Москва",
                    "alias": "Moscow"
                }
            ]
        }
    }
    
VisaInfo

Возвращает информацию для получения визы.

Параметры

country string

Код страны, для которой нужно получить визу. Список стран можно получить методом Countries или VisaCountries.

Дополнительные параметры

city_id integer

Идентификатор города, где находится консульство. Можно получить методом VisaConsultCities.

fields array

Перечисления полей, которые нужно получить: fields=[country_id,country,text,visacenter_text]. Если параметр не указан - будут возвращены все доступные поля.

Пример запроса

http://api.ross-tur.ru/gate/?service=hotels&method=visainfo&format=json&apiKey=demo&country=de&city_id=1395531

Результат


{
    "success": true,
    "data": {
        "list": [{
                "id": "67",
                "country_id": "56872",
                "city_id": "1395531",
                "country": "Германия",
                "city": "Екатеринбург",
                "adult_sum": "75",
                "child_sum": "25",
                "visacenter_adult_sum": "80",
                "visacenter_child_sum": "30",
                "child_age": "6",
                "valute": "EUR",
                "url": "http:\/\/hotel.ross-tur.ru\/tpl\/visaprint.php?id=67",
                "status": "1",
                "urgency": "110",
                "surcharge": "0",
                "text": "<p><span style=\"font-size:12px\"><span style=\"font-family:verdana\">Оформление визы возможно только при бронировании турпакета \/ отеля.<\/span>...",
                "visacenter_text": "<p><span style=\"font-size:12px\"><span style=\"font-family:verdana\"><strong>Стоимость визы<\/strong>..."
            }
        ]
    }
}
    

Виджеты

Hotels