ReviewRequests¶
Описание: Класс для API-запросов, связанных с рецензиями Предоставляет методы для работы с рецензиями пользователей на фильмы и сериалы через API Kinopoisk.dev. Включает поиск рецензий по различным критериям, фильтрацию по типу (позитивные, негативные, нейтральные) и получение статистики по рецензиям. Основные возможности: - Поиск рецензий по различным критериям - Получение позитивных рецензий - Получение негативных рецензий - Фильтрация по автору, фильму, типу рецензии - Пагинация результатов
С версии: 1.0.0
Версия: 1.0.0
Пример:
См. также:
\KinopoiskDev\Filter\ReviewSearchFilter
: Для настройки фильтрации\KinopoiskDev\Models\Review
: Модель рецензии\KinopoiskDev\Responses\Api\ReviewDocsResponseDto
: Ответ с рецензиями
getPositiveReviews()
¶
Описание: Получает положительные рецензии Удобный метод для получения только позитивных рецензий. Автоматически применяет фильтр по типу "Позитивный" и возвращает рецензии с положительной оценкой фильма.
С версии: 1.0.0
Параметры:
$page
(int): Номер страницы результатов (по умолчанию: 1)$limit
(int): Количество результатов на странице (по умолчанию: 10)
Возвращает: ReviewDocsResponseDto
Положительные рецензии с пагинацией
Исключения:
KinopoiskDevException
: При ошибках API или валидацииKinopoiskResponseException
: При ошибках HTTP-запроса\JsonException
: При ошибках парсинга JSON-ответа
Пример:
PHP | |
---|---|
searchReviews()
¶
Описание: Поиск рецензий по различным критериям Основной метод для поиска рецензий с использованием расширенной фильтрации. Поддерживает фильтрацию по фильму, автору, типу рецензии, дате создания и другим критериям. Включает валидацию параметров и автоматическую пагинацию.
С версии: 1.0.0
API Endpoint: /v1.4/review
Параметры:
$filters
(ReviewSearchFilter|null): Объект фильтра для настройки критериев поиска$page
(int): Номер страницы результатов (по умолчанию: 1)$limit
(int): Количество результатов на странице (по умолчанию: 10, максимум: 250)
Возвращает: ReviewDocsResponseDto
Результаты поиска с пагинацией
Исключения:
KinopoiskDevException
: При ошибках валидации или превышении лимитовKinopoiskResponseException
: При ошибках HTTP-запроса\JsonException
: При ошибках парсинга JSON-ответа
Пример:
PHP | |
---|---|
getNegativeReviews()
¶
Описание: Получает отрицательные рецензии Удобный метод для получения только негативных рецензий. Автоматически применяет фильтр по типу "Негативный" и возвращает рецензии с отрицательной оценкой фильма.
С версии: 1.0.0
Параметры:
$page
(int): Номер страницы результатов (по умолчанию: 1)$limit
(int): Количество результатов на странице (по умолчанию: 10)
Возвращает: ReviewDocsResponseDto
Отрицательные рецензии с пагинацией
Исключения:
KinopoiskDevException
: При ошибках API или валидацииKinopoiskResponseException
: При ошибках HTTP-запроса\JsonException
: При ошибках парсинга JSON-ответа
Пример: