Вышел 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 и настроить подключение →

← previous