Начало работы
Аутентификация
Заголовки Authorization и Workspace, где взять ключ, что означают ответы 403.
Каждый запрос к API несёт два заголовка:
| Заголовок | Значение |
|---|---|
Authorization | Bearer <секрет> — секрет ключа API |
Workspace | slug аккаунта, часть адреса панели <slug>.booknow.ru |
Ключ создаётся в панели BookNow, раздел Интеграции. Секрет показывается один раз при создании. Ключ привязан к аккаунту целиком: через него доступны все филиалы (локации) аккаунта.
Ответы при ошибке аутентификации
| Код | message | Причина |
|---|---|---|
| 403 | Workspace header is missing | нет заголовка Workspace |
| 403 | Bearer token is missing | нет заголовка Authorization |
| 403 | Bearer token is invalid | секрет не найден или не относится к этому workspace |
| 403 | You don't have permission to access this location | объект принадлежит другому аккаунту |
Если аккаунт заблокирован, API отвечает ошибкой блокировки на любой запрос.
Пример
curl https://my.booknow.ru/api/public/v2/locations \
-H "Authorization: Bearer sk_live_…" \
-H "Workspace: salon-nevsky"