البريد الإلكتروني لـ Dev DOC

توثيق واجهة برمجة التطبيقات للبريد الإلكتروني

مرحباً بكم في SMSMobileAPI توثيق واجهة برمجة التطبيقات للبريد الإلكتروني. يشرح هذا الدليل كيفية استخدام واجهة برمجة التطبيقات الخاصة بنا لإرسال واسترجاع رسائل البريد الإلكتروني باستخدام طلبات HTTP.

يتيح لك SMSMobileAPI الآن ربط أي حساب بريد إلكتروني بواجهة برمجة التطبيقات القوية لدينا! بمجرد إعداد التكامل عبر لوحة التحكم البديهية الخاصة بنا (انقر هنا لتسجيل الدخول أو إنشاء حساب), ستتمكن من إرسال واستقبال البريد الإلكتروني بسلاسة من خلال طلبات HTTP.

بريد إلكتروني آمن بدون كلمات مرور

أرسل رسائل البريد الإلكتروني دون الحاجة إلى كلمة مرور العميل. استخدم مفتاح API آمنًا للوصول الآمن والسهل.

التكامل السهل للبريد الإلكتروني

دمج إرسال البريد الإلكتروني مع طلبات HTTP البسيطة. لا يتطلب الأمر أي ترميز معقد.

استرداد رسائل البريد الإلكتروني بسهولة

جلب رسائل البريد الإلكتروني المستلمة عبر HTTP وإدارتها مباشرة في مشروعك.

إرسال بريد إلكتروني

نقطة النهاية: بريد https://api.smsmobileapi.com/sendemail/

المعلمات المطلوبة:

- أبيكي:مفتاح API الفريد الخاص بك للمصادقة.

- أبيكي بوكس:مفتاح API المرتبط بتكوين البريد الإلكتروني الخاص بك.

- اسم المرسل:اسم مرسل البريد الإلكتروني.

- البريد الإلكتروني للمرسل:عنوان البريد الإلكتروني للمرسل.

- البريد الإلكتروني للمستلم:عنوان البريد الإلكتروني للمستلم.

- موضوع البريد:موضوع البريد الإلكتروني.

- نص البريد:محتوى البريد الإلكتروني (HTML أو نص عادي).

- السماح بالتوقيع الذاتي:قم بضبطه على "نعم" للسماح بالشهادات الموقعة ذاتيًا.

المعلمات الاختيارية:

- الغاء الاشتراك:القيمة يجب أن تكون 1 لتفعيله -> إضافة شروط إلغاء الاشتراك تلقائيًا في أسفل البريد الإلكتروني، بالإضافة إلى رابط إلغاء الاشتراك.

- البريد الإلكتروني cc1، البريد الإلكتروني cc2، البريد الإلكتروني cc3:عناوين البريد الإلكتروني الإضافية إلى CC.

- مرفقBase64:محتوى المرفق مشفر بتنسيق Base64.

- مجموعة الأحرف:مجموعة الأحرف للبريد الإلكتروني. الإعداد الافتراضي هو UTF-8.

- الصورة المضمنة:عنوان URL للصورة التي سيتم تضمينها في البريد الإلكتروني.

- صورة مضمنة_cid:معرف محتوى فريد (CID) يستخدم للإشارة إلى الصورة المضمنة في نص HTML الخاص بالبريد الإلكتروني.

- شكل:تنسيق الرد.

- الرد_الاسم: اسم مرسل الرد.

- الرد_بالبريد_الالكترونى:عنوان البريد الإلكتروني للمرسل الرد.

مثال للطلب:


أرسل https://api.smsmobileapi.com/sendemail/?apikey=YOUR_API_KEY&apikeybox=YOUR_API_BOX&sender_name=John+Doe&sender_email=john@example.com&recipient_email=jane@example.com&mail_subject=Hello&mail_body=Hello+Jane

هل تعلم؟
لدينا أيضًا وحدة Python التي تتيح لك إرسال رسائل البريد الإلكتروني الخاصة بك بسهولة وأمان أكبر! 🚀📧
https://pypi.org/project/smsmobileapi-send-email/

استرجاع رسائل البريد الإلكتروني

نقطة النهاية: يحصل https://api.smsmobileapi.com/getemail/

المعلمات المطلوبة:

- أبيكي:مفتاح API الفريد الخاص بك للمصادقة.

- أبيكي بوكس:مفتاح API المرتبط بتكوين البريد الإلكتروني الخاص بك.

- مبوكس:المجلد الذي تريد استرجاع رسائل البريد الإلكتروني منه (على سبيل المثال، صندوق الوارد).

- يبدأ:مؤشر البداية لاسترجاع البريد الإلكتروني (الافتراضي هو 0).

مثال للطلب:


احصل على https://api.smsmobileapi.com/getemail/?apikey=YOUR_API_KEY&apikeybox=YOUR_API_BOX&mbox=INBOX

إجابة:

تعيد واجهة برمجة التطبيقات استجابة JSON تحتوي على تفاصيل البريد الإلكتروني، بما في ذلك الموضوع، والمرسل، والمستلم، والنص، وطابع الوقت، والمرفقات (إذا كانت متوفرة).


{


    "نتيجة": {

		
        "خطأ": "0"،

        "قائمة البريد الإلكتروني": [ {

				
                "المعرف": "12345"،

                "object": "مرحبًا"،

                "body": "مرحبًا بك في خدمتنا!"

                "البريد الإلكتروني1": "sender@example.com"،

                "البريد الإلكتروني 2": "recipient@example.com"،

                "الطابع الزمني": "1672531200"،

                "التاريخ": "01/01/2023 - 12:00:00"،

                "الحجم": "15 كيلوبايت"،

                "مرفق": ""

				
            }
        ]

		
    }

	
}

استرداد جهات الاتصال غير المشتركة

نقطة النهاية: يحصل https://api.smsmobileapi.com/email/unsubscribed/

المعلمات المطلوبة:

- أبيكي:مفتاح API الفريد الخاص بك للمصادقة.

- أبيكي بوكس:مفتاح API المرتبط بتكوين البريد الإلكتروني الخاص بك.

- بريد إلكتروني: بريد إلكتروني جهة الاتصال (إذا كانت الإجابة فارغة، فهذا يعني أن جهة الاتصال لم تُلغَ اشتراكها. أما إذا وُجدت إجابة على البريد الإلكتروني، فهذا يعني أن البريد الإلكتروني قد أُلغي اشتراكه)

مثال للطلب:


احصل على https://api.smsmobileapi.com/email/unsubscribed/?apikey=YOUR_API_KEY&apikeybox=YOUR_API_BOX

ملحوظة :

تتيح لك واجهة برمجة التطبيقات هذه استرداد قائمة جهات الاتصال تلقائيًا التي تلقت بريدًا إلكترونيًا من خلال البريد الخاص بك وقامت بالنقر فوق رابط إلغاء الاشتراك أو طلبت عدم تلقي الاتصالات بعد الآن.

باستخدام واجهة برمجة التطبيقات هذه، يمكنك:

حدد جهات الاتصال التي طلبت إزالتها من قوائم البريد الخاصة بك.
حافظ على تحديث قواعد البيانات الخاصة بك في الوقت الحقيقي.
الالتزام باللوائح الخاصة بمكافحة البريد العشوائي (مثل GDPR أو CAN-SPAM).

👉 استخدم واجهة برمجة التطبيقات هذه للحفاظ على قوائم نظيفة واحترام تفضيلات المستلمين.

اتصل بنا

إذا كان لديك أي أسئلة أو تحتاج إلى مزيد من المساعدة، فلا تتردد في الاتصال بنا على api@smsmobileapi.com.