С чего начать

API CTickets отдаёт афишу, схемы залов и позволяет продавать билеты из вашей витрины. Все данные ограничены компанией, которой принадлежит ключ: чужие события через ваш ключ недоступны.

Как устроена продажа

1. Берёте события компании: GET /v1/events.
2. Для события со схемой — геометрию GET /v1/events/{id}/scheme и занятость GET /v1/events/{id}/availability.
3. Держите выбранные места: POST /v1/reservations. Бронь живёт у нас, поэтому два партнёра не продадут одно место.
4. Оформляете заказ: POST /v1/orders.
5. Деньги принимаем мы (ведёте покупателя на payment_url) либо принимаете вы — тогда POST /v1/orders/{id}/confirm.
6. Забираете билеты: GET /v1/orders/{id}/tickets.

Первый запрос

curl -s https://api.ctickets.ru/v1/events \
  -H "Authorization: Bearer <ваш ключ>"

Ответ приходит в конверте: полезные данные в data, идентификатор запроса — в request_id. Его стоит логировать: по нему мы найдём ваш запрос в журнале за секунды.

{
  "data": [ { "id": 145, "title": "Тестовое событие", ... } ],
  "meta": { "current_page": 1, "per_page": 50, "total": 3 },
  "request_id": "req_01kz47hd88r5hvhewbf84qsrxj"
}

Что важно знать сразу

• Деньги — в копейках. {"amount": 300000, "currency": "RUB"} — это 3000 ₽. Так не теряется копейка на округлениях.
• Схема отдельно, занятость отдельно. Геометрия зала большая и меняется редко — кешируйте её по ETag. Занятость лёгкая, её можно опрашивать часто.
• Записи идемпотентны. Каждый POST, создающий что-то, требует заголовок Idempotency-Key.
• Начинайте с песочницы. Ключ песочницы работает с теми же событиями, но его заказы не попадают в отчётность организатора.