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

Сервисы

Сервисы для работы с различными компонентами Kinopoisk API.

📚 Навигация: Главная → Сервисы

📋 Список сервисов

🎬 FilmService

Сервис для работы с фильмами, сериалами и связанным контентом.

Основные возможности:

  • Получение информации о фильмах
  • Поиск фильмов по ключевым словам
  • Получение топ фильмов
  • Работа со съемочной группой
  • Получение отзывов и фактов
  • Работа с медиа контентом

Связанные модели:

👥 PersonService

Сервис для работы с персонами (актеры, режиссеры, сценаристы).

Основные возможности:

  • Получение информации о персонах
  • Поиск персон по имени
  • Получение фильмографии
  • Работа с биографией и фактами

Связанные модели:

🎥 MediaService

Сервис для работы с медиа контентом (изображения, видео).

Основные возможности:

  • Получение изображений фильмов
  • Работа с видео контентом
  • Фильтрация по типам медиа

Связанные модели:

👤 UserService

Сервис для работы с пользовательскими данными.

Основные возможности:

  • Получение информации об API ключе
  • Работа с квотами запросов
  • Получение пользовательских голосов

Связанные модели:

🔗 Общие компоненты

Все сервисы используют общие компоненты:

Исключения

Ответы

🚀 Быстрый старт

PHP
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
<?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();

📖 Примеры использования

Получение полной информации о фильме

PHP
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
$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);

Поиск и анализ

PHP
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
// Поиск фильмов
$searchResults = $client->films->searchByKeyword('драма');

// Получение топ фильмов
$topFilms = $client->films->getTop();

// Поиск персон
$persons = $client->persons->searchByName('Кристофер Нолан');

// Получение фильмографии
$films = $client->persons->getFilms(123);

🔧 Обработка ошибок

PHP
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
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+

📚 Навигация: Главная → Сервисы