
Mini ders 9 / 30 · Sitenizi daha kullanışlı yapın
Tek bir e-posta işlemi seçin
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.
Sabit, kontrolünüzde bir doğrulama iletisiyle başlayın.
Bu derste ne öğreneceksiniz?
- 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.
Açıklama, çözülmüş örnek ve alıştırma
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.
Başlamak için gereken beceriler
Bu dersleri bitirmiş olmanız şart değil; gereken beceriler sizde zaten varsa buradan başlayabilirsiniz. Hazır değilseniz bağlantılardaki hazırlık derslerini açın. Başlangıç dosyaları verildiği için önceden kişisel bir siteniz olması gerekmiyor.
- Web sitenizi GitHub üzerinden nasıl yayımlarsınız?
Bir alıştırma deposunu barındırma hizmetine bağlayın.
- Kendi alan adınızla e-posta nasıl kurulur
Gerçek, iki yönlü bir posta kutusu seçip yapılandırın.
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.
Konuyu anlayalım
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.Bu adımda kullanılan dosyalar
Buradan başlayınUygulama dosyaları
Dosyaları aşağıdan açabilir veya tek tek indirebilirsin. Projeyi kaydederken dosya adlarında gösterilen klasör yapısını koru.
Sıra sizde
Testi hangi işlem başlatacak? Gönderim isteğinin kabul edildiğini ve e-postanın gelen kutusuna ulaştığını nereden kontrol edeceksiniz?
Çözülmüş örneği göster
Örnek plan: Deneme erişim kodunu ve hayali Alex adını girip Request test email düğmesini kullanacağım. Sunucuda ayarlı TEST_RECIPIENT, denetimli gelen kutum. Dönen sağlayıcı referansını onun olayıyla ve gerçekten ulaşan e-postayla eşleştireceğim.
İyi bir cevap neleri içermeli?
- Belirli denetimli form işlemini ve sunucuda ayarlı hedefi belirtir.
- Sağlayıcının kabulünü ve gerçek gelen kutusu ulaşmasını ayrı doğrulama noktaları olarak söyler.
Nasıl çalışır? (isteğe bağlı)
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.
Ek teknik alıştırma
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 1 · Web sitenizden otomatik e-posta nasıl gönderirsiniz?
Hazır projeyi yapılandırıp başlatın
Sunucu bağlantılarını asistan kursun.
Açıklama, çözülmüş örnek ve alıştırma
Konuyu anlayalım
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.
Bu adımda kullanılan dosyalar
Buradan başlayınUygulama dosyaları
Dosyaları aşağıdan açabilir veya tek tek indirebilirsin. Projeyi kaydederken dosya adlarında gösterilen klasör yapısını koru.
Sıra sizde
Proje başladı mı; hangi yapılandırma adımı tamamlandı, hangisi hâlâ engelli?
Çözülmüş örneği göster
Örnek kurulum kaydı: Yerel proxy başladı ve uygulama adresini yazdırdı. Özel ortamda doğrulanmış göndericim, denetimli alıcım, sağlayıcı anahtarım ve ayrıca üretilmiş deneme kodum var. Forma yalnızca bu deneme kodu girer. Uygulama Mail not configured diyorsa özel gönderici/anahtar/alıcı kurulumu hâlâ eksik.
İyi bir cevap neleri içermeli?
- Eksiksiz sunucu destekli projenin yazdırdığı adreste başlayıp başlamadığını bildirir.
- Özel sağlayıcı anahtarını ve sabit alıcıyı, formun ayrı deneme kodundan ayırır.
Nasıl çalışır? (isteğe bağlı)
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
Ek teknik alıştırma
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 2 · Web sitenizden otomatik e-posta nasıl gönderirsiniz?
Tanınabilir tek bir test gönderin
Arayüzü kullanın ve kanıtları birbiriyle ilişkilendirin.
Açıklama, çözülmüş örnek ve alıştırma
Konuyu anlayalım
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
Buradan başlayınUygulama dosyaları
Dosyaları aşağıdan açabilir veya tek tek indirebilirsin. Projeyi kaydederken dosya adlarında gösterilen klasör yapısını koru.
Sıra sizde
Denemenizde sayfa, sağlayıcı ve gelen kutusu ayrı ayrı ne gösterdi?
Çözülmüş örneği göster
Örnek deneme kaydı: Sayfa bir referansla sağlayıcı kabulünü bildirdi. Eşleşen sağlayıcı olayı var. Denetimli gelen kutumda, “Hello Alex. Your practice request was received.” içeren Workshop confirmation var. Gelen kopya eksik olsaydı kabul edildi ama teslimat çözülmedi diye kaydedecektim.
İyi bir cevap neleri içermeli?
- Aynı deneme için sayfa yanıtını, sağlayıcı olayını ve gerçek gelen kutusu sonucunu eşleştirir.
- Hatayı veya kabul edilmiş kimliği teslimat iddiasına çevirmeden başarısız aşamayı belirtir.
Nasıl çalışır? (isteğe bağlı)
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.
Ek teknik alıştırma
İş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 3 · Web sitenizden otomatik e-posta nasıl gönderirsiniz?
Eksik iletiyi araştırın
Tekrar tekrar göndermeden önce teslim durumuna bakın.
Açıklama, çözülmüş örnek ve alıştırma
Konuyu anlayalım
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
Buradan başlayınUygulama dosyaları
Dosyaları aşağıdan açabilir veya tek tek indirebilirsin. Projeyi kaydederken dosya adlarında gösterilen klasör yapısını koru.
Sıra sizde
Gözlemlenen hangi teslim durumu testinizdeki sonraki işlemi açıklıyor?
Çözülmüş örneği göster
Örnek teşhis: Sağlayıcı denemeyi kabul etti ama olay artık geri dönüş gösteriyor ve denetimli gelen kutusunda kopya yok. Başka gönderimden önce ayarlı hedefi ve o teslimat olayını inceleyeceğim. Bu, posta sağlayıcısına hiç ulaşmaması gereken reddedilmiş deneme kodundan farklı.
İyi bir cevap neleri içermeli?
- Geçerli teslimat durumunu teşhis etmek için eşleşen sağlayıcı durumunu ve hedef/gelen kutusu kontrollerini kullanır.
- Körü körüne tekrar göndermek yerine gözlenen hata aşamasında bir sonraki işlemi seçer.
Nasıl çalışır? (isteğe bağlı)
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.
Ek teknik alıştırma
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 4 · Web sitenizden otomatik e-posta nasıl gönderirsiniz?
Faydalı bir ileti konusu ekleyin
Davranışı anlatın ve asistanın uygulamasını sağlayın.
Açıklama, çözülmüş örnek ve alıştırma
Konuyu anlayalım
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
Buradan başlayınUygulama dosyaları
Dosyaları aşağıdan açabilir veya tek tek indirebilirsin. Projeyi kaydederken dosya adlarında gösterilen klasör yapısını koru.
- netlify/functions/mini-mail.mjsBu dosyayı indir
- delivery-record.txtBu dosyayı indir
- worksheet.htmlBu dosyayı indir
- reference/assignment-walkthrough.txtBu dosyayı indir
- reference/START-HERE.txtBu dosyayı indir
- reference/public/index.htmlBu dosyayı indir
- reference/public/app.jsBu dosyayı indir
- reference/netlify/functions/mini-mail.mjsBu dosyayı indir
Sıra sizde
Konu değişikliğinizi ve gerçek başarılı ve reddedilen test sonuçlarını sunun.
Hazırlanacak çıktı: Çalışan test işlemi ve hassas bilgileri çıkarılmış sağlayıcı/gelen kutusu/hata kaydı.
Çözülmüş örneği göster
Örnek geliştirme kaydı: Project, “Hello Alex. Your project request was received.” mesajını üretti. Question ise ayrı denetimli e-postada ilgili question metnini üretti. Desteklenmeyen other konusu ve yanlış deneme kodu, eşleşen sağlayıcı gönderimi olmadan reddedildi. İki izinli seçenek de hâlâ sabit ayarlı alıcıyı kullanıyor.
İyi bir cevap neleri içermeli?
- Tam olarak Project/Question seçeneklerini ekler ve seçilen değeri gerçekten alınan içerikte doğrular.
- Desteklenmeyen konu ile yanlış deneme kodunun mesaj göndermediğini kontrol eder.
Nasıl çalışır? (isteğe bağlı)
Ö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.
Ek teknik alıştırma
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.