Справочная информация предоставляется в открытом виде, по запросу на общедоступную ссылку, без секретного кода. Список справочной информации:.

# Название справочника Адрес обращения
1 RSS - афиша событий за неделю http://api.voxxter.ru/export/xml/rss/?s=XXXX
2 RSS - афиша событий принимающих Единый билет Voxxter http://api.voxxter.ru/export/xml/pass/?s=XXXX
3 RSS - афиша мест принимающих Единый билет Voxxter http://api.voxxter.ru/export/xml/pass/?s=XXXX&expo=1
4 Список событий с продажей билетов http://api.voxxter.ru/export/xml/events/?s=XXXX
5 Список мест с продажей билетов http://api.voxxter.ru/export/xml/places/?s=XXXX

Параметр S(key) – уникальный не секретный идентификатор инфопартнера. Выдается по запросу при заключении договора.


Код кнопки продажи билетов на соответствующее событие или место представлен в двух вариантах:

  • Код кнопки для внедрения на странице (автоматическая генерация фрейма)
  • Адрес страницы для открытия во фрейме (фрейм создается на стороне инфопартнера)

В качестве транспортного протокола используется протокол http.

RSS - афиша событий за неделю

В ответ на запрос по адресу: http://api.voxxter.ru/export/xml/rss/?s=XXXX
Сервер Voxxter выдает XML-файл вида:

<rss version="2.0">
	<channel>
		<title>Voxxter.ru: Афиша</title>
		<link>http://voxxter.ru</link>
		<description>Voxxter - путеводитель городского туриста</description>
		<image>
			<url>URL logo Voxxter</url>
			<title>Voxxter.ru</title>
			<link>http://voxxter.ru</link>
		</image>
		<item>
			<title>Название события</title>
			<link>Ссылка на события на voxxter.ru</link>
			<pdalink>Ссылка на события на m.voxxter.ru</pdalink>
			<pubdate>Дата начала события</pubdate>
			<description>Короткое описание события</description>
			<content>Полное описание события</content>
			<enclosure url="ссылка на изображение превью события" />
		</item>
		<item>
			<title>Название события</title>
			...
		</item>
	</channel>
</rss>

Если запрос содержит ошибку, то ответ:
<voxxter>
	<error id="Идентификатор ошибки">Текст ошибки<error>
</voxxter>

Получение справочника «Список событий»

В ответ на запрос по адресу: http://api.voxxter.ru/export/xml/events/?s=XXXX
Сервер Voxxter выдает XML-файл вида:

<voxxter>
	<counter>Число событий в списке<counter>					
	<event id="цифровой идентификатор события">
		<availability>1-если событие доступно для продажи</availability>	
		<button_id>номер кнопки</button_id>
		<date_begin>дата и время начала события</date_begin>
		<date_end>дата и время окончания события</date_end>
		<type>Тип события</type>
		<title>Название события</title>
	</event>
	<event id="...">
		...
	</event>
	<error id="0"><error>
</voxxter>

Если запрос содержит ошибку, то ответ:
<voxxter>
	<error id="Идентификатор ошибки">Текст ошибки<error>
</voxxter>
Если в запросе указать необязательный параметр ID ( http://api.voxxter.ru/export/xml/events/?s=XXXX&id=XX), где ID - уникальный идентификатор события из справочника, то можно получить расширенную информацию по событию.
Сервер Voxxter выдает XML-файл вида:
<voxxter>
	<counter>1<counter>
	<event id="цифровой идентификатор события">
		<availability>1-если событие доступно для продажи</availability>
		<button_id>номер кнопки</button_id>
		<date_begin>дата и время начала события</date_begin>
		<date_end>дата и время окончания события</date_end>		
		<type>Тип события</type>		
		<link>Ссылка на страницу события на Voxxter.ru</link>
		<pdalink>Ссылка на страницу события для мобильных устройств</pdalink>
		<description>Описание события</description>
		<img_preview  url="ссылка на изображение превью события"/>
		<places>
			<place id="цифровой идентификатор места проведения события"/>
			...
			<place id="цифровой идентификатор места проведения события"/>			
		</places>
		<tickets>
			<set id="цифровой идентификатор билета">Название билета</set>
			...
			<set id="цифровой идентификатор билета">Название билета</set>		
		</tickets>			
	</event>
	<error id="0"><error>
</voxxter>

Получение справочника «Список мест»

В ответ на запрос по адресу: http://api.voxxter.ru/export/xml/places/?s=XXXX
Сервер Voxxter выдает XML-файл вида:

<voxxter>
	<counter>Число мест в списке<counter>
	<place id="цифровой идентификатор места">
		<availability>1-если место доступно для продажи</availability>
		<button_id>номер кнопки</button_id>
		<type>Тип места</type>
		<title>Название места</title>
		<city>Город</city>
		<address>Адрес</address>
	</place>
	<place id="...">
		...
	</place>
	<error id="0"><error>
</voxxter>
Если запрос содержит ошибку, то ответ:
<voxxter>
	<error id="Идентификтор ошибки">Текст ошибки<error>
</voxxter>
Если в запросе указать необязательный параметр ID ( http://api.voxxter.ru/export/xml/places/?s=XXXX&id=XX), где ID - уникальный идентификатор места из справочника, то можно получить расширенную информацию по месту.
Сервер Voxxter выдает XML-файл вида:
<voxxter>
	<counter>1<counter>
	<place id="цифровой идентификатор места">
		<availability>1-если место доступно для продажи</availability>
		<button_id>номер кнопки</button_id>
		<type>Тип места</type>
		<title>Название места</title>
		<city>Город</city>
		<address>Адрес</address>
		<link>Ссылка на страницу места на Voxxter.ru</link>
		<pdalink>Ссылка на страницу места для мобильных устройств</pdalink>
		<description>Описание места </description>
		<img_preview  url="ссылка на изображение превью места"/>
		<tickets>
			<set id="цифровой идентификатор билета">Название билета</set>
			...
			<set id="цифровой идентификатор билета">Название билета</set>		
		</tickets>
		<seats>
			<seats_preview  url="ссылка на изображение превью схемы зала"/>
			<location id="цифровой идентификатор размещения" name="название размещения">
				<row id="цифровой идентификатор ряда" name="название ряда">
					<seat id="цифровой идентификатор места" name="название места"></seat>
					...
					<seat id="цифровой идентификатор места" name="название места"></seat>
				</row>
				...
				<row id="цифровой идентификатор ряда" name="название ряда"> ... </row>
			</location>
			...
			<location id="цифровой идентификатор размещения" name="название размещения">...</location>
		</seats>
	</place>
	<error id="0"><error>
</voxxter>