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:发送短信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();};