
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.
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.
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.Bu adımda kullanılan 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.
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.
Sık yapılan hata
Başarılı API çağrısından hemen sonra “Delivered” (teslim edildi) göstermek.
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
Sıra sizde
Proje başladı mı; hangi yapılandırma adımı tamamlandı, hangisi hâlâ engelli?
Cevabını ders asistanıyla değerlendir
Çö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.
- 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.
Bu adımda kullanılan 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.
Sık yapılan hata
Sayfa göstermiyor diye değeri gizli sanmak.
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.
Sıra sizde
Denemenizde sayfa, sağlayıcı ve gelen kutusu ayrı ayrı ne gösterdi?
Cevabını ders asistanıyla değerlendir
Çö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.
- 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.
Bu adımda kullanılan 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.
Sık yapılan hata
Sunucuyu yalnızca HTML dosyasını açarak test etmek.
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.
Sıra sizde
Gözlemlenen hangi teslim durumu testinizdeki sonraki işlemi açıklıyor?
Cevabını ders asistanıyla değerlendir
Çö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ı.
- 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.
Bu adımda kullanılan 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.
Sık yapılan hata
İstek sağlayıcıya ulaşıp daha sonra hata verdiğinde HTML’yi kurcalamak.
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.
Sıra sizde
Başlangıç malzemeleri
Başlangıç dosyaları ve deneme içerikleri hazır. Gerçek servis doğrulaması için Başlamadan önce bölümünde belirtilen kendi hesabınız, gelen kutunuz veya alan adınız gerekir. Bunlar olmadan dosyaları inceleyebilirsiniz; gerçekten denemediğiniz canlı adımı denenmedi diye kaydedin.
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ı.
Cevabını ders asistanıyla değerlendir
Çö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.
- 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.
Bu adımda kullanılan dosyalar
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
- 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
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.
Sık yapılan hata
select alanını tek doğrulama noktası saymak.
Ders işine yaradı mı?
Beğenebilir, faydalanacağını düşündüğün biriyle paylaşabilirsin.
Öğrenmeye devam edin
- İlk kişisel web sitenizi nasıl kurarsınız?
- Web sitenizi GitHub üzerinden nasıl yayımlarsınız?
- Kendi alan adınızı web sitenize nasıl bağlarsınız?
- Kendi alan adınızla e-posta nasıl kurulur
- Web sitenizi telefonda rahat kullanılır hale nasıl getirirsiniz?
- Web sitenizdeki görsellerin daha hızlı yüklenmesini nasıl sağlarsınız?
- Sitenize gelen geri bildirimler gelen kutunuza nasıl ulaşır
- Sitenize e-posta aboneliği nasıl eklenir
- Formdan gelen bilgileri veritabanına nasıl kaydedersiniz?
- İnsanların web sitenizde oturum açmasını nasıl sağlarsınız?
- Bir sayfayı nasıl yalnızca izin verilen kişilere açarsınız?
- Kullanıcıların profil bilgilerini düzenlemesini nasıl sağlarsınız?
- Kullanıcıların görsel yüklemesini nasıl sağlarsınız?
- API anahtarlarını tarayıcıya göndermeden nasıl kullanırsınız?
- Başka bir API’den gelen veriyi web sitenizde nasıl gösterirsiniz?
- Web sitenize yapay zekâ sohbeti nasıl eklersiniz?
- Sohbetin kendi içeriğinize dayanarak yanıt vermesini nasıl sağlarsınız?
- Web sitenize nasıl blog eklersiniz?
- Web sitenize nasıl arama eklersiniz?
- Web sitenize nasıl başka bir dil eklersiniz?
- Google’ın sitenizi bulmasına nasıl yardımcı olursunuz
- Bağlantı paylaşırken sitenizin önizlemesi nasıl düzeltilir
- Sitenizde ziyaretler ve yararlı işlemler nasıl ölçülür
- Ziyaretçilerin randevu almasını nasıl sağlarsınız?
- Web sitenizde ödeme nasıl alınır
- Yayımlamadan önce site değişiklikleri nasıl önizlenir
- Hatalı yayımlanan web sitenizi önceki çalışan sürüme nasıl döndürürsünüz?
- Web sitenizin verilerini nasıl yedekler ve geri yüklersiniz?
- Canlı sitenizdeki hatalar nasıl bulunur ve düzeltilir