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

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