Войти в ЛК

Аутентификация

OAuth2 авторизация, получение access_token и управление сессиями API

Для работы с API GuestMe используется протокол OAuth 2.0 с типом авторизации client_credentials. Все запросы к API (кроме получения токена) требуют Bearer-токен в заголовке Authorization.

Получение доступа

Для начала работы с API вам потребуются учётные данные:

  • client_id — идентификатор вашего приложения
  • client_secret — секретный ключ приложения
  • Адрес сервера API

Получение токена

Отправьте POST-запрос на эндпоинт /oauth2/token с заголовком Authorization, содержащим Base64-кодированную строку client_id:client_secret.

Пример запроса

curl -X POST https://backend.guestme.ru/oauth2/token -H "Authorization: Basic base64(client_id:client_secret)" -H "Content-Type: application/x-www-form-urlencoded" -d "grant_type=client_credentials&scope=ROLE_EXTERNAL_INTEGRATION"

Параметры запроса

Параметр

Значение

Описание

grant_type

client_credentials

Тип авторизации OAuth2

scope

ROLE_EXTERNAL_INTEGRATION

Область доступа для внешних интеграций

Ответ

Успешный ответ содержит токен доступа:

Поле

Тип

Описание

access_token

string

JWT-токен для авторизации запросов

token_type

string

Всегда "Bearer"

expires_in

number

Время жизни токена в секундах (599 ≈ 10 минут)

scope

string

ROLE_EXTERNAL_INTEGRATION

Использование токена

Добавляйте токен в заголовок Authorization каждого запроса к API:

Authorization: Bearer eyJhbGciOiJIUzUxMiJ9...

Обновление токена

Токен действителен 10 минут (599 секунд). Рекомендуемая стратегия:

  1. Получите токен при старте приложения
  2. Сохраните токен и время его получения
  3. Перед каждым запросом проверяйте, не истёк ли токен
  4. Если токен истёк — запросите новый