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
: Модель отдельного изображения