Перейти к содержанию

ImageRequests

Описание: Класс для API-запросов, связанных с изображениями фильмов Этот класс расширяет базовый класс Kinopoisk и предоставляет специализированные методы для работы с изображениями (постеры, кадры, задники) из API Kinopoisk.dev.

С версии: 1.0.0

Версия: 1.0.0

getImagesByMovieId()

Описание: Получает изображения для конкретного фильма

Параметры:

  • $movieId (int): ID фильма в Кинопоиске
  • $type (string): Тип изображения (например: 'poster', 'frame', 'backdrop')
  • $page (int): Номер страницы
  • $limit (int): Количество результатов на странице

Возвращает: ImageDocsResponseDto Изображения указанного фильма

Исключения:

  • KinopoiskDevException: При ошибках API
  • \JsonException: При ошибках парсинга JSON
  • \KinopoiskDev\Exceptions\KinopoiskResponseException:

getImages()

Описание: Получает изображения с возможностью фильтрации и пагинации Выполняет запрос к API Kinopoisk.dev для получения списка изображений фильмов с поддержкой расширенной фильтрации и постраничной навигации. Можно фильтровать по типу изображения, языку, размерам и ID фильма. (тип изображения, ID фильма, язык, размеры). При значении null создается новый экземпляр MovieSearchFilter без фильтров 250) (общее количество, количество страниц, текущая страница)

С версии: 1.0.0

Версия: 1.0.0

API Endpoint: /v1.4/image

Параметры:

  • $filters (MovieSearchFilter|null): Объект фильтрации для поиска изображений по различным критериям
  • $page (int): Номер запрашиваемой страницы результатов, начиная с 1 (по умолчанию 1)
  • $limit (int): Максимальное количество результатов на одной странице (по умолчанию 10, максимум ограничен API до

Возвращает: ImageDocsResponseDto Объект ответа, содержащий массив изображений и метаданные пагинации

Исключения:

  • KinopoiskDevException: При ошибках валидации данных, неправильных параметрах запроса или проблемах с инициализацией объектов
  • KinopoiskResponseException: При ошибках HTTP-запроса к API (401, 403, 404)
  • \JsonException: При ошибках парсинга JSON-ответа от API, некорректном формате данных или повреждении ответа

См. также:

  • \KinopoiskDev\Filter\MovieSearchFilter: Класс для настройки фильтрации изображений
  • \KinopoiskDev\Responses\Api\ImageDocsResponseDto: Структура ответа API
  • \KinopoiskDev\Models\Image: Модель отдельного изображения