Кино-Театр API

Обзор

Ниже представлен задокументированный список методов получения данных сайта kino-teatr.ua.

Запросы должны отправляться по адресу: https://api.kino-teatr.ua/

Не все методы задокументированы, если Вам не хватает какой-либо информации либо удобного метода ее получения - обратитесь к администрации сайта. Документация будет обновляться по мере выхода новых версий системы.

Ключ API

Во всех вызовах методов должен быть указан ваш API ключ. Для получения ключа обратитесь к администрации сайта.

Выбор языка

Для получения содержимого ответов на желаемом языке необходимо указать в HTTP запросе заголовок Accept-Language. Если указанная локаль не поддерживается, или заголовок не указан - ответ будет представлен на украинском языке.

Пример для украинского языка

Запрос

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/get_ukrainian_content/http-request.adoc[]

Ответ

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/get_ukrainian_content/http-response.adoc[]

Пример для русского языка

Запрос

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/get_russian_content/http-request.adoc[]

Ответ

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/get_russian_content/http-response.adoc[]

Работа со списками объектов

Методы возвращают списки объектов в виде страниц.
При создании запроса можно указывать номер страницы и количество результатов на странице.
Во всех примерах в данной документации указывается размер страницы size=1 для экономии места.

Параметры запросов

page - номер страницы, где 0 - первая страница (по-умолчанию 0)
size - количество результатов на странице (по-умолчанию 20, максимальное значение 2000)

Пример ответа

"content" : [ {
    ...                 // результаты
  } ],
"numberOfElements" : 1  // количество результатов на данной странице
"number" : 0,           // номер текущей страницы (где 0 - первая страница)
"size" : 1,             // размер данной страницы
"totalPages" : 2,       // всего страниц
"totalElements" : 2,    // всего результатов по всем страницам
"first" : true,         // признак первой страницы
"last" : false          // признак последней страницы

Методы для работы с кинотеатрами

Языки

Список

Запрос

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/get_languages/http-request.adoc[]

Ответ

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/get_languages/http-response.adoc[]

Жанры

Список

Запрос

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/get_genres/http-request.adoc[]

Ответ

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/get_genres/http-response.adoc[]

Профессии

Список

Запрос

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/get_professions/http-request.adoc[]

Ответ

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/get_professions/http-response.adoc[]

Киностудии

Список

Запрос

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/get_studios/http-request.adoc[]

Ответ

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/get_studios/http-response.adoc[]

Страны

Список

Запрос

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/get_countries/http-request.adoc[]

Ответ

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/get_countries/http-response.adoc[]

По идентификатору

Запрос

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/get_country_by_id/http-request.adoc[]

Ответ

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/get_country_by_id/http-response.adoc[]

Города

Список

Запрос

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/get_cities/http-request.adoc[]

Ответ

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/get_cities/http-response.adoc[]

По идентификатору

Запрос

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/get_city_by_id/http-request.adoc[]

Ответ

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/get_city_by_id/http-response.adoc[]

Кинотеатры

Список

Запрос

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/get_cinemas/http-request.adoc[]

Ответ

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/get_cinemas/http-response.adoc[]

По идентификатору

Запрос

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/get_cinema_by_id/http-request.adoc[]

Ответ

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/get_cinema_by_id/http-response.adoc[]

Залы

Список

Запрос

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/get_halls/http-request.adoc[]

Ответ

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/get_halls/http-response.adoc[]

По идентификатору

Запрос

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/get_hall_by_id/http-request.adoc[]

Ответ

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/get_hall_by_id/http-response.adoc[]

Фильмы

Список

Запрос

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/get_films/http-request.adoc[]

Ответ

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/get_films/http-response.adoc[]

Премьеры

Запрос

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/get_film_premieres/http-request.adoc[]

Ответ

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/get_film_premieres/http-response.adoc[]

По идентификатору

Запрос

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/get_film_by_id/http-request.adoc[]

Ответ

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/get_film_by_id/http-response.adoc[]

Постеры

Запрос

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/get_film_posters/http-request.adoc[]

Ответ

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/get_film_posters/http-response.adoc[]

Кадры из фильма

Запрос

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/get_film_images/http-request.adoc[]

Ответ

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/get_film_images/http-response.adoc[]

Трейлеры

Запрос

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/get_film_trailers/http-request.adoc[]

Ответ

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/get_film_trailers/http-response.adoc[]

Персоны

Список

Запрос

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/get_persons/http-request.adoc[]

Ответ

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/get_persons/http-response.adoc[]

По идентификатору

Запрос

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/get_person_by_id/http-request.adoc[]

Ответ

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/get_person_by_id/http-response.adoc[]

По фильму

Запрос

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/get_film_persons/http-request.adoc[]

Ответ

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/get_film_persons/http-response.adoc[]

Список кадров из фильмов с участием персоны

Запрос

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/get_person_images/http-request.adoc[]

Ответ

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/get_person_images/http-response.adoc[]

Фотографии

Запрос

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/get_person_photos/http-request.adoc[]

Ответ

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/get_person_photos/http-response.adoc[]

Список трейлеров фильмов с участием персоны

Запрос

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/get_person_trailers/http-request.adoc[]

Ответ

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/get_person_trailers/http-response.adoc[]

Сеансы

Все фильмы в городе по дате

Запрос

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/get_shows_by_city_id_by_date/http-request.adoc[]

Параметры запроса

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/get_shows_by_city_id_by_date/request-parameters.adoc[]

Ответ

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/get_shows_by_city_id_by_date/http-response.adoc[]

Все фильмы в городе начиная с сегодня

Запрос

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/get_shows_by_city_id_by_date_from_now/http-request.adoc[]

Параметры запроса

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/get_shows_by_city_id_by_date_from_now/request-parameters.adoc[]

Ответ

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/get_shows_by_city_id_by_date_from_now/http-response.adoc[]

Все фильмы в кинотеатре по дате

Запрос

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/get_shows_by_cinema_id_by_date/http-request.adoc[]

Параметры запроса

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/get_shows_by_cinema_id_by_date/request-parameters.adoc[]

Ответ

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/get_shows_by_cinema_id_by_date/http-response.adoc[]

Все фильмы в кинотеатре начиная с сегодня

Запрос

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/get_shows_by_cinema_id_by_date_from_now/http-request.adoc[]

Параметры запроса

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/get_shows_by_cinema_id_by_date_from_now/request-parameters.adoc[]

Ответ

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/get_shows_by_cinema_id_by_date_from_now/http-response.adoc[]

Одного фильма в городе по дате

Запрос

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/get_shows_by_city_id_by_film_id_by_date/http-request.adoc[]

Параметры запроса

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/get_shows_by_city_id_by_film_id_by_date/request-parameters.adoc[]

Ответ

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/get_shows_by_city_id_by_film_id_by_date/http-response.adoc[]

Одного фильма в городе начиная с сегодня

Запрос

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/get_shows_by_city_id_by_film_id_by_date_from_now/http-request.adoc[]

Параметры запроса

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/get_shows_by_city_id_by_film_id_by_date_from_now/request-parameters.adoc[]

Ответ

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/get_shows_by_city_id_by_film_id_by_date_from_now/http-response.adoc[]

Одного фильма в кинотеатре по дате

Запрос

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/get_shows_by_cinema_id_by_film_id_by_date/http-request.adoc[]

Параметры запроса

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/get_shows_by_cinema_id_by_film_id_by_date/request-parameters.adoc[]

Ответ

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/get_shows_by_cinema_id_by_film_id_by_date/http-response.adoc[]

Одного фильма в кинотеатре начиная с сегодня

Запрос

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/get_shows_by_cinema_id_by_film_id_by_date_from_now/http-request.adoc[]

Параметры запроса

Ответ

Новости

Относящиеся к фильму

Запрос

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/get_news_by_film_id/http-request.adoc[]

Ответ

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/get_news_by_film_id/http-response.adoc[]

Изображения

Постер фильма по идентификатору

Запрос

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/get_film_poster_by_id/http-request.adoc[]

Главный постер фильма

Запрос

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/get_film_poster_first/http-request.adoc[]

Кадр из фильма по идентификатору

Запрос

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/get_film_image_by_id/http-request.adoc[]

Фотография персоны по идентификатору

Запрос

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/get_person_photo_by_id/http-request.adoc[]

Главная фотография персоны

Запрос

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/get_person_photo_first/http-request.adoc[]

Изображение трейлера

Запрос

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/get_trailer_photo/http-request.adoc[]

Поиск фильмов, персон

Запрос

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/search_by_query/http-request.adoc[]

Ответ

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/search_by_query/http-response.adoc[]

Работа с билетами

Схема зала

Запрос

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/get_showtime_schema/http-request.adoc[]

Ответ

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/get_showtime_schema/http-response.adoc[]

Описание

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/get_showtime_schema/response-fields.adoc[]

Типы схем ("schema_type")
Значение	Описание
basic	Обычная схема
sectors	Схема секторов
enterTicket	Схема без мест (действует входной билет)

Формы места ("place_shape")
Значение	Описание
rectangle	Прямоугольная
circle	Круглая

Местонахождение сцены ("scene_location")
Значение	Описание
top	Сверху

Создание предварительного заказа

Запрос

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/create_cinema_order/http-request.adoc[]

Ответ

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/create_cinema_order/http-response.adoc[]

Отмена предварительного заказа

Предварительные заказы желательно отменять, иначе места останутся занятыми на период до 15 минут

Запрос

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/cancel_cinema_order/http-request.adoc[]

Ответ

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/cancel_cinema_order/http-response.adoc[]

Подтверждение и переход к оплате предварительного заказа

Запрос

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/commit_cinema_order/http-request.adoc[]

Ответ

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/commit_cinema_order/http-response.adoc[]

Получение информации по заказу

Запрос

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/get_cinema_order/http-request.adoc[]

Ответ

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/get_cinema_order/http-response.adoc[]

Описание структуры заказа

Unresolved directive in index.adoc - include::/Users/Ievgen_Krapyva/dev/projects/kino-teatr.ua/kinoteatr-services/target/snippets/create_cinema_order/response-fields.adoc[]

Статусы заказа ("status")
Значение	Описание
PREVIEW	Предварительный заказ
WAITING_FOR_PAYMENT	Ожидание оплаты
SOLD	Оплачен
CANCELLED	Отменен
EXPIRED	Время на оплату заказа истекло
REFUNDED	Билеты возвращены

Типы заказа ("type")
Значение	Описание
CINEMA	Кино
THEATER	Театр