Справочник методов

Полный список методов версии v1. Базовый адрес — https://api.ctickets.ru/v1.

Каталог catalog:read

МетодПутьНазначение
GET/eventsсобытия компании с фильтрами
GET/events/{id}карточка события
GET/events/{id}/categoriesкатегории билетов и цены
GET/sessionsсеансы событий с расписанием
GET/venuesплощадки
GET/citiesгорода

Схемы scheme:read

МетодПутьНазначение
GET/events/{id}/schemeгеометрия зала, ETag
GET/events/{id}/availabilityзанятые и забронированные места
GET/events/{id}/seatsплоский список мест с ценой и статусом
GET/events/{id}/scheme.svgкартинка схемы

Брони orders:write

МетодПутьНазначение
POST/reservationsзабронировать места
GET/reservations/{id}состояние брони
PATCH/reservations/{id}заменить состав брони целиком
DELETE/reservations/{id}снять бронь

Заказы

МетодПутьПравоНазначение
POST/ordersorders:writeоформить заказ
GET/ordersorders:readсписок заказов
GET/orders/{id}orders:readкарточка заказа
GET/orders/{id}/ticketsorders:readбилеты: место, штрихкод, ссылка
POST/orders/{id}/confirmorders:writeподтвердить внешнюю оплату
POST/orders/{id}/cancelorders:writeотменить неоплаченный заказ
POST/orders/{id}/refundorders:writeвозврат полный или по билетам

Штрихкоды и вход

МетодПутьПравоНазначение
GET/events/{id}/barcodesbarcodes:readвыгрузка кодов события
POST/barcodes/scanbarcodes:writeотметить проход
POST/barcodes/scan/batchbarcodes:writeзалить офлайн-сканы пачкой

Адаптер Яндекс Афиши

Живёт на том же домене под префиксом /yaga/v1 и подробно описан в разделе «Яндекс Афиша».

Заголовки

ЗаголовокГдеСмысл
Authorization: Bearerзапросключ приложения
Idempotency-Keyзапрособязателен для создающих запросов
If-None-Matchзапроскеш схемы по ETag
X-RateLimit-Remainingответостаток лимита в минуте
Retry-Afterответ 429через сколько секунд повторить
Вопросы по интеграции — api@ctickets.ru. Ключи и журнал запросов — в кабинете организатора, раздел «API и интеграции».