kuapir

Kuapir - the Ruby gem for the Kinopoisk Unofficial API

Kinopoisk Unofficial API предеставляет доступ к данным сайта https://www.kinopoisk.ru. Для доступа вы должны получить токен, который будет доступен после регистрации на https://kinopoiskapiunofficial.tech Ограничения: лимитов на общее кол-во запросов нет. Но есть на кол-во запросов в секунду. Каждый пользователь имеет ограничение в 20 req/sec. Некоторые эндпоинты имеют свои собственные ограничения, они указаны в описании для статуса 429.

This SDK is automatically generated by the OpenAPI Generator project:

  • API version: 2.0.1
  • Package version: 1.0.0
  • Build package: org.openapitools.codegen.languages.RubyClientCodegen

Installation

Build a gem

To build the Ruby code into a gem:

gem build kuapir.gemspec

Then either install the gem locally:

gem install ./kuapir-1.0.0.gem

(for development, run gem install --dev ./kuapir-1.0.0.gem to install the development dependencies)

or publish the gem to a gem hosting service, e.g. RubyGems.

Finally add this to the Gemfile:

gem 'kuapir', '~> 1.0.0'

Install from Git

If the Ruby gem is hosted at a git repository: https://github.com/GIT_USER_ID/GIT_REPO_ID, then add the following in the Gemfile:

gem 'kuapir', :git => 'https://github.com/GIT_USER_ID/GIT_REPO_ID.git'

Include the Ruby code directly

Include the Ruby code directly using -I as follows:

ruby -Ilib script.rb

Getting Started

Please follow the installation procedure and then run the following code:

# Load the gem
require 'kuapir'

# Setup authorization
Kuapir.configure do |config|
  # Configure API key authorization: ApiKeyAuth
  config.api_key['ApiKeyAuth'] = 'YOUR API KEY'
  # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
  # config.api_key_prefix['ApiKeyAuth'] = 'Bearer'

  # Uncomment the following line to set a proxy for requests (defaults to nil)
  # config.proxy = 'http://my_proxy.com:1111'
end

api_instance = Kuapir::FilmsApi.new
id = 56 # Integer | kinopoisk film id

begin
  #получить сиквелы и приквелы для фильма по kinopoisk film id
  result = api_instance.api_v21_films_id_sequels_and_prequels_get(id)
  p result
rescue Kuapir::ApiError => e
  puts "Exception when calling FilmsApi->api_v21_films_id_sequels_and_prequels_get: #{e}"
end

Documentation for API Endpoints

All URIs are relative to https://kinopoiskapiunofficial.tech

Class Method HTTP request Description
Kuapir::FilmsApi api_v21_films_id_sequels_and_prequels_get GET /api/v2.1/films/id/sequels_and_prequels получить сиквелы и приквелы для фильма по kinopoisk film id
Kuapir::FilmsApi api_v21_films_releases_get GET /api/v2.1/films/releases получить список цифровых релизов
Kuapir::FilmsApi api_v21_films_search_by_keyword_get GET /api/v2.1/films/search-by-keyword получить список фильмов по ключевым словам
Kuapir::FilmsApi api_v22_films_filters_get GET /api/v2.2/films/filters получить id стран и жанров для использования в /api/v2.2/films
Kuapir::FilmsApi api_v22_films_get GET /api/v2.2/films получить список фильмов по различным фильтрам
Kuapir::FilmsApi api_v22_films_id_box_office_get GET /api/v2.2/films/id/box_office получить данные о бюджете и сборах фильма по kinopoisk film id
Kuapir::FilmsApi api_v22_films_id_distributions_get GET /api/v2.2/films/id/distributions получить данные о прокате фильма по kinopoisk film id
Kuapir::FilmsApi api_v22_films_id_facts_get GET /api/v2.2/films/id/facts получить данные о фактах и ошибках в фильме по kinopoisk film id
Kuapir::FilmsApi api_v22_films_id_get GET /api/v2.2/films/id получить данные о фильме по kinopoisk id
Kuapir::FilmsApi api_v22_films_id_images_get GET /api/v2.2/films/id/images получить изображения(кадры, постеры, фан-арты, обои и т.д.) связанные с фильмом по kinopoisk film id
Kuapir::FilmsApi api_v22_films_id_seasons_get GET /api/v2.2/films/id/seasons получить данные о сезонах для сериала по kinopoisk film id
Kuapir::FilmsApi api_v22_films_id_similars_get GET /api/v2.2/films/id/similars получить список похожих фильмов по kinopoisk film id
Kuapir::FilmsApi api_v22_films_id_videos_get GET /api/v2.2/films/id/videos получить трейлеры,тизеры,видео для фильма по kinopoisk film id
Kuapir::FilmsApi api_v22_films_premieres_get GET /api/v2.2/films/premieres получить список кинопремьер
Kuapir::FilmsApi api_v22_films_top_get GET /api/v2.2/films/top получить список фильмов из различных топов или коллекций. Например https://www.kinopoisk.ru/top/lists/58/
Kuapir::PersonsApi api_v1_persons_get GET /api/v1/persons поиск актеров, режиссеров и т.д. по имени
Kuapir::ReviewsApi api_v1_reviews_details_get GET /api/v1/reviews/details получить полную рецензию по kinopoisk review id
Kuapir::ReviewsApi api_v1_reviews_get GET /api/v1/reviews получить рецензии зрителей
Kuapir::StaffApi api_v1_staff_get GET /api/v1/staff получить данные об актерах, режисерах и т.д. по kinopoisk film id
Kuapir::StaffApi api_v1_staff_id_get GET /api/v1/staff/id получить данные о конкретном человеке по kinopoisk person id

Documentation for Models

Documentation for Authorization

ApiKeyAuth

  • Type: API key
  • API key parameter name: X-API-KEY
  • Location: HTTP header