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: управление на webhook-ове

Обновяване на токена

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();
};