Tovanix

API لإرسال البريد

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

المصادقة: مفتاح API على مستوى المستخدم المستخدم في الواجهات المفتوحة ذات الصلة على المنصة
الإرسال: POST /api/v1/mail/send؛ تُجمع الاستجابة بحسب المستلم، ويمثل bounced_addrs أساس تنظيف القائمة
منع التكرار: مع ترويسة Idempotency-Key، تُرسل الطلبات المتكررة بالمفتاح نفسه مرة واحدة فقط، دون تسليم أوفوترة مكررة
سلاسل الردود: مرر in_reply_to وسلسلة references كاملةً لتصل الردود إلى محادثة المستلم الأصلية
الحصة والنطاقات: استعلم عن الحصة المتبقية اليوم ونطاقات الإرسال الصالحة لضبط معدل الإرسال في نظامك
أمثلة الكود: أمثلة دنيا عاملة لـcURL / Node.js / Python / Go / PHP، مع منع التكرار ومعالجة الارتداد الدائم

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

هل يعني HTTP 200 وصول البريد إلى جميع المستلمين؟

لا. تُجمع النتائج بحسب المستلم؛ قد تكون رسالة إلى خمسة أشخاص 2 مُسلمة و1 في قائمة الانتظار و2 مرتدة نهائيًا. لا توجد إشعارات ارتداد عبر Webhook، لذا يمثل bounced_addrs أساس تنظيف القائمة الوحيد؛ أوقف الإرسال إلى تلك العناوين فورًا.

متى تلزم Idempotency-Key؟

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

جارٍ التحميل…