أول استدعاء لـ API
لننفّذ أول استدعاء لـ API للتحقّق من أن إعداد Brevo API لديك يعمل بشكل صحيح.
المتطلبات المسبقة
- حساب Brevo
- مفتاح API من لوحة التحكم
- أداة لإجراء طلبات HTTP (curl أو Postman أو ما شابه)
جلب معلومات الحساب
أبسط استدعاء أول هو جلب معلومات حسابك:
باستخدام cURL
curl -X GET "https://api.brevo.com/v3/account" \ -H "Accept: application/json" \ -H "api-key: YOUR_API_KEY"باستخدام JavaScript (Node.js)
const fetch = require('node-fetch');
const getAccount = async () => { try { const response = await fetch('https://api.brevo.com/v3/account', { method: 'GET', headers: { 'Accept': 'application/json', 'api-key': 'YOUR_API_KEY' } });
const data = await response.json(); console.log('Account Info:', data); } catch (error) { console.error('Error:', error); }};
getAccount();باستخدام Python
import requests
url = "https://api.brevo.com/v3/account"headers = { "Accept": "application/json", "api-key": "YOUR_API_KEY"}
response = requests.get(url, headers=headers)print(response.json())باستخدام PHP
<?php$url = 'https://api.brevo.com/v3/account';$headers = [ 'Accept: application/json', 'api-key: YOUR_API_KEY'];
$ch = curl_init();curl_setopt($ch, CURLOPT_URL, $url);curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);curl_close($ch);
echo $response;?>الاستجابة المتوقّعة
إذا نجح الاستدعاء، فستتلقّى استجابة مثل هذه:
{ "firstName": "John", "lastName": "Doe", "companyName": "Your Company", "address": { "street": "123 Main Street", "city": "New York", "zipCode": "10001", "country": "United States" }, "plan": [ { "type": "payAsYouGo", "credits": 10000, "creditsUsed": 1500 } ]}معالجة الأخطاء
إذا واجهت أخطاء، فتحقّق من هذه المشكلات الشائعة:
مفتاح API غير صالح (401 Unauthorized)
{ "code": "unauthorized", "message": "Invalid API key provided"}الحل: تحقّق من أن مفتاح API صحيح ويملك الأذونات المناسبة.
تجاوز حد معدل الطلبات (429 Too Many Requests)
{ "code": "too_many_requests", "message": "Rate limit exceeded"}الحل: انتظر قبل إجراء طلب آخر أو رقِّ خطّتك.
خطأ في الخادم (500 Internal Server Error)
{ "code": "internal_error", "message": "An internal error occurred"}الحل: راجع صفحة الحالة أو تواصل مع الدعم.
الخطوات التالية
الآن بعد أن نفّذت أول استدعاء ناجح لـ API: