پرش به محتوای اصلی
MailLand

ایمیل احراز هویت

بازیابی رمز عبور، کد یک‌بارمصرف و لینک جادویی، هر کدام با یک فراخوانی 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"]
  }'
اگر {{code}} مقداری نداشت، MailLand به‌جای ارسال ایمیلی خراب، درخواست را با 422 TEMPLATE_VARIABLE_MISSING رد می‌کرد.

آنچه MailLand برای ایمیل ورود در اختیارتان می‌گذارد

  • قالب‌هایی که پیام خراب نمی‌فرستند

    قالب‌های بازیابی رمز، کد و لینک جادویی را در MailLand نگه دارید و {{placeholders}} را برای هر درخواست پر کنید. مقدار جاافتاده ارسال را با خطای 422 متوقف می‌کند و نام متغیر را اعلام می‌کند.

  • تلاش دوباره بدون ارسال تکراری

    با هر کد یک X-Idempotency-Key بفرستید. اگر درخواست شما با قطع ارتباط مواجه شد و در ۲۴ ساعت با همان کلید دوباره تلاش کردید، MailLand همان پاسخ اولیه را برمی‌گرداند و چیزی نمی‌فرستد.

  • محافظت در برابر غلط تایپی و دامنه‌های یک‌بارمصرف

    محافظت را برای جریان تراکنشی خود روشن کنید تا MailLand نشانی‌های ارائه‌دهندگان یک‌بارمصرف یا نشانی‌هایی با غلط تایپی محتمل در دامنه را رد کند و نشانی اصلاح‌شده را پیشنهاد دهد.

  • اعتبارسنجی هنگام ثبت‌نام

    هنگام ثبت‌نام کاربر، API اعتبارسنجی را فراخوانی کنید. این API نحو نشانی، غلط‌های تایپی محتمل، دامنه‌های یک‌بارمصرف، حساب‌های نقش‌محور مانند info@ و سرور ایمیل گیرنده را بررسی می‌کند.

  • رویدادهای تحویل برای رابط کاربری شما

    رویدادهای تحویل، تعویق، برگشت و شکست به وب‌هوک شما می‌رسند تا اپلیکیشن بتواند به کاربر بگوید نشانی را بررسی کند یا دوباره تلاش کند.

  • پیوندها همان‌طور که نوشته‌اید

    ردیابی باز شدن و کلیک برای ایمیل تراکنشی به‌طور پیش‌فرض خاموش است، پس تا وقتی ردیابی را روشن نکنید، لینک‌های بازیابی و لینک‌های جادویی دقیقاً همان‌طور که نوشته‌اید به دست کاربران می‌رسند.

ارسال از دامنه خودتان

دامنه‌تان را اضافه کنید، رکوردهای SPF، DKIM و DMARC را که پنل نشان می‌دهد منتشر کنید و MailLand پیش از اینکه بتوانید ارسال کنید آن‌ها را تأیید می‌کند. هر دامنه به‌طور خودکار کلید DKIM اختصاصی RSA با طول ۲۰۴۸ بیت دریافت می‌کند.

آنچه تعهد نمی‌کنیم

هیچ رقمی برای زمان تحویل منتشر نمی‌کنیم: سرور ایمیل گیرنده تصمیم می‌گیرد پیام را چه زمانی بپذیرد. آنچه MailLand به شما می‌دهد سابقه کاملی است از اینکه چه بر سر هر پیام آمده و چه زمانی.

پرسش‌های رایج درباره ایمیل احراز هویت

کد چقدر طول می‌کشد تا برسد؟

برای زمان تحویل تعهدی منتشر نمی‌کنیم. API وقتی پیام وارد صف شد پاسخ می‌دهد و پاسخ زمان آن را اعلام می‌کند. سپس رویداد تحویل یا تعویق به شما می‌گوید سرور گیرنده چه زمانی پیام را پذیرفته یا درخواست تلاش دوباره کرده است.

وقتی کاربر دکمه ارسال دوباره را می‌زند چه کنم؟

هر کد تازه را درخواستی تازه با کلید idempotency تازه در نظر بگیرید. فقط وقتی همان درخواست را پس از قطع ارتباط دوباره می‌فرستید از کلید قبلی استفاده کنید: در ۲۴ ساعت، آن تلاش دوباره همان پاسخ اولیه را برمی‌گرداند و چیزی نمی‌فرستد.

می‌توانم نشانی‌های یک‌بارمصرف را هنگام ثبت‌نام مسدود کنم؟

بله، به دو روش. محافظت در برابر دامنه‌های یک‌بارمصرف را برای جریان تراکنشی روشن کنید، یا پیش از ساختن حساب، API اعتبارسنجی را فراخوانی کنید.

می‌توانم جریان را بدون ایمیل زدن به کاربران واقعی آزمایش کنم؟

بله. کلید sandbox هر درخواست را می‌پذیرد و ثبت می‌کند اما تحویل نمی‌دهد، یا فقط به فهرست مجازی از نشانی‌هایی که خودتان انتخاب می‌کنید تحویل می‌دهد.

آیا لغو اشتراک بازاریابی می‌تواند ایمیل‌های بازیابی رمز عبور را متوقف کند؟

خیر. لغو اشتراک به ایمیل بازاریابی یا به یک فهرست اعمال می‌شود و ایمیل تراکنشی به آن نشانی را متوقف نمی‌کند.

اولین کد ورودتان را همین امروز بفرستید

حساب رایگان بسازید، دامنه‌تان را تأیید کنید و اولین قالبتان را ذخیره کنید. ماهانه ۱٬۰۰۰ ایمیل رایگان است.