في المشهد المتطور بسرعة للتواصل عبر البريد الإلكتروني، Mailgun تبرز كحل قوي لواجهة برمجة التطبيقات للأعمال التي تسعى إلى تبسيط عمليات تسليم البريد الإلكتروني الخاصة بها. مع مجموعة ميزاتها الواسعة، وأسعارها التنافسية، وقدرات التكامل السلسة، أصبحت واجهة برمجة تطبيقات Mailgun الخيار المفضل للمطورين والشركات على حد سواء.
في هذه المقالة الشاملة، سنتناول تفاصيل واجهة برمجة تطبيقات Mailgun، نستكشف وظائفها الرئيسية، وهيكل التسعير، وخيارات النشر. علاوة على ذلك، سنقدم دليلًا خطوة بخطوة حول كيفية اختبار واجهة برمجة تطبيقات Mailgun بفعالية باستخدام منصة Apidog سهلة الاستخدام.
مقدمة عن Mailgun: تمكين التواصل عبر البريد الإلكتروني
Mailgun هي خدمة رائدة في أتمتة البريد الإلكتروني تمكّن الأعمال من إرسال واستقبال وتتبع رسائل البريد الإلكتروني بسهولة. تأسست في عام 2010، وقد رسخت Mailgun مكانتها كحل موثوق وقابل للتوسع لإدارة التواصل عبر البريد الإلكتروني. بفضل واجهتها القوية، تمكّن Mailgun المطورين من دمج وظيفة البريد الإلكتروني في تطبيقاتهم بسلاسة.
ما هي واجهة برمجة تطبيقات Mailgun؟
في جوهر عروض Mailgun تكمن واجهتها القوية. واجهة برمجة تطبيقات Mailgun تقدم مجموعة شاملة من النقاط النهائية والوظائف التي تتيح للمطورين التفاعل مع خدمة البريد الإلكتروني برمجيًا. من إرسال رسائل البريد الإلكتروني المعاملات إلى إدارة قوائم البريد الإلكتروني وتتبع أحداث البريد الإلكتروني، تقدم واجهة برمجة تطبيقات Mailgun مجموعة واسعة من الإمكانيات.
الوظائف الرئيسية لواجهة برمجة تطبيقات Mailgun: الإرسال، التتبع، والمزيد
تتميز واجهة برمجة تطبيقات Mailgun بمجموعة مثيرة من الوظائف التي تلبي احتياجات التواصل عبر البريد الإلكتروني المختلفة. تشمل بعض القدرات الرئيسية:
- إرسال رسائل البريد الإلكتروني: مع واجهة برمجة تطبيقات Mailgun، يمكن للمطورين بسهولة إرسال رسائل البريد الإلكتروني المعاملات ورسائل البريد الإلكتروني الجماعية برمجيًا. تدعم الواجهة تنسيقات البريد الإلكتروني المختلفة، بما في ذلك النص العادي وHTML، وتسمح بالتخصيص والمحتوى الديناميكي.
- تتبع البريد الإلكتروني: توفر Mailgun قدرات تتبع بريد إلكتروني شاملة، مما يمكّن الأعمال من مراقبة حالة التسليم، والافتتاحات، والنقرات، ونسب الارتداد لرسائل البريد الإلكتروني المرسلة. تساعد هذه البيانات القيمة في تحسين حملات البريد الإلكتروني وتحسين إمكانية التسليم.
- إدارة قوائم البريد الإلكتروني: تتيح الواجهة إدارة سلسة للقوائم البريدية، بما في ذلك إضافة وإزالة وتقسيم المشتركين. هذه الميزة مفيدة بشكل خاص للأعمال التي لديها قواعد مشتركة كبيرة.
- معالجة البريد الإلكتروني الوارد: تعمل وظيفة البريد الإلكتروني الوارد في Mailgun على تمكين التطبيقات من استقبال ومعالجة رسائل البريد الإلكتروني الواردة. هذا يفتح إمكانيات لإنشاء سير عمل وأتمتة قائمة على البريد الإلكتروني.
تسعير واجهة برمجة تطبيقات Mailgun
تقدم Mailgun خطط تسعير مرنة لتناسب احتياجات الأعمال المختلفة:
الخطة المجانية
- السعر: 0 دولار/شهر
- البريد الإلكتروني المضمن: 100 بريد إلكتروني/يوم
- الميزات:
- دعم التذاكر
- واجهات برمجة تطبيقات البريد الإلكتروني RESTful وإعادة توجيه SMTP
- نطاق إرسال مخصص واحد
- مفتاح API واحد
- تحليلات البريد الإلكتروني وإعداد التقارير
- احتفاظ بالسجلات لمدة يوم واحد
- مسار وارد واحد
الخطة الأساسية
- السعر: 15 دولار/شهر
- البريد الإلكتروني المضمن: 10,000 بريد إلكتروني/شهر
- الميزات:
- الميزات:
- لا توجد حد يومي للبريد الإلكتروني
- خيارات تجاوز البريد الإلكتروني الشهري
- واجهات برمجة تطبيقات البريد الإلكتروني RESTful وإعادة توجيه SMTP
- نطاق إرسال مخصص واحد
- مفتاح API واحد
- تحليلات البريد الإلكتروني وإعداد التقارير
- احتفاظ بالسجلات لمدة يوم واحد
- مسار وارد واحد
- البريد الإلكتروني الإضافي: من 1.80 دولار/1,000 بريد إلكتروني
خطة المؤسسة
- السعر: 35 دولار/شهر
- البريد الإلكتروني المضمن: 50,000 بريد إلكتروني/شهر
- الميزات:
- كل شيء في الخطة الأساسية بالإضافة إلى:
- وصول كامل إلى واجهات برمجة تطبيقات البريد الإلكتروني RESTful وإعادة توجيه SMTP
- 1,000 نطاق إرسال مخصص
- منشئ نماذج البريد الإلكتروني وواجهة برمجة التطبيقات
- التتبع، والتحليلات، والويبهوكس
- احتفاظ بالسجلات لمدة 5 أيام
- احتفاظ بالرسائل لمدة يوم واحد
- وصول كامل إلى التوجيه الوارد
- البريد الإلكتروني الإضافي والتحقق:
- من 1.30 دولار/1,000 بريد إلكتروني
- من 1.20 دولار/100 تحقق
خطة التوسع
- السعر: 90 دولار/شهر
- البريد الإلكتروني المضمن: 100,000 بريد إلكتروني/شهر
- الميزات:
- كل شيء في خطة المؤسسة بالإضافة إلى:
- SAML SSO
- 5,000 تحقق من البريد الإلكتروني
- مجموعة عنوان IP مخصصة
- تحسين وقت الإرسال
- دعم مباشر عبر الهاتف والدردشة
- احتفاظ بالسجلات لمدة 30 يومًا
- ما يصل إلى 7 أيام من الاحتفاظ بالرسائل
- البريد الإلكتروني الإضافي والتحقق:
- من 1.10 دولار/1,000 بريد إلكتروني
- من 0.80 دولار/100 تحقق
كيفية نشر واجهة برمجة تطبيقات Mailgun؟
لنشر واجهة برمجة تطبيقات Mailgun، تحتاج إلى اتباع هذه الخطوات:
- قم بالتسجيل للحصول على حساب Mailgun على: ⬇

2. احصل على بيانات اعتماد Mailgun API الخاصة بك:
- قم بتسجيل الدخول إلى حساب Mailgun الخاص بك.
- انقر على "إنشاء مفتاح API" وانتقل إلى لوحة معلومات مفتاح API لإنشاء مفتاح جديد.

- انسخ "مفتاح API" واحتفظ به في مكان أكثر أمانًا للاستخدام لاحقًا.

3. اختر لغة البرمجة المفضلة لديك وقم بتثبيت المكتبات أو SDKs اللازمة. توفر Mailgun مكتبات رسمية للغات عدة، بما في ذلك Python وPHP وRuby والمزيد. على سبيل المثال، إذا كنت تستخدم Python، يمكنك تثبيت مكتبة Mailgun باستخدام pip:
pip install mailgun-python
4. قم بتكوين تطبيقك لاستخدام واجهة برمجة تطبيقات Mailgun. إليك مثال عن كيفية إرسال بريد إلكتروني باستخدام واجهة برمجة تطبيقات Mailgun في Python:
import requests
def send_simple_message():
return requests.post(
"https://api.mailgun.net/v3/YOUR_DOMAIN_NAME/messages",
auth=("api", "YOUR_API_KEY"),
data={"from": "اسم المرسل <sender@your_domain_name>",
"to": ["recipient@example.com"],
"subject": "مرحبا",
"text": "اختبار بعض روعة Mailgun!"})
send_simple_message()
تأكد من استبدال "YOUR_DOMAIN_NAME" باسم نطاقك الفعلي و"YOUR_API_KEY" بمفتاح API الخاص بـ Mailgun.
5. قم بدمج واجهة برمجة تطبيقات Mailgun في تطبيقك بناءً على متطلباتك المحددة. يمكنك استخدام الواجهة لإرسال البريد الإلكتروني، وإدارة القوائم البريدية، وتتبع أحداث البريد الإلكتروني، والمزيد. راجع وثائق واجهة برمجة تطبيقات Mailgun للحصول على معلومات مفصلة حول النقاط النهائية المتاحة واستخدامها.
6. اختبر تكامل واجهة برمجة تطبيقات Mailgun بدقة للتأكد من أنها تعمل كما هو متوقع. يمكنك استخدام أدوات مثل Apidog لتبسيط عملية الاختبار. يتيح لك Apidog إنشاء وإرسال طلبات واجهة برمجة التطبيقات، وعرض الاستجابات، وأتمتة اختبارات واجهة برمجة التطبيقات.
7. قم بنشر تطبيقك في بيئة الاستضافة التي تختارها. تأكد من أن تطبيقك لديه الأذونات والتكوينات اللازمة للوصول إلى واجهة برمجة تطبيقات Mailgun.
إليك مثال عن كيفية نشر تطبيق Python يستخدم واجهة برمجة تطبيقات Mailgun على خادم:
1. قم بإعداد خادم مع تثبيت Python والاعتمادات المطلوبة.
2. انسخ رمز تطبيقك إلى الخادم.
3. قم بتعيين متغيرات البيئة لبيانات اعتماد واجهة برمجة تطبيقات Mailgun:
export MAILGUN_API_KEY='YOUR_API_KEY'
export MAILGUN_DOMAIN='YOUR_DOMAIN_NAME'
4. قم بتشغيل تطبيقك على الخادم. على سبيل المثال، إذا كان لديك تطبيق Flask، يمكنك استخدام خادم WSGI مثل Gunicorn لتشغيله:
gunicorn your_app:app
5. قم بتكوين خادمك لمعالجة الطلبات الواردة وتوجيهها إلى تطبيقك.
6. راقب سجلات تطبيقك وداشبورد Mailgun لأي مشاكل أو أخطاء.
تذكر أن تتعامل مع المعلومات الحساسة، مثل مفاتيح API، بشكل آمن ولا تكشفها علنًا.
من خلال اتباع هذه الخطوات واستخدام وثائق واجهة برمجة تطبيقات Mailgun والمكتبات، يمكنك بنجاح نشر وتكامل واجهة برمجة تطبيقات Mailgun في تطبيقك.
استخدام Apidog لاختبار النقاط النهائية قبل النشر
قبل النشر الفعلي لواجهة برمجة تطبيقات Mailgun، قد تحتاج إلى اختبار النقاط النهائية للتأكد من أنها تعمل بشكل صحيح. يمكن أن يكون Apidog، وهو منصة شاملة للاختبار والتطوير، مساعدًا كبيرًا هنا لاختبار النقاط النهائية وتقديم الأكواد الجاهزة. إليك خطوة بخطوة حول كيفية القيام بذلك:
الخطوة 1: التسجيل في Apidog
- أنشئ حسابًا على Apidog للوصول إلى أدوات اختبار واجهة برمجة التطبيقات.
الخطوة 2: إنشاء طلب نقطة نهائية جديدة
- أنشئ مشروعًا جديدًا أو انتقل إلى المشروع الافتراضي بعد تشغيل التطبيق. (يمكنك تنزيل تطبيق Apidog أو ببساطة استخدام النسخة المستندة إلى الويب من Apidog)
- أنشئ نقطة نهائية جديدة وفي مستند النقطة النهائية الجديد، حدد طريقة HTTP المناسبة للنقطة النهائية التي تريد اختبارها، ثم انسخ عنوان URL الخاص بالنقطة النهائية أو cURL في شريط البحث.

- بعد إدخال عنوان URL، ستتم تعبئة أي معلمات تتعلق بمعلمات الطلب، والجسم، أو الرؤوس تلقائيًا.

- قم بالتبديل إلى تبويب "المصادقة"، واختر مصادقة الحامل كما تتطلب Mailgun.

- املأ اسم المستخدم (api) وكلمة المرور (مفتاح API) كما تتطلب Mailgun.

- انقر على "إرسال" في أعلى اليمين للحصول على نتيجة استجابة API والتقرير.

الخطوة 3: توليد كود جاهز للاستخدام المباشر
- انقر على "حفظ" لحفظ النقطة النهائية.
- قم بالتبديل إلى وضع
التصميم
لواجهة برمجة تطبيقات Mailgun. في لوحة التحكم، انقر علىتوليد كود
الموجود في أعلى اليمين.

- في نافذة المنبثقة، اختر الإطار الفني المناسب لمشروعك وانسخ الكود للنشر المباشر.

تهانينا! لقد تعلمت بنجاح كيفية دمج واجهة برمجة تطبيقات Mailgun بسلاسة في مشروعك دون الحاجة إلى برمجة معقدة أو خبرة فنية.
الاستنتاج
توفر واجهة برمجة تطبيقات Mailgun حلاً قويًا ومرنًا للشركات التي تسعى إلى تحسين عمليات التواصل عبر البريد الإلكتروني. بفضل مجموعة ميزاتها الشاملة، وخطط التسعير التنافسية، وخيارات النشر المباشرة، تمكن واجهة برمجة تطبيقات Mailgun المطورين من دمج وظيفة البريد الإلكتروني في تطبيقاتهم بسلاسة. من خلال استخدام أدوات مثل Apidog لاختبار واجهة برمجة التطبيقات بدقة، يمكن للشركات ضمان موثوقية وأداء تكامل واجهة برمجة تطبيقات Mailgun. استغل إمكانات واجهة برمجة تطبيقات Mailgun وفتح آفاق جديدة لاستراتيجيات التواصل عبر البريد الإلكتروني الخاصة بك. بفضل قدراتها القوية وعملية التكامل سهلة الاستخدام، تعد واجهة برمجة تطبيقات Mailgun أداة قيمة لأي عمل يسعى لتعزيز تسليم البريد الإلكتروني وإدارة سير العمل.