Интеграция билетных терминалов

Материал из CinemaPark Integration

Перейти к: навигация, поиск

Содержание

Общие принципы работы

Программное обеспечение терминала осуществляет обращения к API интеграции посредством HTTP-запросов к серверу интеграции. При установке терминала на территории мультиплекса адрес сервера – ssi (к которому автоматически добавляется DNS-суффикс подключения). В тестовом режиме обращение к серверу интеграции может осуществляться по адресу ssi.www.cinemapark.ru.

Метод – GET (для последующего облегчения отладки с использованием логов веб-сервера). Аргументы запроса передаются стандартно через ? (пример – ?multiplex_id=22&repertoir_id=154234). Кодировка аргументов и тела ответа – UTF-8. Ответы сервер интеграции выдаёт в формате XML.

Алгоритмы работы терминала

Статические справочники

Форматы фильмов – formats.xml

Общие параметры вызовов

Стандартная аутентификация терминала.

Список вызовов API

  • Список текущих фильмов – films.
  • Получение расписания мультиплекса – repertoir.
  • Получение информации о залах мультиплекса – halls.
  • Получение информации по карте лояльности – loyalty_info.
  • Стандартное начало работы в сеансе – start_regular.
  • Начало работы с заказом (бронью или интернет-продажей) – start_reserved.
  • Получение информации о текущей сессии – session_state.
  • Получение геометрической схемы зала – seats_layout.
  • Получение информации о статусе мест в зале – seat_states.
  • Действие с местом (выбор места или отмена выбора) – seat_action.
  • Сброс состояния, отмена выбора мест – cancel_session.
  • Фиксация факта оплаты – register_payment.
  • Подтверждение готовности к выдаче билетов – confirm_ticket_dispensing.
  • Получение данных для печати билетных бланков – ticket_forms.
  • Получение данных для печати чека (в случае оплаты по банковской карте) – receipt_form.
  • Фиксация окончания печати и выдачи билетов – ticket_dispensing_completed.
  • Уведомление о неудаче печати и выдачи билетов – ticket_dispensing_failed.


  • Проверка логина-пароля на возможность входа в административный интерфейс – authorize_user.

todo:

Применение карты лояльности – apply_loyalty_card.

Личные инструменты