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. Ссылка отдается, если у продавца включена галочка «Доступ к виджету». Подробнее — в инструкции «Подключение виджета».
Нужно перевыпустить токен.
Отдельной кнопки перевыпуска нет. Переведите продавца в статус «Удалено» и создайте нового — новый токен выдастся автоматически.