تخطَّ إلى المحتوى الرئيسي

Email: الإرسال

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

4 دقيقة قراءة

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

النقطة الطرفية

POSThttps://mersal.it/api/email/send

المصادقة

يتطلب مفتاح API الشخصي الخاص بك عبر ترويسة Api-key (أو بديل api_key في معامل الرابط/نص الطلب). راجع المصادقة.

معاملات الطلب

الاسمالنوعمطلوبالوصف
contactarrayنعممصفوفة المستلمين. يجب أن تحتوي على عنصر واحد على الأقل.
contact.*.emailstringنعمعنوان البريد الإلكتروني للمستلم. يجب أن يكون بريدًا صالحًا.
contact.*.subjectstringنعمسطر موضوع البريد الإلكتروني.
contact.*.messagestringنعمنص البريد الإلكتروني. يدعم HTML.
contact.*.gateway_identifierstringلامعرّف UID لبوابة بريد إلكتروني محددة للإرسال عبرها. إذا تم تمريره، يجب أن يشير إلى بوابة بريد إلكتروني نشطة في حسابك. احذف هذا الحقل لاستخدام بوابة البريد الافتراضية/النشطة في حسابك.
contact.*.sender_namestringلااسم عرض مخصص للمرسل.
contact.*.reply_to_emailstringلاعنوان الرد الخاص بالبريد الإلكتروني.
contact.*.schedule_atstringلاجدولة التسليم لوقت لاحق، بصيغة Y-m-d H:i:s. احذف هذا الحقل للإرسال الفوري.
attachmentsarrayلامصفوفة الملفات المراد إرفاقها. الأنواع المسموح بها: pdf, doc, docx, xls, xlsx, csv, txt, png, jpg, jpeg, gif, zip, rar, svg, webp. تخضع لحدود المرفقات المهيأة في حسابك (الحد الأقصى لعدد الملفات وحجمها).

مثال على الطلب

curl -X POST https://mersal.it/api/email/send \
  -H "Api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contact": [
      {
        "email": "[email protected]",
        "subject": "Your July invoice is ready",
        "message": "<p>Hi there, your invoice for July is attached.</p>",
        "sender_name": "Mersal Billing",
        "reply_to_email": "[email protected]"
      }
    ],
    "attachments": []
  }'

مثال على الاستجابة

{
  "success": true,
  "message": "Email queued successfully",
  "data": {
    "contact": [
      {
        "email": "[email protected]",
        "status": "queued"
      }
    ]
  }
}

عند فشل التحقق من صحة البيانات، تُرجع Mersal الحالة 422:

{
  "success": false,
  "message": "Validation failed",
  "errors": {
    "contact.0.email": ["The contact.0.email must be a valid email address."]
  }
}

إرفاق الملفات

إذا كنت بحاجة إلى إرسال مرفقات، أرسل attachments كرفع ملفات multipart بدلاً من مصفوفة فارغة. تحقق من إعدادات Gateways في حسابك لمعرفة الحد الأقصى المهيأ لعدد الملفات وحجمها قبل الاعتماد على المرفقات في بيئة الإنتاج.

تحسين وصول البريد

لضمان وصول رسائلك لصندوق الوارد وليس الـ Spam، فعّل توقيع DKIM ونطاق التتبع الخاص بك — الشرح الكامل في إعداد DKIM ونطاقات التتبع.

الأخطاء

أكثر حالات الفشل شيوعًا هي مفتاح API مفقود أو غير صالح، أو اشتراك منتهي الصلاحية، أو خطأ تحقق 422 في contact أو attachments، أو gateway_identifier لا يشير إلى بوابة بريد إلكتروني نشطة. راجع الأخطاء ورموز الحالة للمرجع الكامل.

هل ساعدتك هذه الصفحة؟
Email: الإرسال · شروحات مرسال