API данных отелей

URL запроса

Начинается каждый запрос одинаково: http://engine.hotellook.com

Обратите внимание! Часть данных можно получить без использования партнерского токена — это методы получения отеля или локации по названию/координатам. Остальные запросы требуют указания партнерского токена в запросе.

Методы API

Поиск отеля или локации по названию

Поиск конкретного места или отеля по названию локации.

Обратите внимание! Если вы отправляете запрос без токена, то количество обращений будет ограничено. В header ответа передаются значения ограничений:

  • X-Ratelimit-Interval — интервал в секундах, на который устанавливается лимит;
  • X-Ratelimit-Remaining — сколько запросов осталось из этого лимита;
  • X-Ratelimit-Limit — значение лимита.

Параметры запроса

Полужирным выделены обязательные параметры.

  • query — основной параметр, задается:
    • в виде текста, при этом строится автокомплит по тексту;
    • широтой и долготой (указываются через запятую), при этом выводятся ближайшие объекты.
  • lang — язык вывода. Может принимать любой iso-код языка (ru, es, fr, de, …) — если перевод на запрошенный язык отсутствует в базе, возвращается английское название объекта. По умолчанию «en».
  • lookFor — объекты выводимые в результатах:
    • city (города и острова);
    • hotel (отели);
    • both (все объекты, значение по умолчанию).
  • limit — ограничение количества выводимых результатов, от 1 до 100, по умолчанию — 10.
  • convertCase — автоматическое изменение раскладки (актуально для русскоязычных пользователей, например, при запросе «vjcrdf» будет найдена «москва»). Значения — 1 или 0, по умолчанию — 1.

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

http://engine.hotellook.com/api/v2/lookup.json?query=moscow&lang=ru&lookFor=both&limit=1

Пример ответа

{
    "results": {
    "locations": [
    {
       "cityName": "Москва",
       "fullName": "Москва, Россия",
       "countryCode": "RU",
       "countryName": "Россия",
       "iata": [
            "BKA",
            "DME",
            "SVO",
            "VKO",
            "MOW"
        ],
        "id": "12153",
        "hotelsCount": "930",
       "location": {
        "lat": "55.752222200",
        "lon": "37.615555600"
        },
        "_score": 3.2695
    }
    ],
    "hotels": [
    {
        "label": "Отель Novotel Moscow City",
        "locationName": "Москва, Россия",
        "locationId": "12153",
        "id": "1074388",
        "fullName": "Отель Novotel Moscow City, Москва, Россия",
        "location": {
        "lat": "55.747160",
        "lon": "37.539302"
        }
    }
    ]
    },
  "status": "ok"
}

Параметры ответа

Блок locations содержит:

  • cityName — название города.
  • fullName — название города и страны, в которой он находится.
  • countryCode — код страны.
  • countryName — название страны.
  • iata — IATA код аэропортов в данном городе, может быть несколько.
  • id — id локации в базе.
  • hotelsCount — количество отелей в данной локации.
  • location:
    • lat — широта локации.
    • lon — долгота локации.
  • score — внутренний параметр, используемый для сортировки.

Блок hotels содержит:

  • label — название отеля.
  • locationName — местоположение отеля.
  • locationId — id локации в базе.
  • Id — id отеля в базе.
  • fullName — полное название отеля с указанием места нахождения.
  • location:
    • lat — широта отеля.
    • lon — долгота отеля.

Поиск отеля или локации по координатам

Поиск конкретного места или отеля по координатам.

Обратите внимание! Если вы отправляете запрос без токена, то количество обращений будет ограничено. В header ответа передаются значения ограничений:

  • X-Ratelimit-Interval — интервал в секундах, на который устанавливается лимит;
  • X-Ratelimit-Remaining — сколько запросов осталось из этого лимита;
  • X-Ratelimit-Limit — значение лимита.

Параметры запроса

Полужирным выделены обязательные параметры.

  • query — основной параметр, задается:
    • в виде текста, при этом строится автокомплит по тексту;
    • широтой и долготой (указываются через запятую), при этом выводятся ближайшие объекты.
  • lang — язык вывода. Может принимать любой iso-код языка (ru, es, fr, de, …) — если перевод на запрошенный язык отсутствует в базе, возвращается английское название объекта. По умолчанию «en».
  • lookFor — объекты выводимые в результатах:
    • city (города и острова);
    • hotel (отели);
    • both (все объекты, значение по умолчанию).
  • limit — ограничение количества выводимых результатов, от 1 до 100, по умолчанию — 10.
  • convertCase — автоматическое изменение раскладки (актуально для русскоязычных пользователей, например, при запросе «vjcrdf» будет найдена «москва»). Значения — 1 или 0, по умолчанию — 1.

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

http://engine.hotellook.com/api/v2/lookup.json?query=55.0291,82.9059&lang=ru&lookFor=both&limit=1

Пример ответа

{
    "results": {
    "locations": [
    {
        "id": "12167",
        "type": "City",
        "countryIso": "RU",
        "name": "Новосибирск",
        "state": "",
        "fullname": "Новосибирск, Россия",
        "geo": {
            "lat": "55.028705000",
            "lon": "82.906898000"
        }
  }
  ],
  "hotels": [
    {
        "id": "380923",
        "name": "AZIMUT Отель Сибирь",
        "locationId": "12167",
        "location": {
            "lat": "55.029140",
            "lon": "82.905990"
            }
        }
    ]
    },
    "status": "ok"
}

Параметры ответа

Блок locations содержит:

  • id — id локации в базе.
  • type — тип локации (город, остров).
  • countryIso — буквенный код страны.
  • name — название локации.
  • state — код штата, если есть.
  • fullname — полное название локации с указанием названия страны.
  • geo:
    • lat — широта локации.
    • lon — долгота локации.

Блок hotels содержит:

  • Id — id отеля в базе.
  • name — название отеля.
  • locationId — id локации в базе.
  • location:
    • lat — широта отеля.
    • lon — долгота отеля.

Вывод стоимости проживания в отелях

Запрос используется для получения из кэша стоимости проживания в отеле за указанный период. Не содержит информацию о наличии свободных номеров.

Обратите внимание! Если вы отправляете запрос без токена, то количество обращений будет ограничено. В header ответа передаются значения ограничений:

  • X-Ratelimit-Interval — интервал в секундах, на который устанавливается лимит;
  • X-Ratelimit-Remaining — сколько запросов осталось из этого лимита;
  • X-Ratelimit-Limit — значение лимита.

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

http://engine.hotellook.com/api/v2/cache.json?location=Moscow&currency=rub&checkIn=2017-06-10&checkOut=2017-06-12&limit=10

Параметры запроса

Полужирным выделены обязательные параметры.

  • location — имя локации (может использоваться IATA код локации);
  • checkIn — дата заселения;
  • checkOut — дата выселения;
  • locationId — id локации (может использоваться вместо location);
  • hotelId — id отеля;
  • hotel — имя отеля (при вводе имени обязательно указывать location или locationId);
  • adults — количество гостей (по умолчанию 2);
  • children — число детей (возраст от 2 до 18 лет);
  • infants — число младенцев (возраст от 0 до 2 лет);
  • limit — количество отелей. Если данный параметр используется в запросе без указания точного id или названия отеля, то действует следующее правило:
    • limit = 4 (значение по умолчанию) — вернется по одному отелю каждой категории (звездности);
    • limit = 5 — вернется два пятизвездочных отеля и по одному других категорий;
    • limit = 6 — по два 5-ти и 4-х звездочных отеля и остальные по одному;
    • limit = 7 — по два 5, 4 и 3-х звездочных отеля и один двухзвездочный;
    • limit = 8 — всех по два. И так далее, с ростом параметра по очереди увеличивается количество отелей каждой звездности. Если отелей указанной звездности больше нет, то в выдачу начнут попадать отели 1 и 0 звездности по такому же правилу.
  • customerIp — параметр используется для указания ip пользователя, если запрос отправляется не напрямую, а через какое-либо серверное проксирование.

Пример ответа

{
"location":{
"country":"Russia",
"geo":{
"lon":37.617508,
"lat":55.752041
},
"state":null,
"name":"Moscow"
},
"priceAvg":60897.74,
"pricePercentile":{
"3":28863.56,
"10":28863.56,
"35":47805.27,
"50":59531.09,
"75":65435,
"99":120128.17
},
"hotelName":"Mercure Arbat Moscow",
"stars":4,
"locationId":12153,
"hotelId":333561,
"priceFrom":28863.56
}

Параметры ответа

В ответе содержатся:

  • stars — количество звезд;
  • locationId — id локации данного отеля;
  • priceFrom — минимальная цена за проживание в номере отеля за указанный период;
  • priceAvg — средняя цена за проживание в номере за указанный период;
  • pricePercentile — распределение цен по долям (например, запись вида «50»:59531.09 означает, что 50% цен находится в диапазоне до 59531.09 руб.)
  • hotelName — название отеля;
  • location — информация о локации отеля:
    • geo — координаты отеля;
    • name — название локации (города);
    • state — штат, в котором расположен город;
    • country — страна отеля.
  • hotelId — id отеля.

Список отелей в архиве

С помощью запроса http://yasen.hotellook.com/tp/v1/hotels?language=ru можно скачать список всех отелей для указанного языка.

Параметр language может принимать значения:

  • ru (русский);
  • en (английский);
  • th (тайский);
  • de (немецкий);
  • es (испанский);
  • fr (французкий);
  • it (итальянский);
  • pl (польский).

Файл со списком отелей содержит следующую данные:

  • id — уникальный id отеля;
  • name — название отеля;
  • location_name — название места расположение отеля;
  • location_id — уникальный id локации отеля;
  • location_iata — IATA код локации отеля;
  • country_name — название страны, в которой расположен отель;
  • photos_count — количество фотографий отеля в базе.

Файл с отелями обновляется один раз в неделю в час ночи (GMT) с субботы на воскресенье.

Подборки отелей

Запрос возвращает подборку отелей, определенной тематики, по ID локации. Подборка формируется за определенный период (даты заезда и выселения).

Если не указать период, то в подборку попадают отели, найденные за последние три дня. У таких отелей может быть указана скидка за проживание.

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

http://yasen.hotellook.com/tp/public/widget_location_dump.json?currency=rub&language=ru&limit=5&id=12209&type=popularity&check_in=2017-02-02&check_out=2017-02-17&token=Укажите_здесь_ваш_токен

Параметры запроса

  • check_in — дата заселения;
  • check_out — дата выселения;
  • currency — валюта ответа;
  • language — язык ответа;
  • limit — ограничение на выводимое количество отелей;
  • type — типы отелей из запроса /tp/public/available_selections.json (см. ниже);
  • id — id города (из запроса Города).

Пример ответа

{
  "popularity":[
  {
    "hotel_id":713859,
    "distance":6.68,
    "name":"Президент Отель",
    "stars":4,
    "rating":87,
    "property_type":"hotel",
    "hotel_type":[
        "Отель для индивидуальных путешественников"
    ],
    "last_price_info":{
        "price":39707,
        "old_price":42761,
        "discount":7,
        "insertion_time":1485464441,
        "nights":15,
        "search_params":{
            "adults":2,
            "children":{},
            "checkIn":"2017-02-02",
            "checkOut":"2017-02-17"
        },
        "price_pn":2647,
        "old_price_pn":2851
    },
    "has_wifi":true
    }
]}

Параметры ответа

  • hotel_id — уникальный id отеля;
  • distance — расстояние от отеля до центра города;
  • name — название отеля;
  • stars — количество звезд;
  • rating — рейтинг отеля среди посетителей;
  • property_type — тип отеля:
    • apartment;
    • apartmen_hotel;
    • guest_house;
    • hotel;
    • hostel;
    • other.
  • hotel_type — описание типа отеля;
  • last_price_info — информация о последней найденной цене отеля (может отсутствовать)
    • price — стоимость проживания за весь период со скидкой;
    • old_price — стоимость проживания, найденная до скидки;
    • discount — размер скидки;
    • insertion_time — время, когда была найдена подборка;
    • nights — количество ночей.
    • search_params — параметры поиска:
      • adults — количество взрослых;
      • children — количество детей;
      • checkIn — дата заселения;
      • checkOut — дата выселения.
    • price_pn — стоимость ночи в отеле со скидкой;
    • old_price_pn — стоимость ночи в отеле до скидки;
  • has_wifi — наличие в отеле Wi-Fi.

Типы отельных подборок

Запрос возвращает список всех существующих отельных подборок. Данный тип используется в получении подборок отелей.

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

http://yasen.hotellook.com/tp/public/available_selections.json?id=12209&token=Укажите_здесь_ваш_токен

Пример ответа

[
"center",
"tophotels",
"highprice",
"3-stars",
"4-stars",
"5-stars",
"restaurant",
"pets",
"pool",
"cheaphotel_ufa",
"luxury_ufa",
"price",
"rating",
"distance",
"popularity",
"2stars",
"3stars",
"4stars",
"5stars"
]

Параметры ответа

  • center — отели в центре города;
  • tophotels — лучшие отели;
  • highprice — самые дорогие отели;
  • 3-stars, 4-stars, 5-stars — автоматическая подборка отелей с 3, 4 или 5 звездами;
  • restaurant — наличие собственного ресторана;
  • pets — можно ли держать животных;
  • pool — наличие бассейна;
  • cheaphotel — самые дешевые отели;
  • luxury — отели высшего качества;
  • price — вручную сформированные подборки по цене;
  • rating — отели с наибольшим рейтингом;
  • distance — расстояние от аэропорта;
  • popularity — популярность отеля (используется внутренний алгоритм);
  • 2stars, 3stars, 4stars, 5stars — вручную собранные подборки с соответствующим количеством звезд.

Статические данные

Запросы, в результате которых партнер получает информацию о странах, городах и отелях.

Обратите внимание! По умолчанию установлено ограничение: 60 запросов в минуту. Если требуется обрабатывать больше запросов, напишите на support@travelpayouts.com.

Запрос «Страны»

Параметры запроса

  • token — ваш партнерский токен.

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

http://engine.hotellook.com/api/v2/static/countries.json?token=УкажитеВашТокен

Пример ответа

[{ "id": "9",
   "code": "DZ",
   "name": {
      "EN": [{
         "isVariation": "0",
         "name": "Algeria"
      }],
      "RU": [{
         "isVariation": "0",
         "name": "\u0410\u043b\u0436\u0438\u0440"
      }]
   }
},
{
   "id": "10",
   "code": "AO",
   "name": {
      "EN": [{
         "isVariation": "0",
         "name": "Angola"
      }],
      "RU": [{
         "isVariation": "0",
         "name": "\u0410\u043d\u0433\u043e\u043b\u0430"
      }]
   }
}]

Параметры ответа

В ответе содержатся:

  • Id — id страны.
  • code — код страны.
  • Блок EN:
    • isVariation — указывает основное или дополнительное название отображается. 1 — дополнительное, 0 — основное. Например, Санкт-Петербург (0), Ленинград (1), Питер (1).
    • name — название страны на английском.
  • Блок RU:
    • isVariation — указывает основное или дополнительное название отображается.
    • name — название страны на русском.

Запрос «Города»

Параметры запроса

  • token — ваш партнерский токен.

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

http://engine.hotellook.com/api/v2/static/locations.json?token=УкажитеВашТокен

Пример ответа

[{
   "id": "373",
   "code": "",
   "countryId": "77",
   "latitude": "15.501950000",
   "longitude": "73.910090000",
   "name": {
      "EN": [{
         "isVariation": "0",
         "name": "Goa"
      }],
      "RU": [{
         "isVariation": "0",
         "name": "\u0413\u043e\u0430"
      }]
   }
}]

Параметры ответа

В ответе содержатся:

  • Id — id города (locationId).
  • code — iata-код города.
  • countryId — id страны.
  • latitude — широта города.
  • longitude — долгота города.
  • Блок DE:
    • isVariation — указывает основное или дополнительное название отображается. 1 — дополнительное, 0 — основное.
    • name — название города на немецком.
  • Блок EN:
    • isVariation — указывает основное или дополнительное название отображается.
    • name — название города на английском.
  • Блок RU:
    • isVariation — указывает основное или дополнительное название отображается.
    • name — название города на русском.

Запрос «Amenities»

Параметры запроса

  • token — ваш партнерский токен.

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

http://engine.hotellook.com/api/v2/static/amenities.json?token=УкажитеВашТокен

Пример ответа

[{
   "id": "2",
   "name": "Hairdryer",
   "groupName": "Room"
},
{
   "id": "3",
   "name": "Safe",
   "groupName": "Room"
},
{
   "id": "4",
   "name": "TV",
   "groupName": "Room"
}]

Параметры ответа

Ответ отдается на английском языке. В ответе содержатся:

  • Id — id удобств в базе.
  • name — название удобств.
  • groupName — расположение удобств.

Что бы получить ответ на другом языке, необходимо использовать запросы вида:

  • Русский: /api/v2/static/amenities/ru.json.
  • Французский: /api/v2/static/amenities/fr.json
  • Немецкий: /api/v2/static/amenities/de.json.
  • Испанский: /api/v2/static/amenities/es.json.

Запрос «Hotels list»

Параметры запроса

  • locationId — id локации, обязательный параметр.
  • token — ваш партнерский токен.

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

http://engine.hotellook.com/api/v2/static/hotels.json?locationId=895&token=УкажитеВашТокен

Пример ответа

{
"hotels":[{
   "photos":[
      {
         "width":320,
         "url":"http:\/\/photo.hotellook.com\/image_v2\/limit\/h678963_0\/320\/240.auto",
         "height":240
      }
   ],
   "checkIn":null,
   "cntSuites":null,
   "distance":9.7,
   "address":{
      "en":"6th Mile Post gonnoruwa road bandagiriya,"
   },
   "cntRooms":null,
   "photoCount":6,
   "name":{
      "zh":"\u73ed\u9054\u57fa\u91cc\u9109\u6751\u98ef\u5e97",
      "th":"\u0e1a\u0e31\u0e19\u0e14\u0e32\u0e01\u0e34\u0e23\u0e35 \u0e27\u0e34\u0e25\u0e40\u0e25\u0e08",
      "en":"Bandagiri Village"
   },
   "cityId":895,
   "checkOut":null,
   "cntFloors":null,
   "rating":0,
   "yearRenovated":null,
   "stars":0,
   "yearOpened":null,
   "propertyType":0,
   "facilities":[
      131,
      56,
      50,
      14,
      40,
      13,
      11
   ],
   "link":"\/lk\/weerawila-895\/bandagiri_village-678963.html",
   "popularity":600,
   "location":{
      "lat":6.23485,
      "lon":81.14245
   },
   "shortFacilities":[
      "air conditioning",
      "parking",
      "laundry",
      "wi-fi in public areas",
      "fitness"
   ],
   "pricefrom":70,
   "photosByRoomType":{
      "1":10,
      "25":10
   },
   "id":678963,
   "poi_distance":{
      "70650":52747,
      "71334":10762,
      "70643":94961,
      "70649":94654
   }
   }],
"gen_timestamp":1480288607.1637635231,
"pois":[
   {
   "confirmed":true,
   "rating":0,
   "location":{
      "lat":5.990833,
      "lon":80.733333
   },
   "name":"Dickwella Airport",
   "geom":{
      "type":"Point",
      "coordinates":[
         80.733333,
         5.990833
      ]
   },
   "category":"airport",
   "id":70650
   }
   ]
}

Параметры ответа

В ответе содержатся:

  • id — id отеля в базе hotellook.
  • cityId — id города.
  • stars — количество звезд.
  • pricefrom — минимальная найденная стоимость ночи, в USD
  • rating — рейтинг посетителей. Параметры рассчитывается на основе рейтинга гостей, который составляется на основе голосования.
  • popularity — популярность отеля. Популярность рассчитывается нами автоматически на основе совокупности многих параметров, их несколько десятков.
  • propertyType — тип отеля (хостел, мотель, вилла, и т. п.).
  • checkOut — время выселения.
  • checkIn — время заселения.
  • distance — расстояние до центра.
  • yearOpened — год открытия отеля.
  • yearRenovated — год последней реконструкции отеля.
  • photoCount — количество фотографий.
  • photos
    • url — ссылка на фотографию.
    • width — ширина фотографии.
    • height — высота фотографии.
  • photosByRoomType — фотографии типов комнат. Ключ — id типа комнаты, значение — количество фотографий.
  • facilities — id удобства в базе.
  • shortFacilities — наличие удобств из списка: 'restaurant', 'parking', 'non-smoking', 'pets', 'tv', 'laundry', 'conditioning', 'internet', 'pool', 'fitness'.
  • location
    • lat — широта отеля.
    • lon — долгота отеля.
  • name — название отеля:
    • en — на английском языке (есть всегда);
    • ru — адрес на русском (может отсутствовать).
  • cntFloors — количество этажей.
  • cntRooms — количество комнат.
  • address — адрес отеля:
    • en — на английском языке (есть всегда);
    • ru — адрес на русском (может отсутствовать).
  • link — ссылка на страницу отеля.
  • poi_distance — расстояние до важных мест (в списке отображается id места из массива pois и расстояние до него в метрах).
  • pois — массив ближайших важных мест:
    • confirmed — подтвержденное место;
    • rating — рейтинг места (если есть);
    • location — координаты;
    • name — название места;
    • geom — координаты точки;
    • category — категория места;
    • id — id места в базе.

Запрос «Типы комнат»

Параметры запроса

  • language — язык ответа (поддерживаются языки: pt, en, fr, de, id, it, pl, es, th, ru);
  • token — ваш партнерский токен.

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

http://engine.hotellook.com/api/v2/static/roomTypes.json?language=en&token=УкажитеВашТокен

Пример ответа

{
   "8":"Apartment",
   "18":"Bungalow",
   "15":"Business",
   "73":"Business apartment",
   "86":"Business deluxe",
   ...
}

Ответ содержит id комнаты и её название.

Запрос «Типы отелей»

Параметры запроса

  • language — язык ответа (поддерживаются языки: pt, en, fr, de, id, it, pl, es, th, ru);
  • token — ваш партнерский токен.

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

http://engine.hotellook.com/api/v2/static/hotelTypes.json?language=ru&token=УкажитеВашТокен

Пример ответа

{
   "1":"Hotel",
   "6":"Guest House",
   "4":"Apartment \/ Condominium",
   "3":"Bed & Breakfast",
   "7":"Hostel",
   "8":"Resort",
   "5":"Motel",
   "10":"Vacation Rental",
   "2":"Apartment Hotel",
   "12":"Villa",
   "11":"Lodge",
   "9":"Agriturismo \/ Farm Stay",
   "0":"Other"
}

Запрос «Фотографии отеля»

Параметры запроса

  • h+Id — буква h + идентификатор отеля (из static/hotels.json).
  • photoId — порядковый номер фотографии отеля.
  • photosize — размер фотографии (указывается в виде «ширина/высота», если указано одно значение, то отобразится квадратная фотография).

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

https://photo.hotellook.com/image_v2/limit/h418520_1/800/520.auto

https://photo.hotellook.com/image_v2/crop/h418520_1/800/520.auto

где

  • limit — возвращает фотографию не больше заданного размера;
  • crop — возвращает фотографию отеля, заданного размера. При этом фотография будет отмасштабирована/обрезана под указанный размер;
  • 418520 — id отеля;
  • 1 — порядковый номер фотографии;
  • 800 — ширина;
  • 520 — высота;
  • .auto — ставится для того, чтобы наша система проверила, может ли браузер пользователи принять WebP формат изображения. Если да, сервер предоставит изображение в формате WebP. Если нет, изображение будет в формате JPEG.

Запрос «Фотографии комнат отеля в виде спрайта»

Чтобы получить спрайт с фотографиями отеля, используйте код вида:

http://photo.hotellook.com/rooms/sprite/h<hotel_id>_<group_id>/<first_width>/<photos_count-1>/<rest_photos_width>.auto

Параметры запроса

  • h+Id — буква h + идентификатор отеля (из static/hotels.json).
  • group_id — id типа комнаты (из static/hotels.json и internalTypeId из ответа поиска).
  • first_width — ширина первой фотографии в спрайте.
  • photos_count-1 — количество фотографий данного типа комнат минус один (из static/hotels.json). Например, если в ответе приходит, что фотографий данного типа 4 штуки, то вместо этого параметра указывается 3.
  • rest_photos_width — ширина остальных фотографий в спрайте.
  • auto — ставится для того, чтобы наша система проверила, может ли браузер пользователи принять WebP формат изображения. Если да, сервер предоставит изображение в формате WebP. Если нет, изображение будет в формате JPEG.

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

http://photo.hotellook.com/rooms/sprite/h4_1/100/3/50.auto

http://photo.hotellook.com/rooms/sprite/h4_12/100/3/50.auto

Чтобы получить спрайт с прямоугольными фотографиями, необходимо вместе с шириной указать высоту фотографий:

http://photo.hotellook.com/rooms/sprite/h4_12/100×50/3/50×25.auto

Дополнительная информация

Чтобы получить фотографию комнаты, заданного размера, используйте код вида:

http://photo.hotellook.com/rooms/crop/h<hotel_id>_<group_id>_<photo_idx>/<width>/<height>.auto

При этом фотография будет отмасштабирована и обрезана под указанный размер.

Чтобы получить фотографию не больше заданного размера, используйте код вида:

http://photo.hotellook.com/rooms/limit/h<hotel_id>_<group_id>_<photo_idx>/<width>/<height>.auto

Параметры в запросе аналогичны описанным выше, кроме photo_idx — это индекс фотографии в списке (индекс первой фотографии — 0).

http://photo.hotellook.com/rooms/crop/h4_12_1/200/200.auto

Запрос «Фотография города»

Чтобы получить фотографию города, используйте запрос вида:

https://photo.hotellook.com/static/cities/960x720/LED.jpg

где 960x720 — размер фотографии, LED — IATA код города.

Ошибки запросов

Все входные параметры проверяются и выдаются ошибки, если они неверны:

  • errorCode 1 — не все обязательные параметры указаны или указаны неверно.
  • errorCode 2 — как минимум один из параметров не соответствует формату.
  • errorCode 3 — доступ запрещен.
  • errorCode 4 — поиск еще не закончен.

При наличие любой из ошибок запрос завершается с http-статусом, отличным от 200 (например 409, 403, 400 и др.).

Была ли эта статья полезной?

Еще есть вопросы? Отправить запрос