Начало работы
Аутентификация
Заголовки Authorization и Workspace, где взять ключ, что означают ответы 403.
Каждый запрос к API должен содержать два заголовка:
| Заголовок | Значение |
|---|---|
Authorization | Bearer <секрет> — секрет ключа API |
Workspace | slug аккаунта, часть адреса страницы онлайн-записи https://widget.booknow.ru/<slug> |
Ключ создаётся в панели BookNow, в разделе Настройки → Разработчикам → Ключи API; подробнее на странице Ключ API. Ключ действует для всего аккаунта: через него доступны все филиалы (локации).
Ответы при ошибке аутентификации
| Код | 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 | объект принадлежит другому аккаунту |
Если аккаунт заблокирован (неоплата или блокировка администратором), на любой запрос возвращается ответ 403 с полем error: company_blocked и текстом Online booking is temporarily unavailable. Причина в этом случае не в ключе: проверьте состояние аккаунта в панели.
Пример
curl https://my.booknow.ru/api/public/v2/locations \
-H "Authorization: Bearer secret_…" \
-H "Workspace: salon-nevsky"