KeywordDocsResponseDto¶

Описание: DTO для ответа API с ключевыми словами Этот класс представляет структурированный ответ от API Kinopoisk.dev при запросе списка ключевых слов с поддержкой пагинации.

С версии: 1.0.0

Версия: 1.0.0

__construct()¶

Описание: Конструктор DTO ответа с ключевыми словами

Параметры:

• $docs (Keyword[]): Массив объектов ключевых слов
• $total (int): Общее количество ключевых слов, соответствующих запросу
• $limit (int): Максимальное количество ключевых слов на странице
• $page (int): Номер текущей страницы
• $pages (int): Общее количество страниц

getKeywordTitles()¶

Описание: Получает все названия ключевых слов

Возвращает: string[] Массив названий ключевых слов

getPopularKeywords()¶

Описание: Фильтрует ключевые слова по популярности

Параметры:

• $threshold (int): Минимальное количество связанных фильмов

Возвращает: Keyword[] Массив популярных ключевых слов

searchByTitle()¶

Описание: Ищет ключевые слова, содержащие указанный текст

Параметры:

• $searchText (string): Текст для поиска в названиях

Возвращает: Keyword[] Массив найденных ключевых слов

groupByPopularity()¶

Описание: Группирует ключевые слова по количеству связанных фильмов

Возвращает: array<string, Keyword[]> Массив групп ключевых слов

getKeywordsForMovie()¶

Описание: Получает ключевые слова, связанные с указанным фильмом

Параметры:

• $movieId (int): ID фильма

Возвращает: Keyword[] Массив ключевых слов, связанных с фильмом

getStatistics()¶

Описание: Получает статистику по ключевым словам

Возвращает: array<string, mixed> Статистика

getRecentlyCreated()¶

Описание: Получает недавно созданные ключевые слова

Параметры:

• $days (int): Количество дней для считания "недавними"

Возвращает: Keyword[] Массив недавно созданных ключевых слов