API: web агенты

Общая схема работы

Агент выгружает список доступных событий и размещает у себя на сайте с специальной ссылкой для перехода посетителей для заказа билетов, или с кнопкой вызова виджета для оформления заказа.

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

#ID - идентификатор агента

Для примера можно использовать:

#ID = 22324
#WEB_SITE = https://ticketbest.ru

Для просмотра статистики продаж предоставляется доступ в личный кабинет.

Получение списка событий

URL для запроса:

#WEB_SITE/agent/#ID/yml.xml

Входные параметры (не обязательно):

• genre_id - идентификатор жанра

Формат данных YML:

• В файле сформированы специальные ссылки для отправки посетителей на сайт
• Время запоминания агента в cookie устанавливается индивидуально

Описание полей объекта offer (событие):

• id - идентификатор события
• url - страница на сайте
• price - минимальная стоимость билета
• currencyId - код валюты
• categoryId - идентификатор жанра (может отсутствовать)
• picture - ссылка на изображение
• delivery - возможна ли доставка (всегда = true)
• local_delivery_cost - тоимость доставки курьером
• name - название
• place - место проведения
• date - дата события
• age - возрастное ограничение (может отсутствовать)
• is_premiere - признак премьеры (может отсутствовать)
• description - описание события (не более 350 символов, может отсутствовать)
• widget - ключ для вызова виджета
• is_best - признак популярности
• demand - показатель спроса в зависимости от продаж
• rating - рейтинг на основе отзывов покупателей
• activity - идентификатор и ссылка на мероприятия (группа событий)

Список доступных билетов на событие

URL для запроса:

#WEB_SITE/agent/#ID/tickets?event_id=166130

Описание полей:

• sector - название сектора
• sectorId - идентификатор сектора
• row - номер ряда
• place - номер места (номер ряда и места, только для нумерованных мест)
• price - стоимость билета
• eticket - возможность купить электронный билет
• nofee - возможность купить билет без наценки

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

URL для запроса:

#WEB_SITE/agent/#ID/venue?venue_id=166130

Описание полей:

• id - идентификатор места проведения
• name - название
• coordinates - координаты, разделитель запятая
• address - адрес
• city - название города
• description - описание
• url - страница на сайте

Информация о событии

URL для запроса:

#WEB_SITE/agent/#ID/event?event_id=166130

Описание полей:

• id - идентификатор события
• name - название
• picture - ссылка на изображение
• city - название города
• description - описание
• date - дата события
• venue - название места проведения
• widget - ключ для вызова виджета
• url - страница на сайте
• age - возрастное ограничение