Сервисы
Документация по сервисы. Часть API wrapper для КиноПоиска.
Сервисы для работы с различными компонентами Kinopoisk API.
📚 Навигация: Главная → Сервисы
📋 Список сервисов
🎬 FilmService
Сервис для работы с фильмами, сериалами и связанным контентом.
Основные возможности:
- Получение информации о фильмах
- Поиск фильмов по ключевым словам
- Получение топ фильмов
- Работа со съемочной группой
- Получение отзывов и фактов
- Работа с медиа контентом
Связанные модели:
👥 PersonService
Сервис для работы с персонами (актеры, режиссеры, сценаристы).
Основные возможности:
- Получение информации о персонах
- Поиск персон по имени
- Получение фильмографии
- Работа с биографией и фактами
Связанные модели:
🎥 MediaService
Сервис для работы с медиа контентом (изображения, видео).
Основные возможности:
- Получение изображений фильмов
- Работа с видео контентом
- Фильтрация по типам медиа
Связанные модели:
👤 UserService
Сервис для работы с пользовательскими данными.
Основные возможности:
- Получение информации об API ключе
- Работа с квотами запросов
- Получение пользовательских голосов
Связанные модели:
🔗 Общие компоненты
Все сервисы используют общие компоненты:
Исключения
- ApiException - Базовое исключение API
- InvalidApiKeyException - Неверный API ключ
- RateLimitException - Превышение лимита запросов
- ResourceNotFoundException - Ресурс не найден
- KpValidationException - Ошибка валидации
Ответы
- DefaultResponse - Базовый ответ
- PaginatedResponse - Пагинированный ответ
- KeywordSearchResponse - Ответ поиска
🚀 Быстрый старт
<?php
require_once 'vendor/autoload.php';
use NotKinopoisk\Client;
// Создание клиента
$client = new Client('your-api-key');
// Работа с фильмами
$film = $client->films->getById(301);
$searchResults = $client->films->searchByKeyword('матрица');
// Работа с персонами
$person = $client->persons->getById(123);
$persons = $client->persons->searchByName('Том Круз');
// Работа с медиа
$images = $client->media->getImages(301);
$videos = $client->media->getVideos(301);
// Работа с пользователем
$apiInfo = $client->user->getApiKeyInfo();📖 Примеры использования
Получение полной информации о фильме
$filmId = 301;
// Основная информация
$film = $client->films->getById($filmId);
// Съемочная группа
$staff = $client->films->getStaff($filmId);
// Отзывы
$reviews = $client->films->getReviews($filmId);
// Факты
$facts = $client->films->getFacts($filmId);
// Изображения
$posters = $client->media->getImages($filmId, ImageType::POSTER);
$screenshots = $client->media->getImages($filmId, ImageType::SCREENSHOT);
// Видео
$videos = $client->media->getVideos($filmId);Поиск и анализ
// Поиск фильмов
$searchResults = $client->films->searchByKeyword('драма');
// Получение топ фильмов
$topFilms = $client->films->getTop();
// Поиск персон
$persons = $client->persons->searchByName('Кристофер Нолан');
// Получение фильмографии
$films = $client->persons->getFilms(123);🔧 Обработка ошибок
try {
$film = $client->films->getById(999999);
} catch (ResourceNotFoundException $e) {
echo "Фильм не найден: {$e->getMessage()}\n";
} catch (RateLimitException $e) {
echo "Превышен лимит запросов\n";
// Ждем и повторяем
sleep(1);
} catch (InvalidApiKeyException $e) {
echo "Неверный API ключ\n";
} catch (ApiException $e) {
echo "Ошибка API: {$e->getMessage()}\n";
}📊 Статистика использования
FilmService
- Методы: 15+
- Модели: 10+
- Перечисления: 8+
PersonService
- Методы: 8+
- Модели: 3+
- Перечисления: 2+
MediaService
- Методы: 6+
- Модели: 2+
- Перечисления: 2+
UserService
- Методы: 4+
- Модели: 3+
- Перечисления: 1+
📚 Навигация: Главная → Сервисы