Работа с мероприятиями

В этом разделе описывается упрощённая, но достаточная в большенстве случаев интеграции, модель работы с мероприятиями.

/v1/services/simple/events

Запрос GET /v1/services/simple/events позволяет простым способом всю необходимую получить информацию по всем мероприятиям, доступным для продажи авторизированному партнёру.

Пример запроса.

Основные поля

id:

id мероприятия
created_at:

дата создания
updated_at:

дата последнего изменения
lifetime:

vevent, время проведения мероприятия
status:

текущий статус мероприятия (public — публичное мероприятие, можно продавать билеты)
title:
text:название мероприятия
desc:описание мероприятия
media:

media логитипы в различных размерах:

cover_original:
cover:
cover_small:
org:

информация об организаторе мероприятия

id:id организатора
name:название организатора
desc:краткое описание
media:логитипы (media)
contact:контактная информация
venue:

место проведения

id:
address:адрес
country:страна
city:город
name:название
desc:краткое описание
point:координата (GeoJSON’s point)
map:

схема зала

id:
sets:

билетные категории

id:
pos:

int, порядковый номер категории (для сортировки)
name:

название категории
amount:

общее количество билетов в сете
amount_vacant:

количество билетов, доступных для продажи
price_org:

номинальная цена билета
price_extra:

сервисный сбор
price:

общая цена билета
with_seats:

наличие посадочных мест в категории
seats:

места
sector:

сектор
rules:

правила

id:
cal:vevent, время действия правила
current:true, если правило текущее
price_org:номинальная цена
price_extra:сервисный сбор
price:конечная цена
partner:

устаревшее поле, будет удалено в будущем

Фильтры

Фильтры добавляются в виде параметров URL.

org:id организатора;
venue:id площадки;
country:страна;
city:город;
lifetime__range:
 фильтр по времени проведения мероприятия, указывается двумя ISO-датами через запяту;
price__range:фильтр по стоимости, указывается двумя числами, через запятую;

Паджинация

page_size:количество мероприятий на странице;
page:номер страницы;

Сортировка

Сортировка производится указанием параметра sort с соответтвующим значением. Каждое значение может начинаться с символа - для изменения порядка сортировки.

Может быть указано несколько элементов сортировки одновременно, через запятую:

GET /v1/services/simple/events?sort=-price,start
start:
end:
price:

/v1/resources/events/:id/tickets

Получение списка билетов мероприятия, для категорий с рассадкой.

Поля

id:

id билета
status:

одно из vacant, reserved или sold
set:

билетная категория
reserved_till:

если статус reserved, то это время окончания конца резервирования
seat:

Информация о месте проведения

row:ряд
number:место
sector:сектор карты

Пример запроса.

Фильтры

Фильтры добавляются в виде параметров URL.

status:статус билета или список статусов через запятую;

VEVENT

Поле типа vevent, это строка в формате VEVENT из RFC 2445. В настоящий момент поддерживается только два значения: DTSTART и DTEND. Значения указываются только в UTC

Пример:

BEGIN:VEVENT\r\n
DTSTART;VALUE=DATE-TIME:20160124T160000Z\r\n
DTEND;VALUE=DATE-TIME:20160124T173000Z\r\n
END:VEVENT\r\n

Media

Различные медиа-данные имеют общий формат.

id:
author:id создателя
content_type:тип файла (например, «image/jpeg»)
length:размер в байтах
md5hash:хеш md5 от содержимого
url:полный урл до файла

Места