hotels
Осуществляет поиск номеров по параметрам
Методы
Возвращает список стран
Пример запроса
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"},
...
]
}
}Возвращает список городов указанной страны.
Параметры
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"},
...
]
}
}
Возвращает номера, доступные для бронирования
Параметры для первого поиска
country string
код страны
city string
код города
start string
Дата заезда. Указывается в любом формате даты, например: 19.04.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..." // Идентификатор сессии, по которому можно получать эти данные
}
}
Подробная информация о гостинице
Параметры
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": ["\"Диетическое меню (по запросу)\"", "\"Завтрак в номер\""]
}
}
}
Возвращает информацию о штрафах при отмене бронирования гостиницы. Перед использованием этого метода необходимо получить информацию от системы поиска методом 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"
}
}
}
Возвращает список стран, для которых есть информация о визе.
Пример запроса
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"},
...
]
}
}Возвращает список городов с консульствами для получения виз.
Параметры
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"
}
]
}
}
Возвращает информацию для получения визы.
Параметры
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