TicketPrime предоставляет внешний API платформы (Prime API) – программный интерфейс, через который ваш сайт или приложение может получать каталог событий и продавать билеты.
Базовый адрес и документация: https://api.ticketprime.ru.
Что нужно сделать
- Создать продавца с доступом к API – система выдаст токен.
- Передавать токен в заголовке Authorization на каждый запрос.
- Использовать методы Prime API для справочника и продаж.
Что такое внешний API
Prime API – это набор HTTP-методов (/prime/...), через которые доступны:
- Справочники: города, активности (жанры), категории, организаторы, площадки, версии залов, сектора, элементы (места).
- Каталог событий: список событий с фильтрами – город, площадка, активность, категории, организаторы, мероприятия.
- Билеты и схема: сектора версии зала, доступные билеты события с ценой и сервисным сбором.
- Корзина: резерв билетов в сессию, просмотр корзины, снятие резерва.
- Заказы: создание заказа, детали заказа, подтверждение оплаты, отмена, возврат, изменение.
- Электронные билеты: получение PDF с билетами по заказу.
Доступ к API защищен токеном продавца с включенным доступом к API.
Для чего его использовать
- Подключить свой сайт – продавать билеты на собственном сайте или в приложении: показывать афишу, схему зала, оформлять заказы и оплату своими силами.
- Просто афиша на сайте – выгружать события во внешнюю систему.
- Встраиваемый виджет – в ответе с деталями события есть поле widget со ссылкой на виджет события.
- Подключить агентов или билетных операторов.
Как получить токен
Доступ к API дает продавец с включенной галочкой «Доступ к API». Если продавца еще нет, создайте его – как это делается и что означают остальные поля карточки, разобрано в инструкции «Продавцы и доступ к событиям».
- Откройте «Продажи» → «Продавцы» и откройте нужного продавца.
- На вкладке «Основное» включите галочку «Доступ к API».
- Нажмите «Сохранить». После сохранения в карточке появится поле «Токен доступа» – это ваш API-ключ из 40 символов. Рядом кнопка копирования.
Передавайте токен в каждом запросе к API в HTTP-заголовке Authorization, без префикса Bearer:
GET https://api.ticketprime.ru/prime/events Authorization: <ваш_токен_40_символов>
Если токен отсутствует или неверен, API вернет ошибку 401 с сообщением «Доступ запрещен».
⚠️ Токен – это ключ к продажам от вашего имени. Храните его в секрете, не публикуйте в коде фронтенда. Если токен утек, переведите продавца в статус «Удалено» и создайте нового – перевыпуска токена у существующего продавца нет.
Типовой сценарий продажи
- Получить события – /prime/events.
- Выбрать билеты – /prime/tickets.
- Зарезервировать места – /prime/reserve.
- Создать заказ – /prime/booking.
- Продать заказ – /prime/saling.
- Получить электронный билет – /prime/eticket/{orderId}.
Частые вопросы
API возвращает «Доступ запрещен».
Проверьте, что токен передается в заголовке Authorization, продавец в статусе «Активно» и у него включена галочка «Доступ к API».
Метод отвечает, но нужного события в каталоге нет.
Событие может быть закрыто для этого продавца – настройкой самого события или областью доступа в его карточке. Разбор – в инструкции «Продавцы и доступ к событиям».
Где взять ссылку на виджет конкретного события?
В ответе GET /prime/event/{id} есть поле widget. Ссылка отдается, если у продавца включена галочка «Доступ к виджету». Подробнее – в инструкции «Подключение виджета».
Нужно перевыпустить токен.
Отдельной кнопки перевыпуска нет. Переведите продавца в статус «Удалено» и создайте нового – новый токен выдастся автоматически.