Обзор
Ниже представлен задокументированный список методов получения данных сайта 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_shows_by_cinema_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_cinema_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_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[]
Значение | Описание |
---|---|
basic |
Обычная схема |
sectors |
Схема секторов |
enterTicket |
Схема без мест (действует входной билет) |
Значение | Описание |
---|---|
rectangle |
Прямоугольная |
circle |
Круглая |
Значение | Описание |
---|---|
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[]
Значение | Описание |
---|---|
PREVIEW |
Предварительный заказ |
WAITING_FOR_PAYMENT |
Ожидание оплаты |
SOLD |
Оплачен |
CANCELLED |
Отменен |
EXPIRED |
Время на оплату заказа истекло |
REFUNDED |
Билеты возвращены |
Значение | Описание |
---|---|
CINEMA |
Кино |
THEATER |
Театр |