Получение статического списка отелей
Метод позволяет получить ссылку на скачивание сжатого gz-файла со списком отелей, разделенных переводом строки. Каждый отель представляет собой документ в формате JSON который содержит статическую или редко изменяемую информацию об отелях.
Примечание
Цены и наличие предложений являются динамической информацией и запрашиваются через API отдельно.
Формат запроса
GET https://whitelabel.travel.yandex-net.ru/feeds/hotels/temporary_url
Authorization: OAuth <OAuth token>
Content-Type: application/JSON
Формат ответа
{
"url": "(string)",
"expires_at": "(string)"
}
Структура отеля в списке:
{
"hotel_id": (integer),
"hotel_url": "(string)",
"names": [
{
"locale": "(string)",
"value": "(string)"
}
],
"location": {
"addresses": [
{
"components": [
{
"kind": "(string)",
"value": "(string)"
}
],
"formatted": "(string)",
"locale": "(string)"
}
],
"country_code": "(string)",
"lat": (double),
"lon": (double)
},
"types": [
"(string)"
],
"stars": "(string)",
"rating": (double),
"check_in": "(string)",
"check_out": "(string)",
"total_review_count": (integer),
"boolean_features": [
"(string)"
],
"value_features": [
{
"id": "(string)",
"value": [
"(string)"
]
},
],
"images": [
{
"url_template": "(string)",
"sizes": [
{
"size": "(string)",
"height": (integer),
"width": (integer)
}
]
}
]
}
Параметры ответа
Параметр |
Тип |
Описание |
|
string |
Ссылка для скачивания файла. |
|
string |
Дата и время окончания действия ссылки в формате UTC (стандарт ISO 8601): |
Параметры отеля в списке:
Параметр |
Тип |
Описание |
|
integer |
Идентификатор отеля. |
|
string |
Ссылка на страницу отеля. |
|
object |
Название отеля с локализацией. |
|
object |
Географическое расположение отеля с локализацией. |
|
string |
Типы жилья. Возможные значения:
|
|
string |
Количество звезд. Принимает значение от 1 до 5 или |
|
double |
Рейтинг отеля. Принимает значение от 1 до 5 (в формате — дробное число, один знак после запятой) или |
|
object |
Время, начиная с которого возможно заселение в номер, в формате |
|
object |
Время, до которого необходимо сдать номер, в формате |
|
integer |
Количество отзывов об отеле. |
|
array |
Особенности и удобства, которые могут быть в отеле. Возможные значения:
|
|
object |
Характеристики отеля. |
|
object |
Список изображений (фотографий) отеля. |
names object |
||
|
string |
Локаль названия в формате UTF-16 (стандарт ISO 639-1). |
|
string |
Значение. |
location object |
||
|
object |
Адреса отелей. |
|
string |
Код страны в формате UTF-16 (стандарт ISO 3166-1). |
|
double |
Широта координат отеля. |
|
double |
Долгота координат отеля. |
value_features object |
||
|
string |
Идентификатор характеристики отеля. Возможные значения:
|
|
string |
Характеристики отеля. Набор значений зависит от того, какой
|
images object |
||
|
string |
Шаблон URL изображения, в котором |
|
object |
Размер изображения. |
addresses object |
||
|
object |
Компоненты адреса. |
|
string |
Отформатированный адрес отеля. |
|
string |
Локаль адреса в формате UTF-16 (ICU локали). |
sizes object |
||
|
string |
Код размера изображения, который подставляется в шаблон URL. Возможные значения:
|
|
integer |
Высота в пикселях. |
|
integer |
Ширина в пикселях. |
components object |
||
|
string |
Типы компонентов адреса. Возможные значения:
|
|
string |
Значение. |
Пример ответа
{
"url": "https://travel-whitelabel-feed.s3-private.mds.yandex.net/testing/hotels.json.gz?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20230629T080151Z&X-Amz-SignedHeaders=host&X-Amz-Expires=3599&X-Amz-Credential=aYgYBmes2dgmzpvizeND%2F20230629%2Fprivate%2Fs3%2Faws4_request&X-Amz-Signature=03e83f...0a3a",
"expires_at": "2023-06-29T15:20:03.492Z"
}
Пример структуры отеля в списке:
{
"hotel_id": 87732700319,
"hotel_url": "https://travel.yandex.ru/hotels/nevsehir-nevsehir- tr/anatolian-houses-cave-hotel",
"names": [
{
"locale": "ru",
"value": "Anatolian Houses Cave Hotel"
},
{
"locale": "en",
"value": "Anatolian Houses Cave Hotel"
},
{
"locale": "tr",
"value": "Anatolian Houses Cave Hotel"
}
],
"location": {
"addresses": [
{
"components": [
{
"kind": "country",
"value": "Türkiye"
},
{
"kind": "province",
"value": "Nevşehir"
},
{
"kind": "area",
"value": "Nevşehir Merkez"
},
{
"kind": "district",
"value": "Göreme Beldesi"
},
{
"kind": "street",
"value": "Cevizli Sok."
}
],
"formatted": "Göreme Beldesi, İsali-Gaferli- Avcılar Mah., Cevizli Sok., Nevşehir Merkez, Nevşehir, Türkiye",
"locale": "en"
},
{
"components": [
{
"kind": "country",
"value": "Türkiye"
},
{
"kind": "province",
"value": "Nevşehir"
},
{
"kind": "area",
"value": "Nevşehir Merkez"
},
{
"kind": "district",
"value": "Göreme Beldesi"
},
{
"kind": "street",
"value": "Cevizli Sok."
}
],
"formatted": "Göreme Beldesi, İsali-Gaferli- Avcılar Mah., Cevizli Sok., Nevşehir Merkez, Nevşehir, Türkiye",
"locale": "tr"
},
{
"components": [
{
"kind": "country",
"value": "Турция"
},
{
"kind": "province",
"value": "Невшехир"
},
{
"kind": "area",
"value": "НевшехирМеркез "
},
{
"kind": "district",
"value": "посёлокГёреме "
},
{
"kind": "street",
"value": "улицаДжевизли "
}
],
"formatted": "Невшехир,НевшехирМеркез,посёлокГёреме,махаллеГёреме - Исали -Гаферли -Авджилар,улицаДжевизли ",
"locale": "ru"
}
],
"country_code": "TR",
"lat": 38.642239,
"lon": 34.832363
},
"types": [
"hotel"
],
"stars": "4",
"rating": null,
"check_in": "14:00",
"check_out": "11:30",
"total_review_count": 0,
"boolean_features": [
"pool",
"heating",
"gym"
],
"value_features": [
{
"id": "internet_in_hotel",
"value": [
"free internet"
]
},
{
"id": "year_of_foundation",
"value": [
"2007"
]
},
{
"id": "hotel_city_center_distance_meters",
"value": [
"9938"
]
}
],
"images": [
{
"url_template": "https://avatars.mds.yandex.net/get- altay/5517598/2a0000017e32ffeb0d3009a86bca0faa4940/%s",
"sizes": [
{
"size": "L",
"height": 333,
"width": 500
},
{
"size": "M",
"height": 200,
"width": 300
},
{
"size": "S",
"height": 100,
"width": 150
}
]
}
]
}