README

用于与Cinema Park信息系统中集成 的PHP库。

目录

1. 开始
   • Composer
   • 初始化
2. 使用
   • 获取电影院、电影和场次的信息
     • 获取多厅和城市的列表
     • 获取电影列表
     • 将电影与多厅关联
     • 获取电影的排期
     • 获取多厅的排期
     • 获取电影的其他信息
     • 获取所有多厅的影厅列表
     • 获取电影放映格式的列表
     • 全面导出当前多厅排期
   • 组织在线预订和销售
     • 检查是否可以开始选择座位预订或购买座位的会话
     • 初始化选择座位预订或购买的会话
     • 获取影厅的几何布局
     • 获取座位的状态
     • 在座位选择会话中操作座位
     • 取消或关闭座位选择会话
     • 关闭座位选择会话
     • 在锁定后打开座位选择会话
     • 初始化支付会话
     • 锁定订单支付的事实
     • 锁定订单支付失败的事实
3. 辅助信息
   • 年龄限制代码
   • 会话状态
   • 选择座位会话的打开模式
   • 初始化会话的可访问性代码
   • 会话的可操作性
   • 选择座位会话的状态
   • 座位状态
   • 支付代理标识符
4. 作者
5. 许可

开始

通过composer安装

$ composer require axp-dev/cinemapark-api

初始化

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

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

使用

获取多厅和城市的列表

public function getMultiplexes() : array

响应结果

获取电影列表

列表中可能包含不在多厅排期中的电影（例如，将来上映但尚未排期的电影）。

public function getFilms() : array

响应结果

将电影与多厅关联

列表中可能包含不在多厅排期中的电影（例如，将来上映但尚未排期的电影）。

public function getFilmsMultiplexes() : array

响应结果

获取电影的排期

输出所有已知排期，包括已结束的场次。

public function getRepertoir($id) : array

方法参数

响应结果

获取多厅的排期

public function getMultiplexRepertoir($id) : array

方法参数

响应结果

获取电影的其他信息

public function getFilmInfo($id) : array

方法参数

响应结果

获取所有多厅的影厅列表

public function getHalls() : array

响应结果

获取电影放映格式的列表

public function getFormats() : array

响应结果

全面导出当前多厅排期

public function getTimeTable($id) : array

方法参数

响应结果

检查是否可以开始选择座位预订或购买座位的会话

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

方法参数

响应结果

初始化选择座位预订或购买的会话

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

方法参数

响应结果

获取影厅的几何布局

可以缓存影厅布局，假设在特定场次中它不会改变。

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

方法参数

响应结果

获取座位的状态

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

方法参数

响应结果

b_session_data中的数据

seat_states中的数据

在座位选择会话中操作座位

选择座位或取消选择

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

方法参数

响应结果

取消或关闭座位选择会话

当用户想在座位选择阶段放弃预订或购买时使用

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

方法参数

响应结果

关闭座位选择会话

锁定选择

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

方法参数

响应结果

在锁定后打开座位选择会话

对于预订 – 编辑现有预订，对于销售 – 返回到支付前的选择座位模式。如果现有预订已转换为编辑模式，并且在此之后未通过commitBSession()完成锁定选择座位的会话，则预订将被取消。

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

方法参数

响应结果

初始化支付会话

在将用户导向支付页面之前调用（在锁定座位选择、形成订单价格并用户表示愿意支付订单之后）

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

方法参数

响应结果

锁定订单支付的事实

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

方法参数

响应结果

锁定订单支付失败的事实

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

方法参数

参数完全相同于在commitSSession()中使用。 更多信息

响应结果

辅助信息

年龄限制代码

会话状态

是否显示state != 1的会话的问题留给你决定。

选择座位会话的打开模式

初始化会话的可访问性代码

对于列入“白名单”的IP，始终应返回1。

会话的可操作性

选择座位会话的状态

座位状态

支付代理标识符

作者

Alexander Pushkarev，电子邮件：axp-dev@yandex.com

许可

Cinema Park API的基础是开源代码，符合MIT许可