الترحيل من Resend

حدود التوافق

تقبل SendHQ حقول JSON الشائعة بأسلوب Resend لعمليات الإرسال المباشرة عبر HTTP، لكنها ليست بديلًا مباشرًا لـ Resend SDK. وجّه مهايئ HTTP الخاص بك على الخادم إلى /api/v1/emails؛ ولا تفترض أن SDK ذا مضيف Resend مضمَّن في الشيفرة يمكن إعادة ضبطه.

مطابقة الحقول

تُطابَق الحقول from وto وcc وbcc وsubject وhtml وtext وreply_to والترويسات المخصصة الآمنة headers مباشرة. وتقبل SendHQ أيضًا message_class ومراجع القوالب المستضافة template وdraft_id وحقول الرد/السلسلة. أما حمولات React الخاصة بـ Resend ومصفوفات المرفقات المضمَّنة والوسوم والجماهير والبثوث وحقول الإرسال المجدول فليست مكافئات مقبولة.

المرفقات والقوالب

ارفع المرفقات إلى مسودة في SendHQ ثم أرسل باستخدام draft_id. والقوالب المستضافة موارد في SendHQ لها إصدارات منشورة وبيانات مُنمَّطة؛ رحِّل معرّفات القوالب واستدعاءات العرض صراحةً بدلًا من نسخ معرّف قالب المزوّد.

إعادة المحاولات

ولّد Idempotency-Key ثابتًا واحدًا لكل عملية إرسال منطقية. وأعد محاولة حمولة JSON المطابقة نفسها بذلك المفتاح. وإذا تغيّر الموضوع أو الجسم أو المستلِم أو الترويسة أو بيانات القالب، فاستخدم مفتاحًا جديدًا؛ وإلا تعيد SendHQ الخطأ 409. وتتضمن الاستجابة المخزّنة المُعادة Idempotent-Replayed: true.

قائمة التحقق للتحويل

1. وثّق كل نطاق From وعنوان المُرسِل الدقيق الذي ستستخدمه.
2. أرسل رسائل نصية وHTML مضبوطة إلى صندوق بريد تملكه.
3. أكّد قبول المزوّد بشكل منفصل عن أحداث التسليم.
4. جرّب معالجة 409 و422 و423 و429 و5xx.
5. أبقِ مهايئ المزوّد السابق متاحًا إلى أن ينجح كلٌّ من المسارين المعاملاتي ومسار دورة الحياة.