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