اطلب الوصول المبكر

أدخل اسمك الأول وبريدك الإلكتروني أو رقم هاتفك. سنتواصل معك لتزويدك بتفاصيل الوصول إلى Tajo.

أول استدعاء لـ API

لننفّذ أول استدعاء لـ API للتحقّق من أن إعداد Brevo API لديك يعمل بشكل صحيح.

المتطلبات المسبقة

  • حساب Brevo
  • مفتاح API من لوحة التحكم
  • أداة لإجراء طلبات HTTP (curl أو Postman أو ما شابه)

جلب معلومات الحساب

أبسط استدعاء أول هو جلب معلومات حسابك:

باستخدام cURL

Terminal window
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;
?>

الاستجابة المتوقّعة

إذا نجح الاستدعاء، فستتلقّى استجابة مثل هذه:

{
"email": "[email protected]",
"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:

  1. أعدّ المصادقة بشكل صحيح
  2. ثبّت حزمة SDK للغتك
  3. تعرّف على حدود معدل الطلبات
  4. استكشف نقاط نهاية البريد الإلكتروني

اطلب الوصول المبكر

أدخل اسمك الأول وبريدك الإلكتروني أو رقم هاتفك. سنتواصل معك لتزويدك بتفاصيل الوصول إلى Tajo.

اكتشاف تلقائي
مساعد AI

مرحباً! اسألني أي شيء عن الوثائق.