Вышел API календаря ваше приложение и CRM работают с одним расписанием
Гость выбирает праздник в вашем приложении, вносит предоплату — и только потом узнаёт, что нужное время уже занято в CRM. Чтобы проверять расписание до оплаты, мы выпустили API доступности календаря LASERWAR CRM.
Теперь ваш сайт, мобильное приложение или микросервис может получать из CRM свободные дни и конкретные интервалы. Администратор продолжает работать в привычном календаре, а внешняя программа использует его данные о загрузке. Для соединения разработчик добавляет модуль интеграции; сама по себе установка двух программ их ещё не связывает.
Две программы — одно расписание клуба
Представьте: сотрудники принимают звонки и создают заявки в CRM, а гости выбирают время на вашем сайте. Приложение запрашивает доступность с учётом площадки, длительности и числа гостей. Если подходящих интервалов на день нет, этот день можно сделать недоступным для выбора ещё до перехода к оплате.
API учитывает обычные заявки и новые сборные игры, рабочие часы и дни, перерывы, отмены и активные удержания для оплаты. На площадке, где разрешены два параллельных мероприятия, одна запись не закрывает всё время: учитывается оставшаяся одновременная вместимость.
Где это пригодится
- Форма предоплаты. Сначала предложить подходящее время и повторно проверить весь интервал перед оплатой, а не выяснять занятость после поступления денег.
- Собственный сайт или приложение. Сохранить свой дизайн и сценарий оформления, получая актуальную доступность из CRM.
- Несколько сервисов клуба. Разным приложениям можно выдать отдельные ключи одного клуба, чтобы они обращались к общему календарю.
- Автоматизация и помощники. Предложить гостю ближайшие свободные варианты или подключить к календарю собственный серверный сервис.
- Анализ свободных окон. Использовать доступные интервалы в своём экране планирования. Это данные о будущей доступности; выручку, историю платежей и готовые аналитические отчёты этот API не выгружает.
Выберите подходящий сценарий оплаты
| Сценарий | Как работает |
|---|---|
| Оплата остаётся в вашей программе | Ваш сервер получает свободное время и проверяет его перед платежом. Между проверкой и внешней оплатой время ещё может занять другой посетитель: чтение календаря место не удерживает. |
| Удержание и оплата через CRM | CRM атомарно проверяет и временно удерживает интервал, затем выдаёт платёжную ссылку. После подтверждения банка появляется оплаченная заявка. Нужны право предоплат у ключа и настроенная онлайн-оплата CRM. |
После запуска платежа закрытие банковской страницы не означает отмену: место удерживается до подтверждённого результата банка. У текущего API нет команды, которая подтверждает произвольный платёж, проведённый сторонней программой.
Как подключить свой сервис: 5 шагов
- Войдите владельцем клуба. Откройте раздел «API календаря» в настройках. Прямой путь на поддомене вашего клуба:
/settings/calendar-api/index. - Проверьте расписание. Рабочие дни, часы, перерывы и шаг задаются в общих настройках; в API выберите часовой пояс и при необходимости лимиты гостей площадок.
- Включите API и создайте ключ. Для начала достаточно «Только доступность». Полностью ключ показывается один раз — сохраните его в секретах сервера приложения.
- Передайте разработчику инструкцию и OpenAPI. Укажите адрес клуба, длительность мероприятий, число гостей и соответствие услуг площадкам. Пароль CRM передавать не нужно.
- Проверьте соединение. Приложение должно показывать только возвращённые слоты, обновлять их при изменении параметров и обрабатывать занятость и ошибки. Тестовые удержания и игры проверяйте на согласованном демо-клубе.
Можно передать задачу своему ИИ
Мы подготовили готовое техническое задание: его можно прикрепить к чату с ИИ вместе с исходным кодом вашего приложения. В документе есть архитектура модуля, маршруты, примеры JSON, обработка ошибок и критерии готовности. OpenAPI помогает ИИ использовать реальный контракт, а не придумывать команды.
Скачать инструкцию и задание для ИИ Скачать OpenAPI
Владельцу нужно только указать свой адрес клуба и настройки, а ключ разместить на backend. Секрет нельзя включать в публичный JavaScript, мобильную сборку или URL. Документы для скачивания не содержат настоящих ключей.
Коротко для разработчика
Базовый адрес: https://<ваш-клуб>.laserwar.club/api/v1
Авторизация: Authorization: Bearer <ключ>
GET /availability/venues — площадки
GET /availability — свободные дни и интервалы
POST /availability/check — повторная проверка
Один запрос охватывает до 31 дня в пределах ближайших 365 дней. Даты и время относятся к часовому поясу клуба. Лимит — 120 запросов в минуту на ключ. При недоступности CRM приложение должно предложить повторить запрос, а не показывать неизвестное время как свободное.
Результат не подтверждает наличие свободного инструктора или ещё не назначенного оборудования. Соответствие площадки конкретной услуге задаётся правилами вашего бизнеса. Подробный контракт и платёжный сценарий доступны во вложенной инструкции и в CRM по пути /settings/calendar-api/docs.
API уже доступен в LASERWAR CRM. Он выключен до явного включения владельцем, поэтому действующие клубы продолжают работать со своими настройками. Открыть CRM и настроить подключение →
