Брони

Создать бронь #

Доступ: Токен игрока Заголовок Authorization: Bearer <токен игрока> — токен по SMS-входу.

Бронирует корт на слот от имени игрока с оплатой из его кошелька. Корт можно указать в court_id, иначе берётся любой свободный. Сначала проверяются правила клуба для игрока (глубина брони, лимиты в день и активных), затем занятость, затем цена с учётом категории клиента и промокода, затем баланс. Одновременная бронь одного корта двумя игроками приводит к 409 slot_taken у второго.

Заголовки

Тело запроса application/json

Пример запроса

curl -X POST "https://адрес-вашего-сервера/api/v1/bookings" \
  -H "Authorization: Bearer <токен игрока>" \
  -H "Content-Type: application/json" \
  -d '{"club_id": "c1", "day": "2026-10-03", "time": "18:00"}'

Ответы

Пример ответа

{
  "id": "b71c2e94-0a3f-4d58-8e26-9f1d3c5a7b40",
  "clubId": "c1",
  "club": "Флэйм Падел",
  "court": "Корт 4",
  "day": "2026-10-03",
  "time": "18:00",
  "durationMin": 90,
  "price": 3500,
  "status": "confirmed"
}

Мои брони #

Доступ: Токен игрока Заголовок Authorization: Bearer <токен игрока> — токен по SMS-входу.

Последние 50 броней игрока, новые первыми, с долями разделённой оплаты.

Заголовки

Пример запроса

curl -X GET "https://адрес-вашего-сервера/api/v1/bookings/my" \
  -H "Authorization: Bearer <токен игрока>"

Ответы

Пример ответа

{
  "items": [
    {
      "id": "b71c2e94-0a3f-4d58-8e26-9f1d3c5a7b40",
      "clubId": "c1",
      "club": "Флэйм Падел",
      "court": "Корт 4",
      "day": "2026-10-03",
      "time": "18:00",
      "durationMin": 90,
      "price": 3500,
      "status": "confirmed",
      "splits": [{"name": "Анна С.", "amount": 875, "status": "pending"}]
    }
  ]
}

Отменить бронь #

Доступ: Токен игрока Заголовок Authorization: Bearer <токен игрока> — токен по SMS-входу.

Отменяет свою бронь. Если до начала осталось не меньше окна бесплатной отмены клуба (с учётом категории клиента), стоимость возвращается на кошелёк, иначе refund=0. Освободившийся слот предлагается первому в листе ожидания.

Параметры пути

Заголовки

Пример запроса

curl -X POST "https://адрес-вашего-сервера/api/v1/bookings/b71c2e94-0a3f-4d58-8e26-9f1d3c5a7b40/cancel" \
  -H "Authorization: Bearer <токен игрока>"

Ответы

Пример ответа

{"ok": true, "refund": 3500}

Перенести бронь #

Доступ: Токен игрока Заголовок Authorization: Bearer <токен игрока> — токен по SMS-входу.

Переносит свою бронь на другой слот того же клуба. Разница цены списывается с кошелька или возвращается на него.

Параметры пути

Заголовки

Тело запроса application/json

Пример запроса

curl -X POST "https://адрес-вашего-сервера/api/v1/bookings/b71c2e94-0a3f-4d58-8e26-9f1d3c5a7b40/reschedule" \
  -H "Authorization: Bearer <токен игрока>" \
  -H "Content-Type: application/json" \
  -d '{"day": "2026-10-04", "time": "19:30"}'

Ответы

Пример ответа

{
  "id": "b71c2e94-0a3f-4d58-8e26-9f1d3c5a7b40",
  "clubId": "c1",
  "club": "Флэйм Падел",
  "court": "Корт 4",
  "day": "2026-10-04",
  "time": "19:30",
  "durationMin": 90,
  "price": 3500,
  "status": "confirmed"
}

Правила брони для меня в этом клубе #

Доступ: Токен игрока Заголовок Authorization: Bearer <токен игрока> — токен по SMS-входу.

Правила брони клуба для этого игрока с учётом его категории: глубина брони в днях, окно бесплатной отмены в часах, лимиты в день и активных броней.

Параметры запроса

Заголовки

Пример запроса

curl -X GET "https://адрес-вашего-сервера/api/v1/bookings/rules?club_id=c1" \
  -H "Authorization: Bearer <токен игрока>"

Ответы

Пример ответа

{
  "depthDays": 14,
  "cancelFreeHours": 24,
  "maxPerDay": 0,
  "maxActive": 0,
  "category": null,
  "categoryId": null,
  "overridden": []
}

Проверка промокода #

Доступ: Токен игрока Заголовок Authorization: Bearer <токен игрока> — токен по SMS-входу.

Что даст промокод на слот: цена, скидка, к оплате. Ничего не бронирует. Если код не подходит — ответ 4xx с причиной в detail.

Параметры запроса

Заголовки

Пример запроса

curl -X GET "https://адрес-вашего-сервера/api/v1/promo/check?club_id=c1&code=AUTUMN10&day=2026-10-03&at=18:00" \
  -H "Authorization: Bearer <токен игрока>"

Ответы

Пример ответа

{"code": "AUTUMN10", "price": 3500, "discount": 350, "total": 3150, "note": ""}

Встать в очередь на занятый слот #

Доступ: Токен игрока Заголовок Authorization: Bearer <токен игрока> — токен по SMS-входу.

Встать в очередь на слот, где заняты все корты. Когда бронь на этот слот отменят, уведомление получит только первый в очереди. Повторное нажатие не создаёт вторую запись. В ответе — место в очереди.

Заголовки

Тело запроса application/json

Пример запроса

curl -X POST "https://адрес-вашего-сервера/api/v1/bookings/waitlist" \
  -H "Authorization: Bearer <токен игрока>" \
  -H "Content-Type: application/json" \
  -d '{"club_id": "c1", "day": "2026-10-03", "time": "18:00"}'

Ответы

Пример ответа

{"ok": true, "id": "5a3c7e19-2b8d-4f60-9e1a-c4d7b2f8e053", "position": 1}

Мой лист ожидания #

Доступ: Токен игрока Заголовок Authorization: Bearer <токен игрока> — токен по SMS-входу.

Записи игрока в листах ожидания на сегодня и позже: ждёт (waiting) или уже уведомлён (notified).

Заголовки

Пример запроса

curl -X GET "https://адрес-вашего-сервера/api/v1/bookings/waitlist/my" \
  -H "Authorization: Bearer <токен игрока>"

Ответы

Пример ответа

{
  "items": [
    {
      "id": "5a3c7e19-2b8d-4f60-9e1a-c4d7b2f8e053",
      "clubId": "c1",
      "club": "Флэйм Падел",
      "day": "2026-10-03",
      "time": "18:00",
      "status": "waiting"
    }
  ]
}

Выйти из листа ожидания #

Доступ: Токен игрока Заголовок Authorization: Bearer <токен игрока> — токен по SMS-входу.

Отменяет свою запись в листе ожидания.

Параметры пути

Заголовки

Пример запроса

curl -X POST "https://адрес-вашего-сервера/api/v1/bookings/waitlist/5a3c7e19-2b8d-4f60-9e1a-c4d7b2f8e053/cancel" \
  -H "Authorization: Bearer <токен игрока>"

Ответы

Пример ответа

{"ok": true}

Разделить оплату брони #

Доступ: Токен игрока Заголовок Authorization: Bearer <токен игрока> — токен по SMS-входу.

Автор брони делит стоимость с одним–тремя игроками: каждому уходит запрос на долю, равную цене, делённой на число участников вместе с автором (с округлением вниз). Повторный запрос тому же игроку — 409.

Параметры пути

Заголовки

Тело запроса application/json

Пример запроса

curl -X POST "https://адрес-вашего-сервера/api/v1/bookings/b71c2e94-0a3f-4d58-8e26-9f1d3c5a7b40/split" \
  -H "Authorization: Bearer <токен игрока>" \
  -H "Content-Type: application/json" \
  -d '{"user_ids": ["a52e7c14-90bd-4e3f-8c61-7d2f0b9e4a15"]}'

Ответы

Пример ответа

{"ok": true, "share": 875, "requests": 3}

Мои доли к оплате #

Доступ: Токен игрока Заголовок Authorization: Bearer <токен игрока> — токен по SMS-входу.

Неоплаченные запросы на долю, адресованные игроку.

Заголовки

Пример запроса

curl -X GET "https://адрес-вашего-сервера/api/v1/bookings/splits/my" \
  -H "Authorization: Bearer <токен игрока>"

Ответы

Пример ответа

{
  "items": [
    {
      "id": "9b1e4d72-3c6a-4f85-a0d2-7e3b9c1f5a64",
      "club": "Флэйм Падел",
      "day": "2026-10-03",
      "time": "18:00",
      "amount": 875
    }
  ]
}

Оплатить свою долю #

Доступ: Токен игрока Заголовок Authorization: Bearer <токен игрока> — токен по SMS-входу.

Игрок оплачивает свою долю из кошелька — деньги переводятся автору брони.

Параметры пути

Заголовки

Пример запроса

curl -X POST "https://адрес-вашего-сервера/api/v1/bookings/splits/9b1e4d72-3c6a-4f85-a0d2-7e3b9c1f5a64/accept" \
  -H "Authorization: Bearer <токен игрока>"

Ответы

Пример ответа

{"ok": true}

Инвентарь напрокат в клубе #

Доступ: Токен игрока Заголовок Authorization: Bearer <токен игрока> — токен по SMS-входу.

Инвентарь клуба напрокат: цена за выдачу и сколько единиц свободно прямо сейчас.

Параметры запроса

Заголовки

Пример запроса

curl -X GET "https://адрес-вашего-сервера/api/v1/bookings/rental?club_id=c1" \
  -H "Authorization: Bearer <токен игрока>"

Ответы

Пример ответа

{
  "items": [
    {
      "id": "c9d4e2a7-1f83-4a6b-b0c5-3e7d9a1f2b58",
      "name": "Ракетка",
      "price": 500,
      "available": 6
    }
  ]
}

Добавить инвентарь к своей броне #

Доступ: Токен игрока Заголовок Authorization: Bearer <токен игрока> — токен по SMS-входу.

Добавляет инвентарь (1–4 единицы) к своей активной брони, пока игра не закончилась. Стоимость списывается с кошелька.

Параметры пути

Заголовки

Тело запроса application/json

Пример запроса

curl -X POST "https://адрес-вашего-сервера/api/v1/bookings/b71c2e94-0a3f-4d58-8e26-9f1d3c5a7b40/rental" \
  -H "Authorization: Bearer <токен игрока>" \
  -H "Content-Type: application/json" \
  -d '{"item_id": "c9d4e2a7-1f83-4a6b-b0c5-3e7d9a1f2b58", "qty": 2}'

Ответы

Пример ответа

{
  "ok": true,
  "id": "4e8a2c61-7d9b-4f03-b5e1-2a6c8d0f4b97",
  "charged": 1000,
  "available": 4
}

Что уже взято на эту бронь #

Доступ: Токен игрока Заголовок Authorization: Bearer <токен игрока> — токен по SMS-входу.

Что уже взято на эту бронь и возвращено ли.

Параметры пути

Заголовки

Пример запроса

curl -X GET "https://адрес-вашего-сервера/api/v1/bookings/b71c2e94-0a3f-4d58-8e26-9f1d3c5a7b40/rental" \
  -H "Authorization: Bearer <токен игрока>"

Ответы

Пример ответа

{
  "items": [
    {
      "id": "4e8a2c61-7d9b-4f03-b5e1-2a6c8d0f4b97",
      "name": "Ракетка",
      "qty": 2,
      "price": 1000,
      "returned": false
    }
  ]
}

QR брони для стойки проката #

Доступ: Токен игрока Заголовок Authorization: Bearer <токен игрока> — токен по SMS-входу.

QR брони для стойки проката. Показывается и без заказанного инвентаря: по нему стойка может выдать инвентарь на месте.

Параметры пути

Заголовки

Пример запроса

curl -X GET "https://адрес-вашего-сервера/api/v1/bookings/b71c2e94-0a3f-4d58-8e26-9f1d3c5a7b40/rental-pass" \
  -H "Authorization: Bearer <токен игрока>"

Ответы

Пример ответа

{"qr": "<код QR>", "items": [], "status": "empty", "waiting": 0}