Ключ API

Ключ API открывает внешней системе доступ к аккаунту целиком: ко всем локациям, сотрудникам, услугам, записям и клиентам. Создавайте отдельный ключ для каждой интеграции: тогда его можно отозвать, не затрагивая остальные.

Создать ключ

1. Откройте в панели раздел Настройки → Разработчикам → Ключи API.
2. Нажмите Создать ключ и назовите его по интеграции, например «CRM» или «Сайт».
3. Скопируйте секретный токен из таблицы ключей.

Секрет выглядит как secret_… и передаётся в заголовке Authorization: Bearer <секрет>. Права ключа не настраиваются: ключ даёт доступ ко всем методам публичного API.

Slug аккаунта

Второй заголовок, Workspace, — это slug вашего аккаунта. Он виден в адресе страницы онлайн-записи https://widget.booknow.ru/<slug> и в ответе GET /workspace (поле slug). Slug не меняется при переименовании компании.

Проверка

curl https://my.booknow.ru/api/public/v2/ping \
  -H "Authorization: Bearer secret_…" \
  -H "Workspace: ваш-slug"
# {"ping":"pong","version":"v12.113.0"}

Если ключ скомпрометирован

Удалите ключ в панели и создайте новый: прежний ключ перестаёт действовать сразу, запросы с ним получают ответ 403 Bearer token is invalid. Не размещайте секрет в коде сайта и в клиентских приложениях: запросы к API должен выполнять ваш сервер.

Вебхуки

Вебхуки настраиваются в соседнем разделе панели, Настройки → Разработчикам → Вебхуки, или через API. Подробнее в разделе Вебхуки.