واجهة API للبريد
أرسل من كودك، مرة واحدة بالضبط.
استدعاء واحد يرسل رسالة أو دفعة من مئة. لكل إرسال معرّف قبل أن يغادر، وإعادة المحاولة تعيد النتيجة الأولى بدل الإرسال من جديد.
باختصار
ما هي واجهة API للبريد المعاملاتي؟
هي الطريقة التي يرسل بها التطبيق بريده الخاص، مثل الإيصالات وروابط تسجيل الدخول والتنبيهات، بطلب HTTP بدل أن يضغط أحدهم على إرسال.
100
رسالة في استدعاء دفعة واحد
365
يوماً يمكن جدولة الإرسال مسبقاً
900
ثانية للتراجع عن إرسال فوري
كيف يعمل
دفعة لا تكون أبداً كل شيء أو لا شيء
حتى 100 رسالة في كل استدعاء، تُفحص كل واحدة على حدة. العنوان الخاطئ يُفشل عنصره وحده، ويذهب الباقي.
الآن أو لاحقاً أو مع مهلة للتراجع
جدول حتى سنة مقدماً، أو أمسك إرسالاً فورياً حتى 15 دقيقة. ألغِه أو أعد جدولته حتى يغادر.
أثر لكل رسالة
يحصل كل إرسال فوراً على معرّف msg_. اقرأ حالته وأحداث كل مستلم ومرات الفتح والنقر.
أرسل دفعة
حزمة TypeScript SDK، أو JSON نفسه عبر HTTP عادي.
import { init, openemail } from '@openemail/sdk' init({ apiKey: process.env.OPENEMAIL_API_KEY }) const result = await openemail.emails.sendBatch( [ { from: '[email protected]', to: '[email protected]', subject: 'Order AC-4192 has shipped', text: 'It is on its way.' }, { from: '[email protected]', to: '[email protected]', subject: 'Order AC-4193 has shipped', text: 'It is on its way.' }, ], { idempotencyKey: 'shipments:2026-09-23' },) console.log(result.sent, result.failed)ما الذي تحصل عليه
في المنتج اليوم
القوالب بالمعرّف
أرسل قالباً محفوظاً وثبّت النسخة التي اختبرتها.
بلغتهم
أضف translate فيقرؤها كل مستلم بلغته، وإلا لا تُرسل أصلاً.
بصيغة Resend أيضاً
وجّه Resend SDK إلى /compat/resend واحتفظ بكودك.
ممارسات جيدة
لتستفيد منه إلى أقصى حد
- 01
اشتقّ مفتاح عدم التكرار
استخدم سبب الإرسال، مثل رقم الطلب، ولا تستخدم طابعاً زمنياً أبداً.
- 02
اقرأ الحالة
202 تعني في الطابور أو مجدول. تحقّق من status قبل أن تعدّه مُسلَّماً.
- 03
ضع وسوماً على ما ترسله
حتى 10 وسوم لكل رسالة، تعود مع كل قراءة.
أين وصلنا
من المفيد معرفته
- لا وضع اختبار
- كل المفاتيح حيّة، لذا يُسلَّم كل إرسال فعلاً.
- لا حالة ارتداد على الإرسال
- يصل الارتداد إلى المحادثة وإلى webhook email.bounced، لا إلى GET /emails.
- رسائل المحرّر غير مدرجة
- البريد المرسل من التطبيق لا يظهر في GET /emails.
أسئلة
ما يُسأل عنه كثيرًا
تابع القراءة
يعمل جيدًا مع
ابدأ
نطاقك،
بريدك.
وجّه نطاقًا إلى OpenEmail واقرأ بريده في صندوق بريد مبنيّ حوله. الخطة المجانية تشمل نطاقًا واحدًا.
