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: إرسال رسائل SMSwebhooks: إدارة 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();};