واجهة بريد SMTP
API لإرسال بريد المعاملات، مثل التحقق عند التسجيل وإشعارات الطلبات وإعادة تعيين كلمات المرور، عبر SMTP القياسي أوAPI عبر HTTP.
- طريقتا تكامل: استخدم عميل SMTP الحالي دون تغيير الكود، أوانتقل إلى API عبر HTTP لتقارير أكثر تفصيلًا
- القوالب: إدارة مركزية للقوالب وتمرير المتغيرات فقط عند الإرسال
- الإرسال الجماعي: مستلمون متعددون في طلب واحد، مع تقرير لكل مستلم
- إشعارات التسليم والارتداد عبر Webhook: أحداث تسليم / ارتداد / شكوى فورية لحماية سمعة المرسل
POST / GET /api/v1/smtp/*
نظرة عامة
توفر واجهة SMTP Aggregation API إمكانات إرسال البريد الإلكتروني. أضف حسابات بريد SMTP الخاصة بك وأرسل عبر واجهة API موحّدة. تدعم التدوير الذكي بين عدة حسابات والتحويل التلقائي عند الفشل وإدارة الحصص.
شراء اشتراك -> إضافة حسابات SMTP -> إنشاء مفتاح API -> استدعاء الإرسال
المصادقة
تستخدم SMTP API مفاتيح خاصة بالوحدة ببادئة smk_، بطريقتَي مصادقة:
سجّل الدخول إلى لوحة تحكم المستخدم -> SMTP Aggregation API -> إدارة مفاتيح API. احفظ المفتاح فور إنشائه؛ لا يمكن عرض المفتاح كاملًا مرة أخرى بعد إغلاق النافذة.
إرسال بريد
POST /api/v1/smtp/send
أرسل بريدًا. يختار النظام الحساب الأمثل حسب الأولوية والاستخدام والحالة.
حقول الرد
أرسل الترويسة Idempotency-Key لإعادة المحاولة بأمان: تُخزَّن أول نتيجة ناجحة مؤقتًا، والطلبات المكررة بالمفتاح نفسه تعيد النتيجة الأصلية دون إعادة الإرسال ودون خصم الحصة مرتين.
رد الإرسال المجدول
ينشئ send_at المستقبلي مهمة دون إرسال فوري؛ يُعاد الهيكل أدناه وتُخصم الحصة وقت الإرسال الفعلي:
يُعاد code: 429 عند نفاد الحصة. رقِّ أو انتظر الضبط.
إرسال دفعة
POST /api/v1/smtp/send/batch
حقول الرد
الحد الأقصى للمستلمين في الطلب الواحد = قيمة max_batch_size في باقتك (الافتراضي 10)؛ تجاوزه يفشل فورًا. تُحتسب الحصة اليومية/الشهرية لكل رسالة لا لكل طلب؛ والمستلمون المدرجون في قائمة إلغاء الاشتراك يُعلَّمون كفاشلين. تستغرق الدفعات الكبيرة وقتًا وقد تنتهي مهلة الطلب قبل الرد: أرسل الترويسة Idempotency-Key، وعند إعادة المحاولة بالقيمة نفسها تحصل على النتيجة الأولى بدل إعادة إرسال الدفعة كلها.
إرسال قالب
POST /api/v1/smtp/send/template
حقول الرد
يدعم القالب منع تكرار دائمًا عبر Idempotency-Key: <unique-string>. تُحفظ النية بالمستخدم + API Key + المفتاح، وتبقى بعد إعادة التشغيل أو فقد Redis. (1) المفتاح والجسم نفسهما يعيدان النتيجة الأصلية دون إرسال/خصم آخر؛ (2) جسم مختلف يعيد 409، استخدم مفتاحًا جديدًا؛ (3) أول طلب معلّق يعيد 409، أعد لاحقًا بالمفتاح نفسه؛ (4) النية الفاشلة لا تُفتح وتعيد 409، ابدأ بجديد. غياب الترويسة يعطّل المنع ويُعامل كإرسال عادي.
استعلام الحصة
GET /api/v1/smtp/quota
استعلم عن حصة الاشتراك المتبقية.
استعلام حالة الإرسال
GET /api/v1/smtp/status/:message_id
استعلم بـ message_id من الإرسال.
تقرير الارتداد/الشكاوى
POST /api/v1/smtp/inbound
الإبلاغ عن حدث ارتداد أو شكوى: يُضاف العنوان تلقائيًا إلى قائمة الحجب ويُعلَّم سجل الإرسال المطابق؛ وتتخطاه عمليات الإرسال اللاحقة لحماية سمعة المرسل لديك. قدّم واحدًا على الأقل من email / message_id.
الأسئلة الشائعة
نستخدم SMTP بالفعل؛ هل نحتاج إلى إعادة كتابة الكود؟
لا. وجّه عميل SMTP الحالي إلى المضيف والمنفذ وبيانات الاعتماد التي توفرها Tovanix. انتقل إلى API عبر HTTP عندما تحتاج إلى تقارير تسليم وارتداد أكثر تفصيلًا.
كيف أتعامل مع الارتدادات والشكاوى؟
تُرسل الحالتان إليك فورًا عبر Webhook. أضف العنوان إلى قائمة منع الإرسال وأوقف الإرسال إليه فورًا، للمساعدة في حماية سمعة نطاق الإرسال.
صفحات ذات صلة: واجهة API موحّدة لخدمات SMTP · وثائق الواجهة البرمجية · التحقق عبر الرسائل النصية
جارٍ التحميل…