Создание API-ключей и вебхуков
Создавайте API-ключи с ограниченными правами для Nola REST API и отправляйте подписанные события бронирований и платежей на свои конечные точки, такие как n8n или Zapier.
API-ключи позволяют скрипту или автоматизации читать и записывать ваши данные через REST API. Вебхуки отправляют события на ваш сервер при совершении действий. Оба раздела находятся в Настройки → Интеграции.
Создание API-ключа
- Откройте Настройки → Интеграции и прокрутите до раздела API-ключи.
- В блоке Новый ключ укажите Имя, поясняющее его назначение, например «n8n workflow».
- Отметьте нужные Права. Выберите хотя бы одно.
- Нажмите Создать.
- Сразу скопируйте ключ из зеленого поля. Он начинается с
oh_live_и показывается только один раз.
Передавайте его в каждом запросе как Authorization: Bearer oh_live_…. Конечные точки, тела запросов и примеры описаны в справочнике по REST API.
| Право | Флажок | Возможности |
|---|---|---|
bookings:read | Бронирования, чтение | Просмотр списка бронирований |
bookings:write | Бронирования, запись | Создание и отмена бронирований |
availability:read | Доступность, чтение | Чтение свободных слотов |
resources:read | Ресурсы, чтение | Просмотр списка ваших ресурсов |
clients:read | Клиенты, чтение | Просмотр списка клиентов |
clients:write | Клиенты, запись | Создание клиентов |
wallet:read | Кошелёк, чтение | Чтение транзакций кошелька |
Каждый ключ может выполнять до 600 запросов в минуту. При превышении лимита API возвращает статус 429.
Управление ключами
В таблице ключей отображаются имя, первые символы, права, Последнее использование и статус каждого ключа. Кнопка Отозвать отключает ключ навсегда. Чтобы изменить права, создайте новый ключ и отзовите старый.
Добавление конечной точки вебхука
- В разделе Настройки → Интеграции перейдите к Вебхуки и найдите блок Новая конечная точка.
- Вставьте свой URL. Это должен быть полный адрес, например
https://your-n8n.example.com/webhook/nola. - Отметьте События, которые хотите получать. Выберите хотя бы одно.
- Нажмите Добавить.
Сейчас Nola отправляет следующие события:
| Событие | Когда отправляется |
|---|---|
booking.created | Бронирование создано онлайн, сотрудником или через API |
booking.updated | Статус бронирования изменился, например на подтверждено или незаезд |
booking.cancelled | Бронирование отменено |
payment.succeeded | Прошел онлайн-платеж |
В списке также доступны extension.offered, extension.accepted и class.enrolled. Вы можете подписаться на них, но Nola их пока не отправляет.
Как работает доставка событий
Каждое событие отправляется запросом POST с телом JSON: event, createdAt и data. Заголовки содержат X-Nola-Event с именем события и X-Nola-Signature в формате t=<timestamp>,v1=<signature>. Подпись представляет собой HMAC-SHA256 от <timestamp>.<body> с использованием секретного ключа конечной точки. Пример проверки подписи приведен в справочнике по REST API. В приложении секретный ключ пока не отображается, поэтому напишите в службу поддержки, если он вам нужен для проверки подписи.
Ваша конечная точка должна отвечать со статусом 2xx. Любой другой ответ считается ошибкой:
- Nola повторяет попытки с увеличивающимся интервалом (до одного часа), максимум до 8 попыток на событие.
- После 20 неудачных попыток подряд конечная точка отключается и получает статус Выключено с указанием количества ошибок. Исправьте работу своего сервера и нажмите Включить. Успешная доставка сбрасывает счетчик.
Тестирование и устранение неполадок
В строке каждой конечной точки доступны следующие действия:
- Отправить тест: появляется сообщение «Test event sent», но тестовое событие (
test.ping) в данный момент не доходит до конечных точек. Для проверки оформите бронирование на своей странице бронирования и проверьте Журнал доставки. - Включить или Выключить: приостанавливайте отправку без удаления конечной точки.
- Журнал доставки: список всех отправок с событием, статусом, кодом ответа, попытками и временем. Для отправок, исчерпавших все попытки, доступна кнопка Повторить.
- Удалить: удаляет конечную точку.
Устаревший URL вебхука
Под списком конечных точек находится поле Устаревший URL вебхука, более старая настройка для одного URL. Она получает неподписанные события бронирований отдельно от ваших конечных точек. Если вы все еще ее используете, перейдите на подписанную конечную точку и очистите это поле.
Связанные статьи
Эта страница была полезной?
Не нашли ответ?
Спросите AI Copilot в Nola или отправьте обращение команде Nola. Человек ответит в течение одного рабочего дня.