OAuth 2.0

OAuth 2.0 обеспечивает безопасную аутентификацию на основе токенов для сторонних приложений, которые обращаются к Brevo от имени пользователей.

Обзор процесса OAuth

1. Запрос авторизации: перенаправьте пользователя в Brevo
2. Авторизация пользователя: пользователь выдаёт разрешения
3. Код авторизации: Brevo перенаправляет обратно с кодом
4. Обмен на токен доступа: обменяйте код на токены
5. Доступ к API: используйте токен доступа для запросов

Эндпоинт авторизации

https://app.brevo.com/oauth/authorize?
  response_type=code&
  client_id=YOUR_CLIENT_ID&
  redirect_uri=YOUR_REDIRECT_URI&
  scope=email%20contacts&
  state=random_string

Обмен кода на токен

curl -X POST "https://api.brevo.com/v3/oauth/token" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=authorization_code&code=AUTH_CODE&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET&redirect_uri=YOUR_REDIRECT_URI"

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

const response = await fetch('https://api.brevo.com/v3/account', {
  headers: {
    'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
    'Accept': 'application/json'
  }
});

Области доступа

• email: отправка транзакционных писем
• contacts: управление контактами и списками
• campaigns: создание и отправка кампаний
• sms: отправка SMS-сообщений
• webhooks: управление вебхуками

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

const refreshToken = async () => {
  const response = await fetch('https://api.brevo.com/v3/oauth/token', {
    method: 'POST',
    headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
    body: new URLSearchParams({
      grant_type: 'refresh_token',
      refresh_token: 'YOUR_REFRESH_TOKEN',
      client_id: 'YOUR_CLIENT_ID',
      client_secret: 'YOUR_CLIENT_SECRET'
    })
  });
  return response.json();
};