Системы бронирования клуба
Связки с системами бронирования, которыми клубы уже пользуются: бронь в системе клуба сама занимает корт в AISOLUS, включает запись и подсчёт по её времени, а ролики и статистика приходят игрокам.
Статусы честные. «Готово к подключению» — связка сделана и проверена автоматическими тестами, но ещё не включена ни в одном клубе: её включают ключом доступа клуба. «В разработке» — связки пока нет. YCLIENTS и Playtomic облако само опрашивает по ключу клуба; MATCHi сам присылает облаку события о бронях — для этого есть метод приёма событий MATCHi.
Как это работает
- Чтение броней из системы клуба: корт, время начала и конца, состав — по ключу доступа, который выдаёт клуб. Корт системы сопоставляется с кортом AISOLUS вручную или по названию.
- Бронь занимает корт и у нас: корт не продастся дважды. Отменили бронь — снимается и у нас, перенесли — переезжает, слот уже занят — запись в журнал конфликтов.
- Запись и подсчёт: сервер корта сам начинает и заканчивает запись по времени брони, без кнопок на корте.
- Ролики игрокам: хайлайты, статистика и разбор — в приложение AISOLUS Падел или по QR-коду на корте.
YCLIENTS
Готово к подключению
Записи клуба из YCLIENTS переносятся в брони AISOLUS: корт и время; клиент YCLIENTS заводится у нас отдельной записью для пары клуб и клиент, его телефон не привязывает бронь к чужому игроку. Включается в панели клуба, раздел «Подключить сервис»: клуб вводит свой ключ пользователя YCLIENTS и номер филиала. Со стороны платформы нужен партнёрский ключ разработчика YCLIENTS — его оформляет AISOLUS один раз для всех клубов.
Playtomic
Готово к подключению
Брони кортов из Playtomic переносятся в брони AISOLUS через открытый API Playtomic для сторонних систем. Ключи клуб получает сам в Playtomic Manager (настройки → API), партнёрство не нужно; вводятся в панели клуба. У Playtomic нет телефонов игроков — игрок брони заводится у нас по его номеру участника и узнаётся при следующих бронях.
1С:Фитнес клуб
Готово к подключению
Брони кортов из конфигурации 1С:Фитнес клуб читает сервер корта внутри сети клуба: доступ к 1С не уходит в интернет, в облако передаются только корт, время и номер брони. Настраивается на сервере корта (страница настройки 1С, доступна из сети клуба по PIN). Приём платежей из 1С на кошелёк игрока — отдельная связка, см. «Интеграция с 1С».
MATCHi
Готово к подключению
MATCHi не отдаёт брони по запросу — он сам присылает события: бронь создана, перенесена, отменена (Matchi Event Portal, версии событий V1 и V2). Каждое событие сразу создаёт, переносит или отменяет бронь корта в AISOLUS: корт не продаётся дважды, запись на корте включается по брони, ролики и статистика уходят игрокам.
- Подлинность. Событие принимается, только если подпись в заголовке
x-matchi-signature(HMAC-SHA256 тела секретом подписки) сходится с секретом клуба. Повтор доставки с тем же номером события второй раз не выполняется. - Корты. Корт MATCHi сопоставляется с кортом клуба по названию («Court 1», «Bana 1» и «Корт 1» — один корт) или вручную в панели клуба: корты MATCHi появляются там с первыми бронями.
- Время и игроки. Время MATCHi приходит по UTC и переводится в часы клуба. Игрок — отдельная запись игрока MATCHi по его номеру клиента в MATCHi: телефон в MATCHi не подтверждён, поэтому бронь не привязывается к чужому аккаунту по номеру.
- Конфликт. Если слот уже занят бронью AISOLUS, бронь MATCHi не перезаписывает её — она попадает в журнал конфликтов панели клуба.
Подключение: подписку на события о бронях оформляет поддержка MATCHi по запросу AISOLUS и выдаёт секрет подписки; клуб вписывает его и ID клуба в MATCHi в панели клуба, раздел «Интеграция с MATCHi», и включает связь. Описание метода — в справочнике API и в Swagger.
Что понадобится от клуба
- Ключ доступа к системе бронирования для чтения броней (где его взять — в разделе вашей системы выше).
- Список кортов в системе бронирования и соответствие кортам с камерами AISOLUS.
- Согласие игроков на получение роликов — в правилах клуба или при брони.
- Контакт технического специалиста клуба.
Как подключить
Обратитесь к администратору вашей платформы: название клуба, город, какой системой бронирования пользуетесь, сколько кортов и есть ли на них камеры AISOLUS. Для YCLIENTS, Playtomic и 1С:Фитнес клуб подключение — настройка ключей в панели клуба; для MATCHi — подписка на события через поддержку MATCHi и секрет подписки в панели клуба.