دليل جديد: كيف تُسخّن عنوان IP مخصصًا دون الإضرار بسمعتك. اقرأ الآن →
MigoSMTP
واجهة برمجة البريد

أرسل بريدك وتتبّعه وأدِره من شيفرتك

REST API للإرسال والقوالب والأحداث والتقارير، بمفاتيح محددة الصلاحيات وأخطاء واضحة.

جاهز للوكلاء: يتيح خادم MCP لمساعدي الذكاء الاصطناعي إرسال البريد وفحصه بأمان.

الطلب
POST /v1/send
{ "from": "hello@example.com",
"to": "you@example.com",
"subject": "Hello" }
الاستجابة
202 Accepted
{ "id": "msg_[id]" }
Idempotency-Key مدعوم
202 Accepted
JSON
متكرر الأمان
أرسل باستدعاء JSON واحدوثّق بمفتاح Bearer، وأرسل جسم JSON صغيرًا، واحصل على معرّف الرسالة فورًا.
البدء السريع
cURL
Node
Python
PHP
Python
import migosmtp
c = migosmtp.Client("KEY")
c.send(to="you@example.com",
template="welcome")
أُرسلت · 202
SDK مُنمَّطة
مفتوح المصدر
مكتبات رسمية لمنظومتكاختر Node أو Python أو PHP أو Go. الأسطر القليلة نفسها ترسل رسالة وتعالج الأخطاء بالطريقة نفسها في كل مكان.
نطاقات مفتاح API
إرسال البريدمسموح
قراءة الأحداثمسموح
إدارة النطاقاتللمسؤولين فقط
حد المعدل[n] req/s
أقل الصلاحيات
تدوير آمن
مفاتيح بالصلاحيات التي تحتاجها بالضبطأنشئ مفتاحًا لكل خدمة، وقيّد ما يستطيع كل منها فعله، وألغِ أحدها دون المساس بالبقية.
حد المعدل
ذروة في الحركة
الطابور يخفف الذروة
لا شيء يضيع
ضغط عكسي
بلا فقدان للبيانات
استوعب الدفعات المفاجئة بسلاسةعندما تتجاوز الحركة معدلك، تنتظر الطلبات في الطابور وتُصرَّف بدل أن تفشل، فلا يضيع شيء.
أحداث الرسائل
أحداث موقّعة
/events
200 OK
مستودع البيانات
200 OK
التنبيهات
إعادة المحاولة بعد 30s
موقّع بـ HMAC
مرة واحدة على الأقل
الأحداث تعود بالطريقة نفسهاتبثّ واجهة API نفسها أحداث التسليم والفتح والنقر والارتداد إلى نقطة نهايتك، موقّعة.
أرسل الفاتورة بالبريد إلى بريا وأكّد التسليم
وكيل AI
MigoSMTP MCPمفتاح محدد الصلاحيات
send_emailأرسل رسالة
get_eventsاقرأ نتائج التسليم
check_domainالتحقق من سجلات DNS
أُرسلت · سُجّل معرّف الطلب · تم تأكيد التسليم
MCP جاهز
محدد الصلاحيات ومسجَّل
اسمح لوكلاء الذكاء الاصطناعي باستدعاء API لديكتتوفر واجهة API نفسها عبر MCP، فيستطيع الوكيل إرسال البريد وقراءة الأحداث والتحقق من DNS. المفاتيح محددة الصلاحيات، والاستدعاءات مسجَّلة، ويمكن اشتراط الموافقة على عمليات الإرسال.
طلب واحد
حزم SDK
مفاتيح محددة الصلاحيات
حدود المعدل
Webhooks
API للوكلاء
ترحيل SMTPREST APIWebhooksعناوين IP مخصصةتوقيع DKIMتحليل البريد الواردالقوالبالتحليلاتقوائم الحظرمراقبة السمعةالتحقق من البريد الإلكترونيأدوار الفريق وسجل التدقيقترحيل SMTPREST APIWebhooksعناوين IP مخصصةتوقيع DKIMتحليل البريد الواردالقوالبالتحليلاتقوائم الحظرمراقبة السمعةالتحقق من البريد الإلكترونيأدوار الفريق وسجل التدقيق
الإمكانات

واجهة API تعمل بكفاءة في بيئة الإنتاج

نقاط نهاية REST

موارد متوقعة السلوك للرسائل والقوالب والنطاقات والأحداث.

القوالب والمتغيرات

أرسل باسم القالب ومرّر المتغيرات لكل رسالة.

مفاتيح عدم التكرار (Idempotency)

أعد المحاولة بأمان دون إرسال نسخ مكررة.

مفاتيح API محددة الصلاحيات

امنح كل خدمة الأذونات التي تحتاجها فقط.

Webhooks

احصل على أحداث موقّعة لكل نتيجة تسليم.

أخطاء وحدود واضحة

رموز أخطاء متسقة ورؤوس لحدود المعدل.

كيف يعمل

خدمتكتستدعي نقطة نهاية الإرسال عبر HTTPS بمفتاح API محدد الصلاحيات.
واجهة API للبريد في MigoSMTPتتحقق من الطلب، وتطبّق القوالب والحدود، وتضع الرسالة في الطابور، وتعيد معرّفًا.
أحداث تعود إليكتبلّغ webhooks الموقّعة تطبيقك بنتائج التسليم والارتداد والشكاوى.
الخطوة 1

أنشئ مفتاح API

اختر الصلاحيات وقائمة سماح IP للخدمة التي ستستخدمه.

الخطوة 2

أرسل أول رسالة

استدعِ نقطة نهاية الإرسال بمرسل موثَّق ومستلم.

الخطوة 3

استمع إلى الأحداث

سجّل webhook لمتابعة التسليم والارتداد والتفاعل.

شاهده قيد العمل

منصة واحدة من أول إرسال إلى الوارد

تنقّل بين المراحل لترى ما تتحكم به في كل خطوة. واجهة توضيحية. جميع الأرقام والعناوين المعروضة بيانات نموذجية.

app.migosmtp.com / sendبيانات نموذجية
في الطابور
184,320
المرسل اليوم
6,418,905
المعدل
412/s
مقبولةرسالة إلى you@example.com
مقبولةرسالة إلى team@example.com
في الطابوردفعة من 25,000 مستلم
مقبولةرسالة إلى ops@example.com
للمطورين

موثّقة ومرقّمة الإصدارات وسهلة الاختبار

كل ما في لوحة التحكم متاح عبر API، مع أمثلة بالّلغات التي تستخدمها.

  • مفاتيح محددة الصلاحيات مع قائمة سماح IP
  • طلبات idempotent لإعادة محاولة آمنة
  • صيغة أخطاء متسقة
  • حزم SDK وأمثلة جاهزة للنسخ
نظرة سريعة
عنوان URL الأساسيapi.migosmtp.com/v1
التوثيقمفتاح API من نوع Bearer
الصيغةJSON عبر HTTPS
الأحداثwebhooks موقّعة
المرجعمرجع API كامل وأمثلة SDK
نظرة عامة

ما هي واجهة API للبريد الإلكتروني؟

واجهة API للبريد الإلكتروني هي واجهة ويب تتيح لشيفرتك إرسال البريد وإدارته عبر استدعاء نقاط نهاية HTTP بدلًا من التخاطب بلغة SMTP. مع واجهة API للبريد في MigoSMTP ترسل طلب POST بصيغة JSON يتضمن مرسلًا موثَّقًا ومستلمًا ومحتوى أو اسم قالب، فتوضع الرسالة في الطابور للتسليم عبر بنية MigoMTA التحتية لدينا. وتعيد الاستجابة معرّفًا لتتبعها. ويمكنك أيضًا الإرسال عبر HTTP الخام.

تناسب واجهة API فرق المنتجات التي تريد موارد متوقعة السلوك للرسائل والقوالب والنطاقات والأحداث. المفاتيح محددة الصلاحيات، فتستطيع خدمة الفوترة إرسال الإيصالات دون القدرة على تعديل النطاقات. وتجعل مفاتيح عدم التكرار إعادة المحاولة آمنة، وتتيح رموز الأخطاء المتسقة ورؤوس حدود المعدل للعملاء التراجع بسلاسة. وكل ما في لوحة التحكم متاح أيضًا عبر API. ويمكن فصل حركة الاختبار عن الإنتاج باستخدام مساحات عمل ومفاتيح مختلفة، مما يُبقي رسائل الاختبار خارج تقاريرك الحية وسمعتك.

من ناحية قابلية التسليم، تمنحك واجهة API تحكمًا لا يوفره SMTP: أخطاء منظَّمة، وبيانات وصفية لكل رسالة، وأحداث webhook يمكنك إعادتها إلى تطبيقك. وإذا جمعتها مع معالجة قائمة الحظر توقفت عن مراسلة العناوين السيئة تلقائيًا. ويتيح خادم MCP لدينا لوكلاء الذكاء الاصطناعي استدعاء الواجهة نفسها بمفاتيح محددة الصلاحيات وقابلة للإلغاء، فتبقى الأتمتة ضمن الحدود التي تضعها. ولأن كل مفتاح محدد الصلاحيات ومسجَّل، ترى بدقة أي خدمة أو وكيل أرسل أي رسالة، وتلغي الوصول فورًا عند الحاجة.

حالات الاستخدام

حالات الاستخدام الشائعة لواجهة API للبريد

البريد التفاعلي من تطبيقك

أطلق الإيصالات وإعادة تعيين كلمات المرور والتنبيهات باستدعاء API واحد. أرسل باسم القالب ومرّر المتغيرات، فتبقى شيفرة المنتج خالية من HTML وتعديلات النصوص.

إعادة محاولة آمنة في طوابير المهام

أرفق مفتاح عدم تكرار بكل عملية إرسال. إذا تعطل عامل المعالجة وأعاد المحاولة، تتعرف واجهة API على التكرار ولا ترسل الرسالة نفسها مرتين.

مفاتيح لكل خدمة في الخدمات المصغّرة

أصدر مفتاحًا محدد الصلاحيات لكل خدمة مع قائمة سماح IP. إذا اختُرقت إحدى الخدمات تلغي مفتاحًا واحدًا فقط، ويواصل بقية مسار بريدك العمل.

إغلاق الحلقة بالأحداث

اجمع نقطة نهاية الإرسال مع webhooks لتعكس قاعدة بياناتك حالات التسليم والارتداد والشكوى. عندها يجيب فريق الدعم عن وجهة الرسالة دون فتح السجلات.

إشعارات من منتج SaaS

أرسل أحداث التطبيق مثل الدعوات وتنبيهات الاستخدام وإشعارات الفوترة عبر API واحدة، بمفتاح لكل خدمة وقوالب يملكها فريق المنتج.

الوكلاء والأتمتة

امنح وكيل ذكاء اصطناعي أو أداة داخلية مفتاحًا محدد الصلاحيات يستطيع الإرسال فقط أو قراءة الحالة فقط. يُسجَّل كل استدعاء على هذا المفتاح، فتراجع ما فعله وتلغيه في أي وقت.

اختيار الطريقة

API للبريد أم ترحيل SMTP؟

كلاهما يسلّم عبر البنية التحتية نفسها. اختر بحسب طريقة بناء برمجياتك.

واجهة برمجة البريدترحيل SMTP
الأنسب لـشيفرة جديدة تريد القوالب وعدم التكرار واستجابات منظَّمةتطبيقات وإضافات CMS وأجهزة قائمة تتحدث SMTP أصلًا
التكاملHTTPS وJSON من أي لغةالمضيف وبيانات الاعتماد في إعدادات البريد
الأخطاءرموز أخطاء منظَّمة ورؤوس حدود المعدلرموز استجابة SMTP
التحكم في الوصولمفاتيح API محددة الصلاحيات، وقائمة سماح IP اختياريةبيانات اعتماد لكل حساب وقائمة سماح IP

يمكنك استخدام الاثنين ضمن مساحة عمل واحدة: SMTP للأدوات التي لا تستطيع تغييرها، وAPI للخدمات الجديدة.

ميزات الذكاء الاصطناعي

API للبريد بمساعدة الذكاء الاصطناعي

جاهز للوكلاء

خادم MCP لوكلاء الذكاء الاصطناعي

اربط مساعدًا ذكيًا بـ MigoSMTP عبر خادم MCP ليستعلم عن حالة الرسائل أو يصوغ مسودات الإرسال. تحمل المفاتيح الصلاحيات التي تمنحها، ويمكن اشتراط موافقة بشرية على عمليات الإرسال.

المساعد

مساعد فرز الأخطاء

الصق خطأ API أو طلبًا فاشلًا ليشرح المساعد السبب، مثل مرسل غير موثَّق أو حقل مشوَّه، ويعرض استدعاءً مصحَّحًا. وأنت من يطبّق الإصلاح.

مساعدة

شيفرة تكامل بصياغة الذكاء الاصطناعي

صِف ما تريد إرساله فيولّد المساعد طلبًا نموذجيًا بلغتك وفق اصطلاحات SDK لدينا. راجعه واختبره قبل وصوله إلى الإنتاج.

تنبؤي

اكتشاف الارتفاعات المفاجئة وسوء الاستخدام

يراقب اكتشاف الشذوذ معدلات الإرسال لكل مفتاح وينبّه إلى الدفعات غير المعتادة. يمكنه إخطار فريقك أو اقتراح إيقاف مفتاح، وأي إجراء تلقائي يكون باختيارك.

ميزات الذكاء الاصطناعي مساعِدة واختيارية: يعمل الوكلاء ضمن الصلاحيات التي تمنحها فقط، ويبقى فريقك متحكمًا بالمفاتيح وعمليات الإرسال.

أفضل الممارسات

أفضل ممارسات واجهة API للبريد

استخدم مفاتيح عدم التكرار في كل عملية إرسال

أنشئ مفتاحًا ثابتًا لكل رسالة منطقية، مثل معرّف الطلب مضافًا إليه الحدث. عندها لا تنتج إعادة المحاولة بعد انتهاء المهلة رسائل مكررة.

قيّد المفاتيح بأدنى صلاحيات

امنح كل خدمة الأذونات التي تحتاجها فقط وأضف قائمة سماح IP حيث تكون العناوين ثابتة. نطاق تأثير أصغر يعني استجابة أبسط للحوادث.

احترم رؤوس حدود المعدل

اقرأ رؤوس الحدود في كل استجابة وتراجع قبل أن يتم تقييدك. التراجع الأسي مع التشويش العشوائي يتعامل مع الدفعات المفاجئة دون إغراق API بالطلبات.

تحقق من توقيعات webhook

افحص التوقيع على كل حدث قبل الوثوق به. غيّر السر دوريًا وفورًا إذا احتمل تسريبه.

احفظ معرّف الرسالة

احفظ المعرّف الذي تعيده عملية الإرسال بجانب سجلك الخاص. فهذا يسهّل لاحقًا البحث في الدعم وتسوية الأحداث.

افصل الاختبار عن الإنتاج

استخدم مساحات عمل ومفاتيح مختلفة للتجربة والإنتاج. عندها لا تصل أخطاء الاختبار إلى مستلمين حقيقيين ولا تؤثر في سمعتك.

الأسئلة الشائعة

API للبريد: الأسئلة الشائعة

تحتاج إلى مساعدة في التكامل؟ يستطيع فريقنا مراجعته معك قبل الإطلاق.

ما هي واجهة API للبريد الإلكتروني؟

واجهة API للبريد الإلكتروني مجموعة من نقاط نهاية HTTP تتيح لبرمجياتك إرسال البريد وإدارته دون تشغيل خوادم بريد. ترسل طلب JSON فيضع المزوّد الرسالة في الطابور ويسلّمها، وتتلقى تحديثات الحالة عبر الاستجابات وwebhooks.

كيف أرسل بريدًا إلكترونيًا عبر MigoSMTP API؟

أنشئ مفتاح API، ووثّق نطاق مرسل، ثم أرسل JSON بطلب POST إلى نقطة نهاية الإرسال مع عنوان المرسل والمستلم والمحتوى أو قالب بمتغيراته. تعيد الاستجابة معرّف رسالة يمكنك تتبعه. راجع مرجع API لمعرفة الحقول.

ما الفرق بين API للبريد وSMTP؟

SMTP بروتوكول تتحدث به البرمجيات القائمة أصلًا، فلا يتطلب تغيير الشيفرة. أما API فتستخدم HTTPS وJSON، مما يتيح أخطاء منظَّمة وقوالب وعدم تكرار وبيانات وصفية. كلاهما يستخدم بنية التسليم نفسها، فاختر بحسب طريقة بناء تطبيقك.

هل توجد بيئة تجريبية لاختبار API للبريد؟

استخدم مساحة عمل ومفتاح API منفصلين للاختبار، لتبقى رسائل الاختبار خارج تقاريرك الحية وسمعة المرسل. لا تشارك مفتاحًا واحدًا بين الاختبار والإرسال الفعلي. اطلب منا إعداد وضع اختبار لحسابك إن احتجته.

كيف تُطبَّق حدود المعدل في API؟

تُعاد الحدود في رؤوس الاستجابة، فيرى عميلك السعة المتبقية ويتراجع قبل أن يتم تقييده. وتعتمد القيم المطبقة عليك على باقتك. ابنِ عملاء يقرؤون الرؤوس ويبطئون بسلاسة.

هل يمكنني إرسال الرسائل على دفعات؟

راجع مرجع API لمعرفة خيارات الدفعات وحدود المستلمين المطبقة على باقتك. وأيًا كان حجم الدفعة، أرسل مفتاح عدم تكرار مع كل طلب والتزم برؤوس حدود المعدل، ليمكن إعادة محاولة أي فشل جزئي دون تكرار.

ما هو خادم MCP في MigoSMTP؟

خادم MCP طريقة قياسية لاستدعاء الأدوات من مساعدي الذكاء الاصطناعي. يتيح خادمنا للوكلاء المتوافقين العمل مع API للبريد، مثل التحقق من حالة رسالة، بمفاتيح محددة الصلاحيات تتحكم بها. ويمكن اشتراط موافقة شخص على عمليات الإرسال.

ما اللغات وحزم SDK المدعومة؟

هي واجهة REST عبر HTTPS، فتعمل مع أي لغة تستطيع إرسال طلبات HTTP. تجد الأمثلة الجاهزة للنسخ وحزم SDK في الوثائق. احفظ مفاتيح API في متغيرات البيئة أو مدير أسرار، ولا تضعها في الشيفرة المصدرية أبدًا.

ابدأ الإرسال خلال دقائق.

أنشئ حساباً، وأضف نطاقك، وأرسل أول رسالة بريد إلكتروني.