E-posta Doğrulama API: 15 Dakikalık Entegrasyon Planı

Bir e-posta doğrulama API'si, uygulamanıza bir adresi kaydetmeden önce tek bir soru sordurur: bu posta kutusu posta alabilir mi? İşte yaklaşık on beş dakikada bitirebileceğiniz bir plan.

1. Anahtarı alın ve sözleşmeyi okuyun

Hesabınızda bir API anahtarı oluşturun (API erişimi her ücretli planda dahildir) ve Mailbite e-posta doğrulama API sayfasını okuyun: istek, yanıt alanları, sınırlar ve hatalar orada. İstemci üretmek isterseniz bir OpenAPI dosyası da var.

2. Tek bir istek gönderin

Adresi, anahtarınız başlıkta olacak şekilde doğrulama uç noktasına gönderin ve JSON yanıtı okuyun. Anahtarı sunucuda tutun, tarayıcı kodunda asla bulundurmayın.

3. Her sonucun ne yapacağına karar verin

• Geçerli: Adresi kabul edin.
• Geçersiz: Nazik bir mesaj gösterin ve başka bir adres isteyin.
• Riskli ya da bilinmiyor: Kabul edin ama pazarlama dikkatli gönderebilsin diye işaretleyin.
• Geçici: Politikanıza göre davranın. Birçok ürün bunları yalnızca ücretsiz denemelerde engeller.

4. Kullanıcı deneyimini koruyun

• Yavaş bir posta sunucusu yanıt vermek için 45 saniyeye kadar sürebilir; bu yüzden zaman aşımını yaklaşık 45 saniyeye ayarlayın ama kullanıcıyı asla bekletmeyin: adresi kabul edin, arka planda doğrulayın ve sonuç kötüyse işaretleyin. Yavaş bir yanıt kaydı hiçbir zaman engellememeli.
• Kontrolü her tuş vuruşunda değil, gönderim anında çalıştırın.
• Bir öneri döndüğünde yazım düzeltmesi gösterin; örneğin gmial.com yerine gmail.com.

5. Sınırları ve hataları yönetin

Hız sınırına uyun (anahtar başına dakikada 1.500 isteğe kadar), 503 sonrasında kısa bir beklemeyle yeniden deneyin ve 401'i asla yeniden denemeyin. Raporlar için sayı istiyorsanız, adresin tamamını değil sonuç kategorisini kaydedin.

6. Eski listeyi de temizleyin

API yeni veriyi korur. Mevcut veri için tek seferlik bir temizlik gerekir: listeyi toplu doğrulamaya yükleyin.

7. Yayına almadan önce test edin

Geçerli bir adres, yanlış yazılmış bir alan adı, geçici bir adres ve posta sunucusu olmayan bir alan adındaki adres deneyin. Her durumda formun ne gösterdiğine ve API zaman aşımına uğradığında ne olduğuna bakın.

Maliyet

Her kontrol bir kredi harcar; sonuç bilinmiyor çıksa da öyle. Hatalı biçimli bir adres ya da kısa bir kesinti ücret çıkarmaz. Ücretli planlar ayda 25.000 doğrulama için 19,90 $'dan başlar ve API erişimini içerir. Fiyatlandırmaya bakın.

Asgari bir kod taslağı

Sade bir dille, sunucu tarafı şöyle işler: adresi formdan alın, anahtarınızla doğrulama API'sini çağırın, "result" alanını okuyun ve karar verin. Sonuç geçerliyse adresi kaydedin. Geçersizse nazik bir mesaj döndürün. Başka her sonuçta, sonra gözden geçirebilmek için bir işaretle kaydedin. Çağrıyı bir zaman aşımının arkasında tutun; böylece yavaş bir yanıt kaydı hiçbir zaman engellemez.

Neleri kaydetmeli?

Adresin tamamını değil, sonuç kategorisini ve ne kadar sürdüğünü kaydedin. Birkaç hafta sonra işe yarar soruları yanıtlayabilirsiniz: kayıtların yüzde kaçı geçersiz, hangi yazım önerileri kabul ediliyor ve çağrı ne sıklıkla zaman aşımına uğruyor.

Kaçınılacak hatalar

• API anahtarını tarayıcı kodunda tutmak. Orada herkes okuyabilir.
• "Riskli" adresleri baştan reddetmek. Çoğu, tüm postayı kabul eden şirketlerdeki gerçek insanlardır.
• Her tuş vuruşunda kontrol etmek. Form gönderildiğinde bir kez kontrol edin.
• Kredi kalmaması (402) ya da çok fazla istek (429) gibi hataları ele almayı unutmak.

Bunun yerine toplu doğrulayıcıyı ne zaman kullanmalı?

Binlerce adresli bir dosyanız varsa, API üzerinde döngü kurmak yerine toplu doğrulayıcıya yükleyin. Daha hızlıdır, izlemesi daha basittir ve indirilebilir bir rapor verir.