StudioRequests¶
Описание: Класс для API-запросов, связанных со студиями Этот класс предоставляет методы для всех конечных точек студий API Kinopoisk.dev. Позволяет получать информацию о кинокомпаниях, студиях дубляжа, производителях и других организациях, участвующих в создании фильмов.
С версии: 1.0.0
Версия: 1.0.0
См. также:
\KinopoiskDev\Models\Studio: Для структуры данных студии\KinopoiskDev\Filter\StudioSearchFilter: Для фильтрации запросов
getProductionStudios()¶
Описание: Получает производственные студии Удобный метод для получения студий типа "Производство".
Параметры:
$page(int): Номер страницы результатов$limit(int): Количество результатов на странице
Возвращает: StudioDocsResponseDto Производственные студии
Исключения:
KinopoiskDevException: При ошибках API\JsonException|\KinopoiskDev\Exceptions\KinopoiskResponseException: При ошибках парсинга JSON
getStudiosByType()¶
Описание: Получает студии по типу Удобный метод для получения студий определенного типа: "Производство", "Спецэффекты", "Прокат", "Студия дубляжа"
Параметры:
$type(string): Тип студии$page(int): Номер страницы результатов$limit(int): Количество результатов на странице
Возвращает: StudioDocsResponseDto Студии указанного типа
Исключения:
KinopoiskDevException: При ошибках API\JsonException|\KinopoiskDev\Exceptions\KinopoiskResponseException: При ошибках парсинга JSON
searchStudios()¶
Описание: Ищет студии по различным критериям Основной метод для поиска студий с поддержкой сложных фильтров. Позволяет искать по названию, типу студии, подтипу и связанным фильмам.
API Endpoint: /v1.4/studio
Параметры:
$filters(StudioSearchFilter|null): Объект фильтра для поиска студий$page(int): Номер страницы результатов (по умолчанию: 1)$limit(int): Количество результатов на странице (по умолчанию: 10, максимум: 250)
Возвращает: StudioDocsResponseDto Результаты поиска с пагинацией
Исключения:
KinopoiskDevException: При ошибках API
getDubbingStudios()¶
Описание: Получает студии дубляжа Удобный метод для получения студий типа "Студия дубляжа".
Параметры:
$page(int): Номер страницы результатов$limit(int): Количество результатов на странице
Возвращает: StudioDocsResponseDto Студии дубляжа
Исключения:
KinopoiskDevException: При ошибках API\JsonException|\KinopoiskDev\Exceptions\KinopoiskResponseException: При ошибках парсинга JSON
getStudiosByTitle()¶
Описание: Получает студии по названию Выполняет поиск студий по точному или частичному совпадению названия.
Параметры:
$title(string): Название студии для поиска$page(int): Номер страницы результатов$limit(int): Количество результатов на странице
Возвращает: StudioDocsResponseDto Студии с подходящими названиями
Исключения:
KinopoiskDevException: При ошибках API\JsonException|\KinopoiskDev\Exceptions\KinopoiskResponseException: При ошибках парсинга JSON
getStudioById()¶
Описание: Получает студию по её уникальному идентификатору
Параметры:
$studioId(int): Уникальный идентификатор студии
Возвращает: Studio Объект студии
Исключения:
KinopoiskDevException: При ошибках API
getRandomStudio()¶
Описание: Получает случайную студию
Параметры:
$filters(StudioSearchFilter|null): Фильтры для поиска
Возвращает: Studio Случайная студия
searchStudiosByName()¶
Описание: Выполняет поиск студий по названию (алиас для getStudiosByTitle)
Параметры:
$name(string): Название для поиска$page(int): Номер страницы$limit(int): Количество результатов
Возвращает: StudioDocsResponseDto Результаты поиска
getStudiosByCountry()¶
Описание: Получает студии по стране
Параметры:
$country(string): Страна$page(int): Номер страницы$limit(int): Количество результатов
Возвращает: StudioDocsResponseDto Результаты поиска
getStudiosByYear()¶
Описание: Получает студии по году основания
Параметры:
$year(int): Год основания$page(int): Номер страницы$limit(int): Количество результатов
Возвращает: StudioDocsResponseDto Результаты поиска
getStudiosByYearRange()¶
Описание: Получает студии по диапазону годов основания
Параметры:
$fromYear(int): Начальный год$toYear(int): Конечный год$page(int): Номер страницы$limit(int): Количество результатов
Возвращает: StudioDocsResponseDto Результаты поиска
getStudiosForMovie()¶
Описание: Получает студии, связанные с определенным фильмом Находит все студии, которые принимали участие в создании указанного фильма.
Параметры:
$movieId(int): Идентификатор фильма$page(int): Номер страницы результатов$limit(int): Количество результатов на странице
Возвращает: StudioDocsResponseDto Студии, связанные с фильмом
Исключения:
KinopoiskDevException: При ошибках API\JsonException|\KinopoiskDev\Exceptions\KinopoiskResponseException: При ошибках парсинга JSON