Доступ к API (выгрузка расписания)
В настоящий момент общий доступ для утилиты экспорта расписания закрыт. Для получения доступа необходимо отправить заявку администратору сайта на webmaster@kinomax.ru, указав адрес (url) сайта и IP адрес, с которого будут производиться обращения. Именно на основе IP адреса и будет производиться авторизация. При необходимости можно предоставить набор IP-адресов, для которых нужно открыть доступ.

Запрос
Для экспорта расписания нужно обращаться по следующему адресу:

Скрипт принимает параметры:
cinema – идентификатор кинотеатра. Обязательный параметр. Узнать текстовый идентификатор любого кинотеатра достаточно просто - для этого на сайте необходимо открыть страницу с расписанием и посмотреть в URL страницы. Например, в адресе http://kinomax.ru/vladimir идентификатором кинотеатра является vladimir.

Числовые идентификаторы кинотеатров перечислены ниже:
2 - Киномакс-XL, Москва
4 - Киномакс-Буревестник, Владимир
5 - Киномакс-Солярис, Москва
6 - Киномакс-Урал, Челябинск
8 - Киномакс-Волгоград
10 - Киномакс 3D-Мегаполис, Екатеринбург
11 - Киномакс-Тандем, Казань
13 - Киномакс-Пермь,
14 - Киномакс-Дон, Ростов-на-Дону
20 - Киномакс-Томск
23 - Киномакс-Фестиваль, Парк Тамбов
24 - Киномакс-Планета, Красноярск
25 - Киномакс-Краснодар
26 - Киномакс-Альтаир, Ярославль
27 - Киномакс-Ижевск
28 - Киномакс-Киров
29 - Киномакс-Club, Казань
30 - Киномакс-Родник, Челябинск
31 - Киномакс IMAX, Астрахань
32 - Киномакс IMAX, Рязань
33 - Киномакс-Волжский
34 - Киномакс-Уфа
35 - Киномакс-Тюмень
37 - Киномакс-Акварель, Тамбов
38 - Киномакс-Аура, Ярославль
40 - Киномакс-Плаза, Ростов-на-Дону
41 - Киномакс-Самара
42 - Киномакс-Водный, Москва
43 - Киномакс-Пражская, Москва
44 - Киномакс-Кожуховская, Москва

Возврат расписания для нескольких кинотеатров одновременно не поддерживается.

date – дата, для которой нужно получить расписание. Передается в формате YYYY-mm-dd. Необязательный параметр. В случае, если он отсутствует, будет возвращено расписание за текущий день.

Ответ API
Ответ – это текст формата XML (MIME-type text/xml). Кодировка ответа – UTF-8.

Формат документа
response – корневой элемент;
result – результат выполнения запроса (ok / error);
message – сообщение об ошибке (приходит всегда, но заполняется только при result = error);
cinema – название кинотеатра;
city – название города;
cityDatetime – текущее время в указанном городе;
scheduleForDate – для какой даты содержит расписание текущий документ;
movies – контейнер для фильмов;
movie – контейнер описания фильма;
name – название фильма;
length – длительность фильма (в минутах);
description – описание фильма;
genres – список жанров фильма, разделенных запятой;
rating – рейтинг фильма на сайте kinomax.ru;
frameUrl – адрес картинки фильма;
trailer – URL трейлера на YouTube;
director – режиссер фильма;
cast – актерский состав;
schedule – контейнер для расписания;
session – контейнер для сеанса (в атрибуте passed указывается прошел ли этот сеанс или нет);
type – тип сеанса;
plan – URL для покупки билетов;
hall – название зала;
priceRange – диапазон цен на сеанс.

При разборе ответа необходимо обратить внимание на следующее:

• Названия зала, а также описания заключаются в элементы CDATA. Хотя в большинстве случаев это не накладывает никаких дополнительных проблем при парсинге.
• В description могут встречаться HTML теги форматирования текста.
• Приведенный выше пример ответа содержит полное описание фильмов. Если вы не запрашивали доступ к экспорту с полным описанием, то вы будете получать более короткий ответ.

По вопросам установки и работы ВИДЖЕТА/API "КИНОМАКС": webmaster@kinomax.ru