èß 欠湩浯硡

Экспорт расписания с сайта kinomax.ru
27.01.2015
Изменения в документе
27.01.2015 – Второй релиз утилиты экспорта расписания
28.02.2013 – Добавлены элементы ytVideoID и posterURL
12.09.2011 – Добавлен элемент genres – список жанров фильма. Добавлено пояснение к
элементу length.
30.08.2011 – Первый релиз
Доступ
В настоящий момент общий доступ для утилиты экспорта расписания закрыт. Для
получения доступа необходимо обратиться к администраторам сайта
(webmaster@kinomax.ru) и предоставить IP адрес, с которого будут производиться
обращения. Именно на основе IP адреса и будет производиться авторизация.
При необходимости можно предоставить набор IP-адресов, для которых нужно открыть
доступ.
При запросе доступа можно также указать - требуется ли передача полной информации о
фильме или достаточно названия и постера (кадра).
Запрос
Для экспорта расписания нужно обращаться по следующему адресу:
http://kinomax.ru/export/schedule?cinema=cinemaid[&date=scheduledate]
Скрипт принимает параметры:
cinema – идентификатор кинотеатра. Обязательный параметр. Может быть цифровой или
строковый идентификатор кинотеатра.
Каждый кинотеатр на kinomax.ru имеет два идентификатора – числовой и текстовый, для
удобства (список всех идентификаторов приведен ниже). Узнать текстовый
идентификатор любого кинотеатра достаточно просто - для этого на сайте необходимо
открыть страницу с расписанием и посмотреть в URL страницы.
Например, в адресе http://kinomax.ru/vladimir идентификатором кинотеатра является
vladimir.
Возврат расписания для нескольких кинотеатров одновременно не поддерживается.
date – дата, для которой нужно получить расписание. Передается в формате YYYY-mm-dd.
Необязательный параметр. В случае, если он отсутствует, будет возвращено расписание
за текущий день.
Примеры.
 http://kinomax.ru/export/schedule?cinema=solaris – расписание для кинотеатра
«Солярис» (Москва) на текущий день.
 http://kinomax.ru/export/schedule?cinema=vladimir&date=2015-02-01 – расписание
кинотеатра во Владимире на 2 февраля.
Ответ
Ответ – это текст формата 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 – диапазон цен на сеанс
Пример
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<response>
<result>ok</result>
<message/>
<cinema id="4" token="vladimir">Киномакс-Буревестник Владимир</cinema>
<city id="3">Владимир</city>
<cityDatetime timezone="Europe/Moscow">2015-01-27 01:11:23</cityDatetime>
<scheduleForDate>2015-01-27</scheduleForDate>
<movies>
<movie id="2379">
<name>Тупой и еще тупее 2</name>
<length>108</length>
<description><![CDATA[Гарри Данн и Ллойд Кристмас отправляются в
путешествие, чтобы разыскать ребенка Гарри, о существовании которого он не
подозревал.]]></description>
<genres>Комедия</genres>
<rating votes="90">3.86</rating>
<frameUrl>http://kinomax.ru/data/films/2014/km2-2379.jpg</frameUrl>
<trailer>http://www.youtube.com/watch?v=zGeEFklw108</trailer>
<director>Питер Фаррелли, Бобби Фаррелли</director>
<cast>Джим Керри, Джефф Дэниелс, Роб Риггл, Лори Холден, Рэйчел
Мелвин</cast>
<schedule>
<session id="815911" time="10:20" passed="false">
<type id="2d">2D</type>
<plan>http://kinomax.ru/order/hallplan?session=815911</plan>
<hall><![CDATA[САТУРН]]></hall>
<priceRange>от 130р.</priceRange>
</session>
<session id="815919" time="13:20" passed="false">
<type id="2d">2D</type>
<plan>http://kinomax.ru/order/hallplan?session=815919</plan>
<hall><![CDATA[Зал 1]]></hall>
<priceRange>от 130р.</priceRange>
</session>
</schedule>
</movie>
</movies>
</response>
При разборе ответа необходимо обратить внимание на следующее:
 Названия зала, а также описания заключаются в элементы CDATA. Хотя в
большинстве случаев это не накладывает никаких дополнительных проблем при
парсинге.
 В description могут встречаться HTML теги форматирования текста.
 Приведенный выше пример ответа содержит полное описание фильмов. Если вы
не запрашивали доступ к экспорту с полным описанием, то вы будете получать
более короткий ответ.
Список кинотеатров
Город
Кинотеатр
Числовой ID Строковый ID
Москва
Киномакс-XL
2
xl
Владимир
Киномакс-Буревестник
4
vladimir
Москва
Солярис
5
solaris
Челябинск
Киномакс-Урал
6
ural
Волгоград
Киномакс
8
volgograd
Екатеринбург
Киномакс 3D Мегаполис
10
megapolis
Город
Кинотеатр
Числовой ID Строковый ID
Казань
Киномакс - Тандем
11
kazan
Пермь
Киномакс
13
perm
Ростов-на-Дону Киномакс-Дон
14
don
Тамбов
Киномакс-Родина
19
tambov-rodina
Томск
Киномакс
20
tomsk
Тамбов
Киномакс-Фестиваль Парк
23
festival
Красноярск
Киномакс-Планета
24
planeta
Краснодар
Киномакс-Галерея Краснодар
25
krasnodar
Ярославль
Киномакс-Ярославль
26
yaroslavl
Ижевск
Киномакс-Ижевск
27
izhevsk
Киров
Киномакс-Киров
28
kirov
Казань
Киномакс-Club
29
kazan-ug
Челябинск
Киномакс-Родник
30
Rodnik
Астрахань
Киномакс IMAX Астрахань
31
astrahan
Волжский
Киномакс-Волжский
33
volzhsky
Рязань
Киномакс IMAX Рязань
32
ryazan
Уфа
Киномакс-Уфа
34
ufa
Тюмень
Киномакс-Тюмень
35
tumen
Тамбов
Киномакс-Акварель Тамбов
37
aquarel
Ярославль
Киномакс-Аура Ярославль
38
aura
Ростов-на-Дону Киномакс-Плаза Ростов-на-Дону 40
plaza
Самара
Киномакс-Самара
41
samara
Москва
Киномакс-Водный Москва
42
vodny