Получение списка фотографий отеля

Возвращает список изображений (фотографий) отеля по идентификатору — метаинформация об изображении и URL изображения. Метод поддерживает paging.

Формат запроса

GET https://whitelabel.travel.yandex-net.ru/hotels/hotel/images/
  ? hotel_id=<string>
  & [page_limit=<integer>]
  & [page_token=<string>]
  & [affiliate_clid=<string>]

Authorization: OAuth <OAuth token>
Content-Type: application/JSON

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

Параметр

Описание

hotel_id*

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

page_limit

Размер запрашиваемого блока (страницы).

page_token

Токен начала запрашиваемого блока (страницы). Для первой страницы должен быть пустым. Приходит вместе с предыдущей страницей в поле next_page_token.

affiliate_clid

Идентификатор, выданный партнеру сервисом Яндекс Дистрибуция, к которому относится запрос. При отсутствии параметра будет использован clid, установленный партнеру при регистрации в системе.

* Обязательный параметр

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

https://whitelabel.travel.yandex-net.ru/hotels/hotel/images/?hotel_id=1019057204&page_limit=10
&page_token=20

Формат ответа

{
  "total_image_count": (integer),
  "images" : [
    {
      "url_template": "(string)",
      "sizes": [
        {
          "size": "(string)",
          "height": (integer),
          "width": (integer)
        },
      ]
    },
  ],
  "next_page_token": "(string)"
}

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

Параметр

Тип

Описание

total_image_count

integer

Общее количество изображений (фотографий) отеля.

images

object

Список изображений (фотографий) отеля, одна страница paging.

next_page_token

string

Токен следующей страницы. Значение передается в параметре запроса page_token для получения следующей страницы. not null — означает, что есть еще отели. Параметр может отсутствовать.

images object

url_template

string

Шаблон URL изображения, в котором %s нужно заменить на код определенного размера для получения URL изображения.

sizes

array

Список доступных размеров изображения.

sizes object

size

string

Код размера изображения, который подставляется в шаблон URL.

height

integer

Высота в пикселях.

width

integer

Ширина в пикселях.

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

{
  "total_image_count": 319,
  "images" : [
    {
      "url_template": "https://avatars.mds.yandex.net/get-altay/200322/2a0000015b0b6a243dc584f534df710b4480/%s",
      "sizes": [
        {
          "size": "XXXS",
          "height": 29,
          "width": 50
        },
        {
          "size": "XXL",
          "height": 640,
          "width": 1024
        },
      ]
    },
  ],
  "next_page_token": "30"
}
Написать в службу поддержки