OAuth 2.0
OAuth 2.0 は、ユーザーに代わって Brevo にアクセスするサードパーティアプリケーションに、トークンベースの安全な認証を提供します。
OAuth フローの概要
- 認可リクエスト: ユーザーを Brevo にリダイレクトします
- ユーザーによる認可: ユーザーが権限を許可します
- 認可コード: Brevo がコードを付けてリダイレクトします
- アクセストークンの交換: コードをトークンと交換します
- 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();};