Разработка и развёртывание · 5 мин чтения
Для разработчиков: API, вебхуки и embed
Ключи и REST endpoints, подписанные события бронирований и встраиваемый виджет.
BraveDay построен по принципу API-first: интерфейс работает через те же endpoints, которые доступны вам. REST API читает и изменяет бронирования, типы встреч и доступность; вебхуки сообщают о событиях; embed-виджет добавляет бронирование на ваш сайт.
API-ключи
- Откройте Настройки → Для разработчиков и создайте API-ключ.
- Передавайте его как bearer token: Authorization: Bearer <key>.
- Используйте endpoints /api/v1 для бронирований, типов событий, доступности и других данных.
Вебхуки
Зарегистрируйте URL endpoint и подпишитесь на booking.created, booking.rescheduled и booking.cancelled. Каждая доставка подписана HMAC-SHA-256 по телу с временной меткой, как у Stripe. Получатель может проверить подлинность и отклонить повтор. Неудачные доставки повторяются с задержкой, а конечный статус сохраняется.
Встраивание
Добавьте виджет бронирования на свою страницу, чтобы посетители записывались, не уходя с сайта. Публичные страницы бронирования также доступны по обычным URL: на них можно ссылаться или открывать в iframe.
Совет
URL получателей вебхуков проверяются на внутренние диапазоны IP и закрепляются за разрешённым публичным IP, что защищает от DNS rebinding. Redirect не выполняются. Указывайте только endpoints под своим контролем.
Связанные руководства
Хотите попробовать? Начать бесплатно, или открыть все руководства.