PHPackages                             axp-dev/cinemapark-api - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. axp-dev/cinemapark-api

ActiveLibrary[API Development](/categories/api)

axp-dev/cinemapark-api
======================

PHP library for integration with information systems Cinema Park

1.4.0(8y ago)2242MITPHPPHP >=5.6.4

Since Aug 2Pushed 8y agoCompare

[ Source](https://github.com/axp-dev/cinemapark-api)[ Packagist](https://packagist.org/packages/axp-dev/cinemapark-api)[ Docs](https://github.com/axp-dev/cinemapark-api)[ RSS](/packages/axp-dev-cinemapark-api/feed)WikiDiscussions master Synced 2mo ago

READMEChangelog (3)Dependencies (1)Versions (4)Used By (0)

Cinema Park API
===============

[](#cinema-park-api)

PHP библиотека для интеграции с информационными системами Синема Парк.

[![Latest Stable Version](https://camo.githubusercontent.com/23300bb7c558395c0dda2ffb4fc1bbc1423dc871f15cdfb4af718f3eb2bd1140/68747470733a2f2f706f7365722e707567782e6f72672f6178702d6465762f63696e656d617061726b2d6170692f762f737461626c65)](https://packagist.org/packages/axp-dev/cinemapark-api)[![Latest Unstable Version](https://camo.githubusercontent.com/8a3586df90103e569e37a24676c29e4d2362c3c6df189d24f37f8a5adfe5e31b/68747470733a2f2f706f7365722e707567782e6f72672f6178702d6465762f63696e656d617061726b2d6170692f762f756e737461626c65)](https://packagist.org/packages/axp-dev/cinemapark-api)[![License](https://camo.githubusercontent.com/1f6366b9f70ec6a1ce76ed75d127f2b853b0e052b8a8ad9d61f5874a30ed3442/68747470733a2f2f706f7365722e707567782e6f72672f6178702d6465762f63696e656d617061726b2d6170692f6c6963656e7365)](https://packagist.org/packages/axp-dev/cinemapark-api)

Оглавление
----------

[](#оглавление)

1. [Старт](#%D0%A1%D1%82%D0%B0%D1%80%D1%82)
    - [Composer](#%D0%A3%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BA%D0%B0-%D1%87%D0%B5%D1%80%D0%B5%D0%B7-composer)
    - [Инициализация](#%D0%98%D0%BD%D0%B8%D1%86%D0%B8%D0%B0%D0%BB%D0%B8%D0%B7%D0%B0%D1%86%D0%B8%D1%8F)
2. [Использование](#%D0%98%D1%81%D0%BF%D0%BE%D0%BB%D1%8C%D0%B7%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5)
    - Получение информации по кинотеатрам, фильмам и сеансам
        - [Получение списка мультиплексов и городов](#%D0%9F%D0%BE%D0%BB%D1%83%D1%87%D0%B5%D0%BD%D0%B8%D0%B5-%D1%81%D0%BF%D0%B8%D1%81%D0%BA%D0%B0-%D0%BC%D1%83%D0%BB%D1%8C%D1%82%D0%B8%D0%BF%D0%BB%D0%B5%D0%BA%D1%81%D0%BE%D0%B2-%D0%B8-%D0%B3%D0%BE%D1%80%D0%BE%D0%B4%D0%BE%D0%B2)
        - [Получение списка фильмов](#%D0%9F%D0%BE%D0%BB%D1%83%D1%87%D0%B5%D0%BD%D0%B8%D0%B5-%D1%81%D0%BF%D0%B8%D1%81%D0%BA%D0%B0-%D1%84%D0%B8%D0%BB%D1%8C%D0%BC%D0%BE%D0%B2)
        - [Привязка фильмов к мультиплексам](###%D0%9F%D1%80%D0%B8%D0%B2%D1%8F%D0%B7%D0%BA%D0%B0-%D1%84%D0%B8%D0%BB%D1%8C%D0%BC%D0%BE%D0%B2-%D0%BA-%D0%BC%D1%83%D0%BB%D1%8C%D1%82%D0%B8%D0%BF%D0%BB%D0%B5%D0%BA%D1%81%D0%B0%D0%BC)
        - [Получение расписания фильма](#%D0%9F%D0%BE%D0%BB%D1%83%D1%87%D0%B5%D0%BD%D0%B8%D0%B5-%D1%80%D0%B0%D1%81%D0%BF%D0%B8%D1%81%D0%B0%D0%BD%D0%B8%D1%8F-%D1%84%D0%B8%D0%BB%D1%8C%D0%BC%D0%B0)
        - [Получение расписания мультиплекса](#%D0%9F%D0%BE%D0%BB%D1%83%D1%87%D0%B5%D0%BD%D0%B8%D0%B5-%D1%80%D0%B0%D1%81%D0%BF%D0%B8%D1%81%D0%B0%D0%BD%D0%B8%D1%8F-%D0%BC%D1%83%D0%BB%D1%8C%D1%82%D0%B8%D0%BF%D0%BB%D0%B5%D0%BA%D1%81%D0%B0)
        - [Получение дополнительной информации по фильму](#%D0%9F%D0%BE%D0%BB%D1%83%D1%87%D0%B5%D0%BD%D0%B8%D0%B5-%D0%B4%D0%BE%D0%BF%D0%BE%D0%BB%D0%BD%D0%B8%D1%82%D0%B5%D0%BB%D1%8C%D0%BD%D0%BE%D0%B9-%D0%B8%D0%BD%D1%84%D0%BE%D1%80%D0%BC%D0%B0%D1%86%D0%B8%D0%B8-%D0%BF%D0%BE-%D1%84%D0%B8%D0%BB%D1%8C%D0%BC%D1%83)
        - [Получение списка залов по всем мультиплексам](#%D0%9F%D0%BE%D0%BB%D1%83%D1%87%D0%B5%D0%BD%D0%B8%D0%B5-%D1%81%D0%BF%D0%B8%D1%81%D0%BA%D0%B0-%D0%B7%D0%B0%D0%BB%D0%BE%D0%B2-%D0%BF%D0%BE-%D0%B2%D1%81%D0%B5%D0%BC-%D0%BC%D1%83%D0%BB%D1%8C%D1%82%D0%B8%D0%BF%D0%BB%D0%B5%D0%BA%D1%81%D0%B0%D0%BC)
        - [Получение списка форматов показа фильмов](#%D0%9F%D0%BE%D0%BB%D1%83%D1%87%D0%B5%D0%BD%D0%B8%D0%B5-%D1%81%D0%BF%D0%B8%D1%81%D0%BA%D0%B0-%D1%84%D0%BE%D1%80%D0%BC%D0%B0%D1%82%D0%BE%D0%B2-%D0%BF%D0%BE%D0%BA%D0%B0%D0%B7%D0%B0-%D1%84%D0%B8%D0%BB%D1%8C%D0%BC%D0%BE%D0%B2)
        - [Комплексная выгрузка текущего расписания мультиплекса](#%D0%9A%D0%BE%D0%BC%D0%BF%D0%BB%D0%B5%D0%BA%D1%81%D0%BD%D0%B0%D1%8F-%D0%B2%D1%8B%D0%B3%D1%80%D1%83%D0%B7%D0%BA%D0%B0-%D1%82%D0%B5%D0%BA%D1%83%D1%89%D0%B5%D0%B3%D0%BE-%D1%80%D0%B0%D1%81%D0%BF%D0%B8%D1%81%D0%B0%D0%BD%D0%B8%D1%8F-%D0%BC%D1%83%D0%BB%D1%8C%D1%82%D0%B8%D0%BF%D0%BB%D0%B5%D0%BA%D1%81%D0%B0)
    - Организация интернет-бронирования и продаж
        - [Проверка возможности начать сессию выбора мест для бронирования или покупки мест](#%D0%9F%D1%80%D0%BE%D0%B2%D0%B5%D1%80%D0%BA%D0%B0-%D0%B2%D0%BE%D0%B7%D0%BC%D0%BE%D0%B6%D0%BD%D0%BE%D1%81%D1%82%D0%B8-%D0%BD%D0%B0%D1%87%D0%B0%D1%82%D1%8C-%D1%81%D0%B5%D1%81%D1%81%D0%B8%D1%8E-%D0%B2%D1%8B%D0%B1%D0%BE%D1%80%D0%B0-%D0%BC%D0%B5%D1%81%D1%82-%D0%B4%D0%BB%D1%8F-%D0%B1%D1%80%D0%BE%D0%BD%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D1%8F-%D0%B8%D0%BB%D0%B8-%D0%BF%D0%BE%D0%BA%D1%83%D0%BF%D0%BA%D0%B8-%D0%BC%D0%B5%D1%81%D1%82)
        - [Инициализация сессии выбора мест для бронирования или покупки](#%D0%98%D0%BD%D0%B8%D1%86%D0%B8%D0%B0%D0%BB%D0%B8%D0%B7%D0%B0%D1%86%D0%B8%D1%8F-%D1%81%D0%B5%D1%81%D1%81%D0%B8%D0%B8-%D0%B2%D1%8B%D0%B1%D0%BE%D1%80%D0%B0-%D0%BC%D0%B5%D1%81%D1%82-%D0%B4%D0%BB%D1%8F-%D0%B1%D1%80%D0%BE%D0%BD%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D1%8F-%D0%B8%D0%BB%D0%B8-%D0%BF%D0%BE%D0%BA%D1%83%D0%BF%D0%BA%D0%B8)
        - [Получение геометрической схемы зала](#%D0%9F%D0%BE%D0%BB%D1%83%D1%87%D0%B5%D0%BD%D0%B8%D0%B5-%D0%B3%D0%B5%D0%BE%D0%BC%D0%B5%D1%82%D1%80%D0%B8%D1%87%D0%B5%D1%81%D0%BA%D0%BE%D0%B9-%D1%81%D1%85%D0%B5%D0%BC%D1%8B-%D0%B7%D0%B0%D0%BB%D0%B0)
        - [Получение состояния мест](#%D0%9F%D0%BE%D0%BB%D1%83%D1%87%D0%B5%D0%BD%D0%B8%D0%B5-%D1%81%D0%BE%D1%81%D1%82%D0%BE%D1%8F%D0%BD%D0%B8%D1%8F-%D0%BC%D0%B5%D1%81%D1%82)
        - [Действие с местом в сессии выбора мест](#%D0%94%D0%B5%D0%B9%D1%81%D1%82%D0%B2%D0%B8%D0%B5-%D1%81-%D0%BC%D0%B5%D1%81%D1%82%D0%BE%D0%BC-%D0%B2-%D1%81%D0%B5%D1%81%D1%81%D0%B8%D0%B8-%D0%B2%D1%8B%D0%B1%D0%BE%D1%80%D0%B0-%D0%BC%D0%B5%D1%81%D1%82)
        - [Отмена или закрытие сессии выбора мест](#%D0%9E%D1%82%D0%BC%D0%B5%D0%BD%D0%B0-%D0%B8%D0%BB%D0%B8-%D0%B7%D0%B0%D0%BA%D1%80%D1%8B%D1%82%D0%B8%D0%B5-%D1%81%D0%B5%D1%81%D1%81%D0%B8%D0%B8-%D0%B2%D1%8B%D0%B1%D0%BE%D1%80%D0%B0-%D0%BC%D0%B5%D1%81%D1%82)
        - [Закрытие сессии выбора мест](#%D0%97%D0%B0%D0%BA%D1%80%D1%8B%D1%82%D0%B8%D0%B5-%D1%81%D0%B5%D1%81%D1%81%D0%B8%D0%B8-%D0%B2%D1%8B%D0%B1%D0%BE%D1%80%D0%B0-%D0%BC%D0%B5%D1%81%D1%82)
        - [Открытие сессии выбора мест после фиксации](#%D0%9E%D1%82%D0%BA%D1%80%D1%8B%D1%82%D0%B8%D0%B5-%D1%81%D0%B5%D1%81%D1%81%D0%B8%D0%B8-%D0%B2%D1%8B%D0%B1%D0%BE%D1%80%D0%B0-%D0%BC%D0%B5%D1%81%D1%82-%D0%BF%D0%BE%D1%81%D0%BB%D0%B5-%D1%84%D0%B8%D0%BA%D1%81%D0%B0%D1%86%D0%B8%D0%B8)
        - [Инициализация сессии оплаты](#%D0%98%D0%BD%D0%B8%D1%86%D0%B8%D0%B0%D0%BB%D0%B8%D0%B7%D0%B0%D1%86%D0%B8%D1%8F-%D1%81%D0%B5%D1%81%D1%81%D0%B8%D0%B8-%D0%BE%D0%BF%D0%BB%D0%B0%D1%82%D1%8B)
        - [Фиксация факта оплаты заказа](#%D0%A4%D0%B8%D0%BA%D1%81%D0%B0%D1%86%D0%B8%D1%8F-%D1%84%D0%B0%D0%BA%D1%82%D0%B0-%D0%BE%D0%BF%D0%BB%D0%B0%D1%82%D1%8B-%D0%B7%D0%B0%D0%BA%D0%B0%D0%B7%D0%B0)
        - [Фиксация факта неудачи оплаты заказа](#%D0%A4%D0%B8%D0%BA%D1%81%D0%B0%D1%86%D0%B8%D1%8F-%D1%84%D0%B0%D0%BA%D1%82%D0%B0-%D0%BD%D0%B5%D1%83%D0%B4%D0%B0%D1%87%D0%B8-%D0%BE%D0%BF%D0%BB%D0%B0%D1%82%D1%8B-%D0%B7%D0%B0%D0%BA%D0%B0%D0%B7%D0%B0)
3. [Вспомогательная информация](#%D0%92%D1%81%D0%BF%D0%BE%D0%BC%D0%BE%D0%B3%D0%B0%D1%82%D0%B5%D0%BB%D1%8C%D0%BD%D0%B0%D1%8F-%D0%B8%D0%BD%D1%84%D0%BE%D1%80%D0%BC%D0%B0%D1%86%D0%B8%D1%8F)
    - [Код возрастных ограничений](#%D0%9A%D0%BE%D0%B4-%D0%B2%D0%BE%D0%B7%D1%80%D0%B0%D1%81%D1%82%D0%BD%D1%8B%D1%85-%D0%BE%D0%B3%D1%80%D0%B0%D0%BD%D0%B8%D1%87%D0%B5%D0%BD%D0%B8%D0%B9)
    - [Состояние сеанса](#%D0%A1%D0%BE%D1%81%D1%82%D0%BE%D1%8F%D0%BD%D0%B8%D0%B5-%D1%81%D0%B5%D0%B0%D0%BD%D1%81%D0%B0)
    - [Режим открытия сессии выбора мест](#%D0%A0%D0%B5%D0%B6%D0%B8%D0%BC-%D0%BE%D1%82%D0%BA%D1%80%D1%8B%D1%82%D0%B8%D1%8F-%D1%81%D0%B5%D1%81%D1%81%D0%B8%D0%B8-%D0%B2%D1%8B%D0%B1%D0%BE%D1%80%D0%B0-%D0%BC%D0%B5%D1%81%D1%82)
    - [Код доступности инициализации сессии](#%D0%9A%D0%BE%D0%B4-%D0%B4%D0%BE%D1%81%D1%82%D1%83%D0%BF%D0%BD%D0%BE%D1%81%D1%82%D0%B8-%D0%B8%D0%BD%D0%B8%D1%86%D0%B8%D0%B0%D0%BB%D0%B8%D0%B7%D0%B0%D1%86%D0%B8%D0%B8-%D1%81%D0%B5%D1%81%D1%81%D0%B8%D0%B8)
    - [Возможность работы с сеансом](#%D0%92%D0%BE%D0%B7%D0%BC%D0%BE%D0%B6%D0%BD%D0%BE%D1%81%D1%82%D1%8C-%D1%80%D0%B0%D0%B1%D0%BE%D1%82%D1%8B-%D1%81-%D1%81%D0%B5%D0%B0%D0%BD%D1%81%D0%BE%D0%BC)
    - [Статус сессии выбора мест](#%D0%A1%D1%82%D0%B0%D1%82%D1%83%D1%81-%D1%81%D0%B5%D1%81%D1%81%D0%B8%D0%B8-%D0%B2%D1%8B%D0%B1%D0%BE%D1%80%D0%B0-%D0%BC%D0%B5%D1%81%D1%82)
    - [Состояние места](#%D0%A1%D0%BE%D1%81%D1%82%D0%BE%D1%8F%D0%BD%D0%B8%D0%B5-%D0%BC%D0%B5%D1%81%D1%82%D0%B0)
    - [Идентификаторы платёжного агента](#%D0%98%D0%B4%D0%B5%D0%BD%D1%82%D0%B8%D1%84%D0%B8%D0%BA%D0%B0%D1%82%D0%BE%D1%80%D1%8B-%D0%BF%D0%BB%D0%B0%D1%82%D1%91%D0%B6%D0%BD%D0%BE%D0%B3%D0%BE-%D0%B0%D0%B3%D0%B5%D0%BD%D1%82%D0%B0)
4. [Автор](#%D0%90%D0%B2%D1%82%D0%BE%D1%80)
5. [Лицензия](#%D0%9B%D0%B8%D1%86%D0%B5%D0%BD%D0%B7%D0%B8%D1%8F)

Старт
-----

[](#старт)

### Установка через composer

[](#установка-через-composer)

```
$ composer require axp-dev/cinemapark-api

```

### Инициализация

[](#инициализация)

```
$CinemaPark = new AXP\CinemaPark\CinemaPark();

// Получаем информаицю по фильму "Гадкий я 3"
$film = $CinemaPark->getFilmInfo(3679);
```

Использование
-------------

[](#использование)

### Получение списка мультиплексов и городов

[](#получение-списка-мультиплексов-и-городов)

```
public function getMultiplexes() : array
```

#### Результат ответа

[](#результат-ответа)

ПолеТипОписаниеidintegerИдентификатор мультиплексаshort\_namestringКороткое название мультиплексаfull\_namestringПолное название мультиплексаdescriptionstringОписание кинотеатраphonestringТелефон кинотеатраformatsarrayСписок форматов показа фильмовcity\_idintegerИдентификатор города мультиплексаcity\_namestringНаименование города мультиплексаaddressstringАдес мультиплексаmultiplex\_geostringГеографические координаты мультиплекса### Получение списка фильмов

[](#получение-списка-фильмов)

В список могут попадать фильмы, не значащиеся в расписании мультиплексов (к примеру, поставленные в прокат на будущее, но без конкретного расписания).

```
public function getFilms() : array
```

#### Результат ответа

[](#результат-ответа-1)

ПолеТипОписаниеhas\_subtitlesboolЕсли фильм идёт с субтитрами (скорее всего, с оригинальной звуковой дорожкой)age\_idintegerКод возрастных ограничений. [Подробнее](#%D0%9A%D0%BE%D0%B4-%D0%B2%D0%BE%D0%B7%D1%80%D0%B0%D1%81%D1%82%D0%BD%D1%8B%D1%85-%D0%BE%D0%B3%D1%80%D0%B0%D0%BD%D0%B8%D1%87%D0%B5%D0%BD%D0%B8%D0%B9)startdatestringДата старта проката в нашей сети (без учёта возможных премьерных показов)genrestringТекстовое описание жанра фильмаoriginal\_titlestringОригинальное название фильма (для иностранных фильмов)timingintegerПродолжительность фильма в минутахage\_limitintegerВозрастное ограничение. В будущем будет произведён полный переход от age\_id к age\_limitcategorystringSlug категорииtitlestringРусскоязычное название фильма с учётом форматаfilm\_idintegerИдентификатор фильмаyoutubeidstringСписок трейлеров с Youtube (через запятую)### Привязка фильмов к мультиплексам

[](#привязка-фильмов-к-мультиплексам)

В список могут попадать фильмы, не значащиеся в расписании мультиплексов (к примеру, поставленные в прокат на будущее, но без конкретного расписания).

```
public function getFilmsMultiplexes() : array
```

#### Результат ответа

[](#результат-ответа-2)

ПолеТипОписаниеidintegerИдентификатор фильмаmultiplexarrayИдентификатор мультиплекса, к которому привязан фильм### Получение расписания фильма

[](#получение-расписания-фильма)

Выводится всё известное расписание, в т.ч. и прошедшие сеансы.

```
public function getRepertoir($id) : array
```

#### Параметры метода

[](#параметры-метода)

АргументТипОписаниеidintegerИдентификатор фильма#### Результат ответа

[](#результат-ответа-3)

ПолеТипОписаниеformat\_idintegerИдентификатор формата показа, соответствующий выгрузке formatshallintegerИдентификатор зала (уникален для всей сети)base\_priceintegerЦена билета на сеанс без учёта скидок (в российских рублях)idintegerИдентификатор сеансаstateboolСостояние сеанса (открыт, либо фильмокопия не поступила / произошёл срыв сеанса / сеанс отменён). [Подробнее](#%D0%A1%D0%BE%D1%81%D1%82%D0%BE%D1%8F%D0%BD%D0%B8%D0%B5-%D1%81%D0%B5%D0%B0%D0%BD%D1%81%D0%B0)datetimestringДата/время сеанса (местное время соответствующего мультиплекса)multiplexintegerИдентификатор мультиплексаglasses\_priceintegerДополнительная стоимость, взимаемая на кассе за 3D-очки### Получение расписания мультиплекса

[](#получение-расписания-мультиплекса)

```
public function getMultiplexRepertoir($id) : array
```

#### Параметры метода

[](#параметры-метода-1)

АргументТипОписаниеidintegerИдентификатор мультиплекса#### Результат ответа

[](#результат-ответа-4)

ПолеТипОписаниеformat\_idintegerИдентификатор формата показа, соответствующий выгрузке formatshallintegerИдентификатор зала (уникален для всей сети)base\_priceintegerЦена билета на сеанс без учёта скидок (в российских рублях)idintegerИдентификатор сеансаstateboolСостояние сеанса (открыт, либо фильмокопия не поступила / произошёл срыв сеанса / сеанс отменён). [Подробнее](#%D0%A1%D0%BE%D1%81%D1%82%D0%BE%D1%8F%D0%BD%D0%B8%D0%B5-%D1%81%D0%B5%D0%B0%D0%BD%D1%81%D0%B0)datetimestringДата/время сеанса (местное время соответствующего мультиплекса)multiplexintegerИдентификатор мультиплексаglasses\_priceintegerДополнительная стоимость, взимаемая на кассе за 3D-очки### Получение дополнительной информации по фильму

[](#получение-дополнительной-информации-по-фильму)

```
public function getFilmInfo($id) : array
```

#### Параметры метода

[](#параметры-метода-2)

АргументТипОписаниеidintegerИдентификатор фильма#### Результат ответа

[](#результат-ответа-5)

ПолеТипОписаниеhitboolПрисвоен ли фильму статус «Хит»descriptionstringОписание фильмаaddinfoarrayДополнительная информация, тип которой указан в атрибуте «title» (режиссёр, актёры, озвучка)yearintegerГод выпуска фильмаcountrystringСтрана фильма### Получение списка залов по всем мультиплексам

[](#получение-списка-залов-по-всем-мультиплексам)

```
public function getHalls() : array
```

#### Результат ответа

[](#результат-ответа-6)

ПолеТипОписаниеmultiplex\_idintegerИдентификатор мультиплексаtitlestringИдентификатор зала внутри мультиплексаidintegerИдентификатор зала внутри мультиплекса### Получение списка форматов показа фильмов

[](#получение-списка-форматов-показа-фильмов)

```
public function getFormats() : array
```

#### Результат ответа

[](#результат-ответа-7)

ПолеТипОписаниеidintegerИдентификатор формата (показываемый в выгрузке repertoir как format\_id)short\_namestringНаименование форматаtitle\_suffixstingТекстовая строка, которую нужно добавить к названию фильма, чтобы получить «название фильма с учётом формата»priorityintegerОчерёдность показа формата в списке форматов### Комплексная выгрузка текущего расписания мультиплекса

[](#комплексная-выгрузка-текущего-расписания-мультиплекса)

```
public function getTimeTable($id) : array
```

#### Параметры метода

[](#параметры-метода-3)

АргументТипОписаниеidintegerИдентификатор мультиплекса#### Результат ответа

[](#результат-ответа-8)

ПолеТипОписаниеhallintegerИдентификатор зала (уникален для всей сети)hall\_titlestringМаркетинговое/коммерческое наименование залаdatetimestringДата/время сеанса (местное время соответствующего мультиплекса)base\_priceintegerЦена билета на сеанс без учёта скидок (в российских рублях)age\_limitintegerВозрастное ограничение на фильмtitlestringНазвание фильма с учётом форматаhall\_website\_idintegerИдентификатор зала на сайте СИНЕМА ПАРКhas\_subtitlesboolНаличие субтитров на сеансе### Проверка возможности начать сессию выбора мест для бронирования или покупки мест

[](#проверка-возможности-начать-сессию-выбора-мест-для-бронирования-или-покупки-мест)

```
public function checkBSession($multiplex_id, $repertoir_id, $mode) : array
```

#### Параметры метода

[](#параметры-метода-4)

АргументТипОписаниеmultiplex\_idintegerИдентификатор мультиплексаrepertoir\_idintegerИдентификатор сеанса (уникален в пределах мультиплекса)modeintegerРежим открытия сессии выбора мест. [Подробнее](#%D0%A0%D0%B5%D0%B6%D0%B8%D0%BC-%D0%BE%D1%82%D0%BA%D1%80%D1%8B%D1%82%D0%B8%D1%8F-%D1%81%D0%B5%D1%81%D1%81%D0%B8%D0%B8-%D0%B2%D1%8B%D0%B1%D0%BE%D1%80%D0%B0-%D0%BC%D0%B5%D1%81%D1%82)#### Результат ответа

[](#результат-ответа-9)

ПолеТипОписаниеstatusintegerМожно ли начать сессию выбора мест. 0 - Нельзя, 1- Можно.mode\_availableinteger/arrayДоступность режимов открытия сессии выбора мест. 0 - Нельзя, 1- Можно.b\_session\_availabilityintegerКод доступности инициализации сессии. [Подробнее](#%D0%9A%D0%BE%D0%B4-%D0%B4%D0%BE%D1%81%D1%82%D1%83%D0%BF%D0%BD%D0%BE%D1%81%D1%82%D0%B8-%D0%B8%D0%BD%D0%B8%D1%86%D0%B8%D0%B0%D0%BB%D0%B8%D0%B7%D0%B0%D1%86%D0%B8%D0%B8-%D1%81%D0%B5%D1%81%D1%81%D0%B8%D0%B8)repertoir\_statusintegerВозможность работы с сеансом. [Подробнее](#%D0%92%D0%BE%D0%B7%D0%BC%D0%BE%D0%B6%D0%BD%D0%BE%D1%81%D1%82%D1%8C-%D1%80%D0%B0%D0%B1%D0%BE%D1%82%D1%8B-%D1%81-%D1%81%D0%B5%D0%B0%D0%BD%D1%81%D0%BE%D0%BC)### Инициализация сессии выбора мест для бронирования или покупки

[](#инициализация-сессии-выбора-мест-для-бронирования-или-покупки)

```
public function initBSession($multiplex_id, $repertoir_id, $mode) : array
```

#### Параметры метода

[](#параметры-метода-5)

АргументТипОписаниеmultiplex\_idintegerИдентификатор мультиплексаrepertoir\_idintegerИдентификатор сеанса (уникален в пределах мультиплекса)modeintegerРежим открытия сессии выбора мест. [Подробнее](#%D0%A0%D0%B5%D0%B6%D0%B8%D0%BC-%D0%BE%D1%82%D0%BA%D1%80%D1%8B%D1%82%D0%B8%D1%8F-%D1%81%D0%B5%D1%81%D1%81%D0%B8%D0%B8-%D0%B2%D1%8B%D0%B1%D0%BE%D1%80%D0%B0-%D0%BC%D0%B5%D1%81%D1%82)#### Результат ответа

[](#результат-ответа-10)

ПолеТипОписаниеstatusintegerМожно ли начать сессию выбора мест. 0 - Нельзя, 1- Можно.b\_session\_idstringИдентификатор сессии выбора мест, использующийся в дальнейшем при выборе мест и отмене/фиксации сессии### Получение геометрической схемы зала

[](#получение-геометрической-схемы-зала)

Схему зала можно кешировать, рассчитывая на то, что в данном конкретном сеансе она не изменится.

```
public function seatsLayout($multiplex_id, $repertoir_id) : array
```

#### Параметры метода

[](#параметры-метода-6)

АргументТипОписаниеmultiplex\_idintegerИдентификатор мультиплексаrepertoir\_idintegerИдентификатор сеанса (уникален в пределах мультиплекса)#### Результат ответа

[](#результат-ответа-11)

ПолеТипОписаниеidintegerID места. Используется для выбора или для отмены выбора местаnumberintegerНомер зрительского кресла (расположен на спинке кресла)rowintegerРяд зрительских креселxposintegerX-координата кресла на схеме залаyposintegerY-координата кресла на схеме залаblock\_NointegerНомер блока для групповых мест (диванов). Присутствует, если место является частью группового.### Получение состояния мест

[](#получение-состояния-мест)

```
public function seatStates($multiplex_id, $repertoir_id, $b_session_id, $timestamp_tz = 0) : array
```

#### Параметры метода

[](#параметры-метода-7)

АргументТипОписаниеmultiplex\_idintegerИдентификатор мультиплексаrepertoir\_idintegerИдентификатор сеанса (уникален в пределах мультиплекса)b\_session\_idstringИдентификатор сессии выбора местtimestamp\_tzintegerДата/время в формате Unix Timestamp#### Результат ответа

[](#результат-ответа-12)

ПолеТипОписаниеsql\_datearrayВремя на стороне нашей системы, соответствующее выводимым даннымb\_session\_dataarrayДанные сессии выбора мест (при наличии)seat\_statesarrayДанные по месту (при наличии)##### Данные в `b_session_data`

[](#данные-в-b_session_data)

ПолеТипОписаниеts\_start\_tzintegerВремя начала сессии в формате Unix TimestampstatusintegerТекущий статус сессии выбора мест. [Подробнее](#%D0%A1%D1%82%D0%B0%D1%82%D1%83%D1%81-%D1%81%D0%B5%D1%81%D1%81%D0%B8%D0%B8-%D0%B2%D1%8B%D0%B1%D0%BE%D1%80%D0%B0-%D0%BC%D0%B5%D1%81%D1%82)##### Данные в `seat_states`

[](#данные-в-seat_states)

ПолеТипОписаниеis\_mineboolПринадлежит ли место текущей сессии выбора местseat\_idintegerID места, соответствующее выгрузке `seatsLayout()`.stateintegerСостояние места. [Подробнее](#%D0%A1%D0%BE%D1%81%D1%82%D0%BE%D1%8F%D0%BD%D0%B8%D0%B5-%D0%BC%D0%B5%D1%81%D1%82%D0%B0)### Действие с местом в сессии выбора мест

[](#действие-с-местом-в-сессии-выбора-мест)

Выбор места или снятие выбора

```
public function seatAction($multiplex_id, $repertoir_id, $b_session_id, $action_type, $seat_id) : array
```

#### Параметры метода

[](#параметры-метода-8)

АргументТипОписаниеmultiplex\_idintegerИдентификатор мультиплексаrepertoir\_idintegerИдентификатор сеанса (уникален в пределах мультиплекса)b\_session\_idstringИдентификатор сессии выбора местaction\_typeintegerТип запроса. 0 - Снятие выбора, 1 - Выбор местаseat\_idintegerИдентификатор места#### Результат ответа

[](#результат-ответа-13)

ПолеТипОписаниеstatusboolУдалось или нет произвести действие с местомstatustextstringТекстовое описание проблемы, возникшей при попытке произвести действие с местом. В зависимости от проблемы может выводиться либо примерное описание проблемы (к примеру, «Сеанс отменён»), либо информация о внутренних системных ошибках с соответствующими номерами ошибок.### Отмена или закрытие сессии выбора мест

[](#отмена-или-закрытие-сессии-выбора-мест)

Используется, когда пользователь хочет отказаться от бронирования или покупки на стадии выбора мест

```
public function cancelBSession($multiplex_id, $repertoir_id, $b_session_id) : array
```

#### Параметры метода

[](#параметры-метода-9)

АргументТипОписаниеmultiplex\_idintegerИдентификатор мультиплексаrepertoir\_idintegerИдентификатор сеанса (уникален в пределах мультиплекса)b\_session\_idstringИдентификатор сессии выбора мест#### Результат ответа

[](#результат-ответа-14)

ПолеТипОписаниеstatusboolУдалось или нет произвести закрытие сессии выбора местstatustextstringТекстовое описание проблемы, возникшей при попытке произвести действие с местом. В зависимости от проблемы может выводиться либо примерное описание проблемы (к примеру, «Сеанс отменён»), либо информация о внутренних системных ошибках с соответствующими номерами ошибок.### Закрытие сессии выбора мест

[](#закрытие-сессии-выбора-мест)

Фиксация выбора мест

```
public function commitBSession($multiplex_id, $repertoir_id, $b_session_id, $mode, $email, $phone, $provider_id) : array
```

#### Параметры метода

[](#параметры-метода-10)

АргументТипОписаниеmultiplex\_idintegerИдентификатор мультиплексаrepertoir\_idintegerИдентификатор сеанса (уникален в пределах мультиплекса)b\_session\_idstringИдентификатор сессии выбора местmodeintegerРежим открытия сессии выбора мест. [Подробнее](#%D0%A0%D0%B5%D0%B6%D0%B8%D0%BC-%D0%BE%D1%82%D0%BA%D1%80%D1%8B%D1%82%D0%B8%D1%8F-%D1%81%D0%B5%D1%81%D1%81%D0%B8%D0%B8-%D0%B2%D1%8B%D0%B1%D0%BE%D1%80%D0%B0-%D0%BC%D0%B5%D1%81%D1%82)emailstringАдрес электронной почты для получения уведомлений об изменении состояния заказаphoneintegerНомер телефона (10 цифр) для получения sms-уведомлений об изменении состояния заказаprovider\_idintegerИдентификатор платёжного агента. [Подробнее](#%D0%98%D0%B4%D0%B5%D0%BD%D1%82%D0%B8%D1%84%D0%B8%D0%BA%D0%B0%D1%82%D0%BE%D1%80%D1%8B-%D0%BF%D0%BB%D0%B0%D1%82%D1%91%D0%B6%D0%BD%D0%BE%D0%B3%D0%BE-%D0%B0%D0%B3%D0%B5%D0%BD%D1%82%D0%B0)#### Результат ответа

[](#результат-ответа-15)

ПолеТипОписаниеstatusboolУдалось или нет закрыть сессию выбора местstatustextstringТекстовое описание проблемы, возникшей при попытке произвести действие с местом. В зависимости от проблемы может выводиться либо примерное описание проблемы (к примеру, «Сеанс отменён»), либо информация о внутренних системных ошибках с соответствующими номерами ошибок.order\_idintegerНомер заказа. В случае бронирования он соответствует номеру брони, в случае продажи – будущему номеру продажи### Открытие сессии выбора мест после фиксации

[](#открытие-сессии-выбора-мест-после-фиксации)

Для брони – редактирование существующей брони, для продажи – возврат в режим выбора мест до осуществления оплаты Если существующая бронь была переведена в режим редактирования и после этого не произошло завершение сессии с фиксацией выбора мест через `commitBSession()`, то бронь будет отменена по тайм-ауту.

```
public function editBooking($multiplex_id, $repertoir_id, $codeword) : array
```

#### Параметры метода

[](#параметры-метода-11)

АргументТипОписаниеmultiplex\_idintegerИдентификатор мультиплексаrepertoir\_idintegerИдентификатор сеанса (уникален в пределах мультиплекса)codewordstringКодовое слово заказа. Вводится пользователем и передаётся в нашу систему в момент фиксации выбора мест. Максимум 16 символов#### Результат ответа

[](#результат-ответа-16)

ПолеТипОписаниеstatusboolУдалось или нет перевести бронь в режим редактированияstatustextstringТекстовое описание проблемы, возникшей при попытке произвести действие с местом. В зависимости от проблемы может выводиться либо примерное описание проблемы (к примеру, «Сеанс отменён»), либо информация о внутренних системных ошибках с соответствующими номерами ошибок.b\_session\_idstringИдентификатор сессии выбора мест, который впоследствии используется для выбора мест и последующей отмены или завершения сессии с фиксацией выбора мест### Инициализация сессии оплаты

[](#инициализация-сессии-оплаты)

Вызывается перед направлением пользователя на страницу оплаты (после того, как был зафиксирован выбор мест, сформирована цена заказа и пользователь изъявил желание оплатить заказ)

```
public function initSSession($multiplex_id, $order_id, $codeword, $provider_id) : array
```

#### Параметры метода

[](#параметры-метода-12)

АргументТипОписаниеmultiplex\_idintegerИдентификатор мультиплексаorder\_idintegerИдентификатор заказа в конкретном мультиплексеcodewordstringКодовое слово заказа. Вводится пользователем и передаётся в нашу систему в момент фиксации выбора мест. Максимум 16 символовprovider\_idintegerИдентификатор платёжного агента. [Подробнее](#%D0%98%D0%B4%D0%B5%D0%BD%D1%82%D0%B8%D1%84%D0%B8%D0%BA%D0%B0%D1%82%D0%BE%D1%80%D1%8B-%D0%BF%D0%BB%D0%B0%D1%82%D1%91%D0%B6%D0%BD%D0%BE%D0%B3%D0%BE-%D0%B0%D0%B3%D0%B5%D0%BD%D1%82%D0%B0)#### Результат ответа

[](#результат-ответа-17)

ПолеТипОписаниеstatusboolУдалось или нет произвести инициализацию сессии оплатыstatustextstringТекстовое описание проблемы, возникшей при попытке инициализировать сессию оплаты. В зависимости от проблемы может выводиться либо примерное описание проблемы (к примеру, «Время на оплату истекло»), либо информация о внутренних системных ошибках с соответствующими номерами ошибок.order\_numberstringНомер заказа для последующего сообщения клиенту. Формат – MM-NNNNNNamountintegerСумма заказа в российских рублях на момент инициализации сессии. Должна совпадать с суммой оплаты, передаваемой в `commitSSession()`.timestamp\_validuntilintegerВремя, до которого необходимо оплатить заказ (UTC)timestamp\_validuntil\_tzintegerЭто же время в формате timestamp tzsecurity\_keystringЦифровая подпись запроса на оплату. Формируется в соответствии с индивидуальными для каждого платёжного агента договорённостями### Фиксация факта оплаты заказа

[](#фиксация-факта-оплаты-заказа)

```
public function commitSSession($multiplex_id, $order_id, $provider_id, $amount, $dt_payment, $transaction_id, $payment_type, $payment_info, $security_key) : array
```

#### Параметры метода

[](#параметры-метода-13)

АргументТипОписаниеmultiplex\_idintegerИдентификатор мультиплексаorder\_idintegerИдентификатор заказа в конкретном мультиплексеprovider\_idintegerИдентификатор платёжного агента. [Подробнее](#%D0%98%D0%B4%D0%B5%D0%BD%D1%82%D0%B8%D1%84%D0%B8%D0%BA%D0%B0%D1%82%D0%BE%D1%80%D1%8B-%D0%BF%D0%BB%D0%B0%D1%82%D1%91%D0%B6%D0%BD%D0%BE%D0%B3%D0%BE-%D0%B0%D0%B3%D0%B5%D0%BD%D1%82%D0%B0)amountintegerСумма оплаты в российских рублях. Должна соответствовать сумме, полученной в результате обращения к `initSSession()`dt\_paymentstringДата/время платежа в соответствии с данными платёжной системы, UTC, формат «YYYY-MM-DD HH:MM:SS»transaction\_idmixedИдентификатор транзакции в платёжной системе (или в вашей системе обработки платежей)payment\_typestringНаименование механизма оплаты (к примеру, Card – банковская карта, Qiwi – платёжная система Qiwi и т.д.). Строка, максимум 20 символов.payment\_infostringИнформация о плательщике, которая может помочь дежурному администратору кинотеатра определить «владельца заказа» в случае, когда клиент не может вспомнить номер заказа и кодовое словоsecurity\_keystringЦифровая подпись подтверждения платежа. Формируется по тем же правилам, что в методе `initSSession()`#### Результат ответа

[](#результат-ответа-18)

ПолеТипОписаниеstatusboolОплаты прошла успешно### Фиксация факта неудачи оплаты заказа

[](#фиксация-факта-неудачи-оплаты-заказа)

```
public function registerPaymentFailure($multiplex_id, $order_id, $provider_id, $amount, $dt_payment, $transaction_id, $payment_type, $payment_info, $security_key) : array
```

#### Параметры метода

[](#параметры-метода-14)

Параметры полностью идентичны используемым в `commitSSession()`. [Подробнее](#%D0%98%D0%BD%D0%B8%D1%86%D0%B8%D0%B0%D0%BB%D0%B8%D0%B7%D0%B0%D1%86%D0%B8%D1%8F-%D1%81%D0%B5%D1%81%D1%81%D0%B8%D0%B8-%D0%BE%D0%BF%D0%BB%D0%B0%D1%82%D1%8B)

#### Результат ответа

[](#результат-ответа-19)

ПолеТипОписаниеresultstringСообщение от сервисаВспомогательная информация
--------------------------

[](#вспомогательная-информация)

### Код возрастных ограничений

[](#код-возрастных-ограничений)

ЗначениеОписание1без ограничений по возрасту2до 12 лет в сопровождении родителей3достигшим 14 лет4достигшим 16 лет5достигшим 18 лет6для детей старше 6 лет### Состояние сеанса

[](#состояние-сеанса)

ЗначениеОписание1Сеанс открыт, в нём можно бронировать и покупать билетыне 1Сеанс не открыт, в нём нельзя бронировать и покупать билетыВопрос «показывать ли пользователю сеансы, где state != 1» остаётся на ваше усмотрение.

### Режим открытия сессии выбора мест

[](#режим-открытия-сессии-выбора-мест)

ЗначениеОписание0Проверка режимов бронирования и покупки1Бронирование2Покупка### Код доступности инициализации сессии

[](#код-доступности-инициализации-сессии)

ЗначениеОписание0Ошибка получения статуса1Можно инициализировать сессию2Превышено общее количество активных сессий3Превышено количество активных сессий в мультиплексе4Превышено количество активных сессий в сеансе5Превышено количество активных сессий по IP-адресу6Превышено общее количество сессий по IP-адресу7Превышено количество бронирований по IP-адресу8Система недоступна, ведутся технические работыДля IP, внесённых в «белый список», всегда должно возвращаться 1.

### Возможность работы с сеансом

[](#возможность-работы-с-сеансом)

ЗначениеОписание0Различные нарушения целостности базы данных1Нет соединения с базой данных2Отсутствует сеанс3Сеанс не открыт4В зале нет ни одного свободного места, бронь и продажи закрыты5Всё OK, сеанс открыт – можно бронировать и продавать6Слишком мало времени до сеанса, продажа запрещена7Слишком мало времени до сеанса, бронирование запрещено8Сеанс прошёл9В зале осталось мало свободных мест — разрешена только продажа10В данном сеансе разрешено только бронирование### Статус сессии выбора мест

[](#статус-сессии-выбора-мест)

ЗначениеОписание1Идёт выбор мест2Выбор мест отменён (пользователь отказался от бронирования/покупки на стадии выбора мест)3Таймаут выбора (сессия закрыта по тайм-ауту, пользователь не отказался от выбора мест, но и не подтвердил его)4Места забронированы5Бронь снята (после подтверждения брони пользователь отказался от неё)6Таймаут оплаты (после фиксации выбора мест оплата не поступила в установленное время)7Покупка совершена, места оплачены### Состояние места

[](#состояние-места)

ЗначениеОписание0Место свободно1Место блокировано (в настоящий момент выбрано для бронирования или продажи)2Место забронировано3Место продано (билет выдан на руки клиенту)### Идентификаторы платёжного агента

[](#идентификаторы-платёжного-агента)

ЗначениеОписание1PayOnline2Рамблер/Афиша3КиноходАвтор
-----

[](#автор)

[Alexander Pushkarev](https://github.com/axp-dev), e-mail:

Лицензия
--------

[](#лицензия)

Основой Cinema Park API являет открытый исходный код, в соответствии [MIT license](https://opensource.org/licenses/MIT)

###  Health Score

27

—

LowBetter than 49% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity11

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity60

Established project with proven stability

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~0 days

Total

3

Last Release

3200d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/9544696857999f7e99ac8bd88ca4e695387f288057feea75c6e5e932570af349?d=identicon)[AXP](/maintainers/AXP)

---

Top Contributors

[![axp-dev](https://avatars.githubusercontent.com/u/24683246?v=4)](https://github.com/axp-dev "axp-dev (31 commits)")

---

Tags

apicinemacinemaparkapicinemacinemapark

### Embed Badge

![Health badge](/badges/axp-dev-cinemapark-api/health.svg)

```
[![Health](https://phpackages.com/badges/axp-dev-cinemapark-api/health.svg)](https://phpackages.com/packages/axp-dev-cinemapark-api)
```

###  Alternatives

[openai-php/laravel

OpenAI PHP for Laravel is a supercharged PHP API client that allows you to interact with the Open AI API

3.7k7.6M74](/packages/openai-php-laravel)[mailchimp/transactional

458.9M16](/packages/mailchimp-transactional)[get-stream/stream-chat

A PHP client for Stream Chat (https://getstream.io/chat/)

301.8M2](/packages/get-stream-stream-chat)[convertkit/convertkitapi

Kit PHP SDK for the Kit API

2167.1k1](/packages/convertkit-convertkitapi)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)