بريد المصادقة
إعادة تعيين كلمة المرور والرموز لمرة واحدة والروابط السحرية، باستدعاء API واحد لكل منها
بريد تسجيل الدخول هو البريد الذي ينتظره المستخدم وهو جالس أمام الشاشة. تمنحك MailLand قوالب لا تُرسل أبدًا وفيها عنصر نائب خام، ومفاتيح idempotency تحوّل الطلب المعاد إلى إعادة للاستجابة الأصلية بدلًا من رسالة إضافية، وأحداث تسليم يمكنك عرضها في واجهتك الخاصة.
لماذا يحتاج بريد المصادقة إلى عناية أكبر
هناك من ينتظر
المستخدم على شاشة تسجيل الدخول لديك. الرمز الذي لا يصل أبدًا، أو يصل مرتين، يتحول إلى تذكرة دعم أو تسجيل ضائع.
الجهات المستقبلة تتحقق من المرسل
يتحقق مزودو صناديق البريد من SPF وDKIM وDMARC. تعرض لك MailLand السجلات الواجب نشرها، وتوقّع كل رسالة بمفتاح DKIM الخاص بنطاقك.
خطأ إملائي واحد يعطّل المسار
عنوان مكتوب خطأً عند التسجيل يعني أن كل رمز لاحق لن يصل إلى أي مكان. اكتشف الخطأ عند إدخال العنوان، لا بعد أول محاولة دخول فاشلة.
رمز لمرة واحدة، مُرسل من قالب مخزن
يدخل الرمز بوصفه متغيرًا خاصًا بالمستلم. ومفتاح idempotency يجعل إعادة المحاولة بعد انتهاء المهلة آمنة.
curl -X POST https://api.mail.land/v1/transactional/send \
-H "X-API-Key: ml_pet_..." \
-H "X-Idempotency-Key: signin-7f3a9c-1" \
-H "Content-Type: application/json" \
-d '{
"from": { "email": "[email protected]", "name": "Your App" },
"to": [{
"email": "[email protected]",
"variables": { "code": "482913" }
}],
"templateId": "t8x2m4q9zk7wpr",
"variables": { "expiresInMinutes": "10" },
"tags": ["sign-in-code"]
}'ما تقدمه لك MailLand لبريد تسجيل الدخول
قوالب ترفض إرسال رسالة معطوبة
احتفظ بقوالب إعادة التعيين والرموز والروابط السحرية في MailLand واملأ {{placeholders}} لكل طلب. القيمة الناقصة توقف الإرسال برمز 422 يسمّي المتغير.
إعادة المحاولة دون تكرار
أرسل X-Idempotency-Key مع كل رمز. إذا انتهت مهلة طلبك وأعدت المحاولة بالمفتاح نفسه خلال 24 ساعة، تعيد MailLand الاستجابة الأصلية ولا ترسل شيئًا.
الحماية من الأخطاء الإملائية والنطاقات المؤقتة
فعّل الحماية لمسار المعاملات لديك، فترفض MailLand العناوين لدى مزودي البريد المؤقت أو التي يُرجَّح وجود خطأ إملائي في نطاقها، وتقترح العنوان المصحح.
التحقق عند التسجيل
استدعِ واجهة التحقق عند تسجيل المستخدم. فهي تفحص الصياغة، والأخطاء الإملائية المرجحة، والنطاقات المؤقتة، والحسابات الوظيفية مثل info@، وخادم البريد المستقبل.
أحداث تسليم لواجهتك
تصل أحداث التسليم والتأجيل والارتداد والفشل إلى webhook الخاص بك، فيستطيع تطبيقك أن يطلب من المستخدم التحقق من العنوان أو المحاولة مجددًا.
الروابط كما كتبتها
تتبّع الفتح والنقر معطّل افتراضيًا لبريد المعاملات، لذا ما لم تفعّل التتبّع، تصل روابط إعادة التعيين والروابط السحرية إلى المستخدمين كما كتبتها تمامًا.
يُرسل من نطاقك الخاص
أضف نطاقك، وانشر سجلات SPF وDKIM وDMARC التي تعرضها لوحة التحكم، وتتحقق MailLand منها قبل أن تتمكن من الإرسال. ويحصل كل نطاق تلقائيًا على مفتاح DKIM خاص به من نوع RSA بطول 2048 بت.
ما لا نعد به
لا ننشر أي رقم لزمن التسليم: خادم البريد المستقبل هو من يقرر متى يقبل الرسالة. ما تقدمه لك MailLand هو سجل كامل لما حدث لكل رسالة ومتى.
أسئلة حول بريد المصادقة
متى سيصل الرمز؟
لا ننشر وعدًا بزمن التسليم. تردّ الواجهة بمجرد إدراج الرسالة في قائمة الانتظار، وتذكر الاستجابة وقت ذلك. ثم يخبرك حدث التسليم أو التأجيل متى قبل خادم المستلم الرسالة أو طلب إعادة المحاولة.
كيف أتعامل مع ضغط المستخدم على زر إعادة الإرسال؟
عامِل كل رمز جديد على أنه طلب جديد بمفتاح idempotency جديد. ولا تُعِد استخدام المفتاح إلا عند إعادة الطلب نفسه بعد انتهاء المهلة: خلال 24 ساعة، تعيد تلك المحاولة الاستجابة الأصلية ولا ترسل شيئًا.
هل يمكنني حجب العناوين المؤقتة عند التسجيل؟
نعم، بطريقتين. فعّل الحماية من النطاقات المؤقتة لمسار المعاملات، أو استدعِ واجهة التحقق قبل إنشاء الحساب.
هل يمكنني اختبار المسار دون مراسلة مستخدمين حقيقيين؟
نعم. يقبل مفتاح sandbox كل طلب ويسجله دون تسليمه، أو يسلّم فقط إلى قائمة سماح من العناوين التي تختارها.
هل يمكن لإلغاء الاشتراك التسويقي أن يوقف رسائل إعادة تعيين كلمة المرور؟
لا. ينطبق إلغاء الاشتراك على البريد التسويقي أو على قائمة واحدة، ولا يمنع بريد المعاملات إلى ذلك العنوان.
أرسل أول رمز تسجيل دخول اليوم
أنشئ حسابًا مجانيًا، وتحقق من نطاقك، وخزّن قالبك الأول. 1,000 رسالة شهريًا مجانًا.