Mini ders · Türkçe

Web sitenizden otomatik e-posta nasıl gönderirsiniz?

Verilen e-posta projesini asistanla çalıştırın, kontrollü bir doğrulama iletisi gönderin ve gelen kutunuza ulaştığını doğrulayın.

Etkileşimli derse başlaDers notlarını oku

Bu ders kimler için?

Web sitesindeki bir işlemin e-posta göndermesini isteyenler için. Sunucu kodu verilir ve kodlama asistanı yapılandırabilir; e-posta arka ucu yazmanız gerekmez.

Başlamadan önce

Kendi Resend hesabınız, doğrulanmış gönderici ve bir test gelen kutusu gerekir. Kurulum için ayrı, eksiksiz Netlify function projesini ve bir kodlama asistanını kullanın. Sağlayıcı erişimi ve kullanım koşulları geçerlidir. Örnek cevaplar, hesabınızda tamamlanmış testler değildir; bir cevabın nasıl yazılabileceğini gösterir. Örnekteki gözlemlerin yerine kendi sonuçlarınızı yazın ya da hangi adımda takıldığınızı belirtin.

Tahmini süre: 21–38 dk

Hazır örnek dosyalarla, gerekli hesap ve araçlar kurulmuşken çalışma tahmini. Kurulum, yayınlanma sırası ve e-posta/DNS beklemeleri ayrıca zaman alabilir. Gönderici doğrulama ve e-posta bekleme süreleri ayrıca eklenir. Ücret ve sınırlar sağlayıcı hesabınıza bağlıdır.

Neler öğreneceksin?

  • Kontrolünüzde bir gönderici ve alıcı yapılandırın.
  • Gerçek bir test e-postasını tetikleyip teslimi inceleyin.
  • İleti ulaşmış gibi davranmadan başarısız istekleri ele alın.

Uygulama dosyaları

Adım 1

Tek bir e-posta işlemi seçin

Sabit, kontrolünüzde bir doğrulama iletisiyle başlayın.

Verilen projeyi asistanınızla açın ve hangi olayın test doğrulamasını göndereceğine karar verin. Yalnızca yapılandırılmış site sahibi gelen kutusunu kullanın; ziyaretçi rastgele alıcı seçememelidir.

İsteğin sağlayıcı tarafından kabul edilmesini iletinin gelen kutusuna ulaşmasından ayırın.

Somut bir örnek

Sağlanan işlem, sunucuda ayarlı alıcıya sabit Workshop confirmation mesajını gönderir. Form ziyaretçisi keyfi hedef değil, ad verir. Dönen mesaj referansı iz sürmeye yardımcı olur ama ulaşmayı doğrulamaz.

Bu tam e-posta atölyesini aç. run-locally.txt dosyasını izle; özel gönderici, alıcı, sağlayıcı anahtarı ve alıştırma kodu değerlerini açıkla. Bunları herkese açık dosyalara koyma. Projeyi çalıştırmama ve yalnızca yapılandırılmış kendi test gelen kutuma gönderimi tetiklememe yardım et. Reddedilen bir deneme dâhil sağlayıcı kabulünü ve gerçek gelen kutusu teslimini ayrı incele.

Resend: e-posta gönderme

Bu adımda kullanılan dosyalar

Start hereUygulama dosyaları

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Sitedeki bir işlemden sonra e-posta gönderin

Sunucu işlevi kabul edilen isteği e-posta sağlayıcısına yapılan çağrıya dönüştürür.

Tarayıcı ayrıcalıklı e-posta anahtarınızı tutmamalı, belirli bir işlem istemelidir. Bu alıştırmada bir adı sunucuya gönderir; sunucu kendi ayarladığınız kutuya düz metin onayı yollar.

Açıklanan yöntem Resend kullanır. Başka işlem e-postası sağlayıcısı aynı işi yapabilir ama kimlik doğrulama, gönderici ayarı ve teslim olayları farklıdır. İnsanların okuyup yanıtladığı e-posta kutusu ayrı hizmettir.

Çözülmüş örnek

“accepted” yanıtı, sağlayıcının gönderim isteğini kabul ettiğini söyler. Mesajın kutuya ulaştığını kanıtlamaz. Bu aşamayı ayrıca kontrol edeceğiz.

Resend: e-posta gönderme

Extra implementation exercise

Sağlayıcı mesaj ID’si döndürdü ama kutuya bakmadınız. Dürüstçe ne söyleyebilirsiniz?

Çözülmüş örneği göster

Sağlayıcı bu referansla bir isteği kabul etti. Teslim bilgilerine ve deneme kutusuna bakana kadar ulaşma doğrulanmış değildir.

  • Kutuda teslimi değil, sağlayıcı kabulünü doğruladığını söyler.
  • Teslimi kontrol etmek için mesaj referansını saklar.

Adım 2

Hazır projeyi yapılandırıp başlatın

Sunucu bağlantılarını asistan kursun.

Asistanınızla run-locally.txt dosyasını izleyin. server-env.example.txt yardımıyla hesabın özel değerlerini girin; tam projeyi başlatıp gerçek yerel URL'sini açın.

Sağlayıcı anahtarı ve sabit alıcı sunucuda kalsın. Formdaki alıştırma kodu sağlayıcı anahtarından ayrıdır; dosya önizlemesi e-posta hizmetini çalıştırmaz.

Somut bir örnek

Sunucu değerleri göndericiyi, alıcıyı ve sağlayıcı erişimini seçer. Ayrı deneme kodu yalnızca site sahibinin yapacağı bu teste izin verir. Ne gizli tarayıcı alanı ne de düz dosya önizlemesi bu özel sunucu kurulumunu gerçekleştirir.

Node.js: desteklenen sürümlerin durumu

Bu adımda kullanılan dosyalar

Start hereUygulama dosyaları

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Bir kısıtlı deneme göndericisi ayarlayın

Gönderici anahtarını ve deneme alıcısını açık klasörün dışında tutun.

Yerel kontrol sırası: Node ve npm kurulu mu bakın, Netlify CLI’yi kurup doğrulayın, formdan göndermeden önce run-locally.txt izleyin. Statik sayfayı önce açmak düzeni görmek için yararlıdır ama sunucu işlevini test etmez.

netlify/functions/mini-mail.mjs okuyun. Kendi barındırma projenizde e-posta ortam değişkenleriyle en az 24 karakterlik tahmin edilemez LAB_TOKEN ayarlayın. MAIL_FROM sağlayıcıda yetkili olmalı; TEST_RECIPIENT deneme kutunuzdur. API anahtarını public/app.js içine yazmayın.

Kişi bu kısıtlı uygulamanın ayrı erişim kodunu girer; kod sayfaya dahil edilmez ve Resend anahtarı değildir. İşlev istemcinin verdiği hedefleri bilerek yok sayar, kısa ad alanını doğrular ve düz metin hazırlar. Herkese açmadan kalıcı istek sınırları ekleyip kotayı inceleyin; yalnızca sahibine açık bu örnek tam kötüye kullanım koruması değildir.

Alıcı adresi bilinçli olarak sunucunun kontrolünde tutulur. Değiştirilmiş bir tarayıcı isteğine to='somewhere-else' eklenebilir; ancak fonksiyon, sağlayıcıya göndereceği veriyi kendisi oluşturur ve TEST_RECIPIENT değerini kullanır. Böylece çağrıyı yapan kişi bu özelliği istediği herhangi bir adrese e-posta göndermek için kullanamaz. Herkese açık erişimde kötüye kullanıma karşı kalıcı denetimler yine gerekir.

Yerel çalışma sırasının tamamı için run-locally.txt dosyasını açın: kökteki özel ortamı hazırlayın, yalnızca deneme projesini bağlayın ve Netlify işlevlerine istek ileten yerel aracı başlatın. server-env.example.txt gerçek sırlar olmadan değişken adlarını listeler. Yalnızca HTML’yi açmak sunucuyu çalıştırmaz.

Çözülmüş örnek

İsteği değiştiren kişi bu e-postayı başka yere yönlendiremez; alıcı sunucu ortamından gelir. Adresi JavaScript’te gizlemek aynı korumayı sağlamaz.

const {RESEND_API_KEY, MAIL_FROM, TEST_RECIPIENT} = process.env;
// Send only to TEST_RECIPIENT in this lab.

Node.js: desteklenen sürümlerin durumu

Extra implementation exercise

Anahtarı gizli form alanına taşımak özel tutar mı?

Çözülmüş örneği göster

Hayır. Gizli alanlar da tarayıcıya gönderilir. Anahtarı sunucuda tutup sağlayıcı çağrısını orada yapın.

  • Tarayıcıya gönderilmiş değerlerin incelenebildiğini fark eder.
  • Ayrıcalıklı kullanımı sunucu ortamına taşır.

Adım 3

Tanınabilir tek bir test gönderin

Arayüzü kullanın ve kanıtları birbiriyle ilişkilendirin.

Gerçekten çalışan sayfadan doğrulama iletisini tetikleyin. Test referansını kaydedin ve ilgili sağlayıcı olayını ve gelen kutusu kopyasını inceleyin.

İstek başarısızsa hatayı görünür tutun ve yeniden denemeye yetecek bağlamı saklayın. Kullanılamayan hizmeti, başarı iletisi uydurarak düzeltmeyin.

Somut bir örnek

Hayali Alex adı için başlangıç e-postasının metni “Hello Alex. Your practice request was received.” şeklindedir. Eski bir e-postayı değil, gerçekten alınan kopyayı ilgili denemeyle karşılaştırın.

Bu adımda kullanılan dosyalar

Start hereUygulama dosyaları

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Verilen isteği ve yanıtı izleyin

Düğme JSON gönderir; sunucu denetler ve gerçekten olanı anlatan durum döndürür.

Ayrı projeyi yayımlayın veya barındırma hizmetinin yerel işlev araçlarıyla çalıştırın. index.html dosyasını açmak sunucuyu çalıştırmaz. Uydurma deneme adı gönderip ağ yanıtını inceleyin.

Sunucu bozuk girişte 400, eksik ayarda 503, sağlayıcı çağrısı başarısızsa 502, mesaj kabul edilirse 202 verir. Tarayıcı hatayı ele alır, e-posta ulaşmış gibi davranmaz.

Çözülmüş örnek

Örnek arayüz “Accepted by the mail provider. Check your test inbox.” der; yani sağlayıcı kabul etti, deneme kutunuzu kontrol edin. Sunucunun o anda bildiğiyle uyumludur.

Extra implementation exercise

İşlev 503 döndürüyor. Önce düğmenin rengini mi, sunucu ortamını mı kontrol etmelisiniz?

Çözülmüş örneği göster

Ayarlanan değişkenleri ve göndericiyi kontrol edin. Arayüz görünümü eksik sunucu anahtarını sağlayamaz.

  • Önce eksik sunucu ayarına bakar.
  • Başarısız isteği tamamlanmış e-posta saymaz.

Adım 4

Eksik iletiyi araştırın

Tekrar tekrar göndermeden önce teslim durumuna bakın.

Test referansını sağlayıcı durumu, hedef ve gelen kutusu/spam kontrolüyle eşleştirmek için delivery-record.txt dosyasını kullanın. Başarısız aşama için asistanınızdan yardım isteyin.

Geri dönen ileti veya reddedilen hedef araştırılmalıdır. Aynı gönderimi körü körüne tekrarlamak, teslimi düzeltmeden gürültü yaratabilir.

Somut bir örnek

Kabul edildi → geri döndü → gelen kopya yok zinciri teslimatı araştırmaya götürür. Deneme kodu reddedildi → sağlayıcı olayı yok zinciri erişim ayarlarına götürür. Bu gözlemler farklı sonraki kontroller gerektirir.

Bu adımda kullanılan dosyalar

Start hereUygulama dosyaları

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Teslimi ve hatayı doğrulayın

Bir tıklamayı, sağlayıcı referansını ve gerçekten gelen mesajı ilişkilendirin.

Kabul edilen mesajı sağlayıcı etkinliklerinde bulup teslim durumunu inceleyin. Sonra spam dahil ayarlanan kutuyu kontrol edin. Kabul ve alınan kopya gözlemlerini ayrı kaydedin.

Normal formda boş ad, geliştirici isteğinde bozuk JSON deneyin. Ayrı gözden çıkarılabilir ayarda eksik anahtarın anlaşılır hata verdiğini doğrulayın. Hesap bilgisi içerebilecek sağlayıcı yanıt gövdelerini paylaşmayın.

Çözülmüş örnek

Teslim olayı ve ona uyan alınmış mesaj, yeşil düğmeden güçlü kanıttır. Sağlayıcı kabul etmiş ama kopya gelmemişse teslim sorunu çözülmemiştir.

Extra implementation exercise

Sağlayıcı deneme mesajının teslim edilemeyip geri döndüğünü bildiriyor. Hemen aynı gönderimi tekrarlamak en iyi adım mı?

Çözülmüş örneği göster

Önce bildirilen hatayı ve alıcı ayarını inceleyin. Neyin değiştiğini belirledikten sonra tekrar deneyin; aynı mesajı yeniden göndermek geçersiz hedefi düzeltmez.

  • Teslim edilememe nedenini ve hedefi inceler.
  • Neden değişmeden aynı isteği tekrarlamaktan kaçınır.

Adım 5

Faydalı bir ileti konusu ekleyin

Davranışı anlatın ve asistanın uygulamasını sağlayın.

Asistandan iki konu seçeneği eklemesini isteyin: Değerleri project ve question olan Project ve Question. Sabit sunucu alıcısını ve özel anahtarı koruyarak seçilen değeri onay mesajının gövdesine ekleyin. other adlı desteklenmeyen değeri izinli seçenek yapmadan test etmek için asistandan yardım alın.

İzinli seçenek başına bir kontrollü test gönderin ve gerçekten gelen metni inceleyin. Desteklenmeyen konu ve yanlış deneme kodu sağlayıcı gönderimi olmadan reddedilmeli; bu olumsuz denemeleri ayrı kontrol edin.

Somut bir örnek

Görevin izinli iki seçeneği Project ve Question; project ve question olarak saklanır. Seçilen değer e-posta gövdesine ulaşmalı. Other, eklenmesi gereken üçüncü seçenek değil, bilerek desteklenmeyen test değeridir.

Bu adımda kullanılan dosyalar

Start hereUygulama dosyaları

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Ödeviniz: onaya anlamlı bir ayrıntı ekleyin

Rastgele alıcı veya HTML kabul etmeden kısa konu bilgisi ekleyin.

İki değere izin veren topic alanı ekleyin. Sunucu bu listeyi doğrulasın ve seçileni düz metin onaya eklesin. Alıcı ortamda sabit kalsın.

İzinli iki değer için birer, desteklenmeyen değer için de bir deneme gönderin. Sağlayıcı referansını ve gerçek teslim kanıtını kaydedin.

Önce kendi başlangıç dosyalarınızı düzenleyin. Sonra topic seçimini, JSON isteğini ve sunucu izin listesini referansla satır satır karşılaştırın. Referans klasörü, çalışmanızı kontrol etmek için tam alternatiftir; public/ içine düşünmeden yapıştırılacak başka klasör değildir.

Çözülmüş örnek

Yalnızca “project” ve “question” kabul etmek, istemcinin her yazdığını e-postanın bütün alanlarına kopyalamaktan daha kolay denetlenir.

Çözümün bütün adımlarını reference/assignment-walkthrough.txt dosyasında bulabilirsiniz. Adımları kendi sonucunuzla karşılaştırın; kontrol kaydını kendi projenizde gözlemlediklerinizle doldurun.

Extra implementation exercise

Onaya doğrulanan konuyu ekleyip başarılı ve reddedilen istekleri gösterin.

Çözülmüş örneği göster

Konu ekinde tam olarak 'project' ve 'question' kullanılır. Forma select ekleyin, JSON’a topic koyun ve sağlayıcıyı çağırmadan sunucuda listeyi doğrulayın. Referans tarayıcı kodu ve işlev tüm değişikliği gösterir.

Değiştirilmiş istek başka adres verse bile TEST_RECIPIENT sunucunun kontrolünde kalsın. İzinli konu ve doğru kod sağlayıcı kabulüne ulaşabilir; desteklenmeyen konu çağrı yapılmadan 400 vermeli. Kabul, kutuda alınmış mesaj değildir.

İki konuyu kendi deneme hesabınızla gönderin, sağlayıcı referansını gerçek gelen mesajla eşleştirin; geri dönme veya beklemeyi dürüstçe yazın. Referans kodu kısıtlı alıştırma ekidir, herkese açık e-posta aktarıcısı değildir.

  • Sunucu desteklenmeyen konuyu reddeder, sabit alıcıyı korur.
  • İzinli iki konu da karşılık gelen alınmış mesajlarda görünür.

Ders işine yaradı mı?

Beğenebilir, faydalanacağını düşündüğün biriyle paylaşabilirsin.

Öğrenmeye devam edin

Diğer dersleri inceleyin