E-posta Teslim Edilebilirlik Kontrolü API: Teslim Edilebilir ve Teslim Edilemez Sonuçların Yönetimi

E-posta Teslim Edilebilirlik Kontrolü API'sini entegre ederek, senkron ve toplu iş akışlarınızda teslim edilebilir ve teslim edilemez adresleri, belirsiz catch-all alan adlarından ayırt edin.

EmailCheckPro, bir adresin kontrol anında teslim edilebilir (posta alabilir durumda) mi yoksa teslim edilemez mi olduğunu belirleyen bir e-posta teslim edilebilirlik kontrolü API'si sunar. Teslim edilebilir kararı, adresin kontrol edildiği sırada ileti kabul edebildiğini gösterirken; teslim edilemez kararı, adresin posta alamadığını tanımlar. Hizmet, hedef alıcılara herhangi bir ileti göndermeden, neredeyse tüm alan adlarındaki adresleri değerlendirir. Mühendislik ekipleri, gerçek zamanlı ve toplu API iş akışlarını entegre ederek aktif alıcı adreslerini teslim edilemez kayıtlardan ve belirsiz catch-all alan adlarından ayırabilir, böylece veri giriş sistemlerinde veri hijyenini korurken iletim kalitesini artırabilirler.

Temel Teslim Edilebilirlik Kararları ve Operasyonel Kapsam

Alıcı adreslerini değerlendirmek, teslim edilebilir, teslim edilemez ve belirsiz sonuçlar arasında net ayrımlar yapılmasını gerektirir.

Teslim edilebilir kararı, alıcı adresinin doğrulama yapıldığı sırada erişilebilir olduğunu ve posta almaya hazır olduğunu onaylar. Buna karşılık, teslim edilemez sonucu, adresin ileti alamadığını gösterir. Her iki karar da tamamlanmış doğrulama sonuçlarını temsil eder.

Teslim edilebilirlik değerlendirmeleri, kalıcı garantiler yerine anlık erişilebilirlik sinyalleri sağlar. Geliştirme ekipleri bu sinyalleri, ölü adresleri iletişim kuyruklarından çıkarmak ve GDPR Article 5 (Regulation (EU) 2016/679) kapsamındaki Avrupa veri minimizasyonu ilkelerine uyum sağlarken altyapı performansını korumaya yardımcı olmak için kullanırlar.

Tekil ve Toplu Kontroller için Senkron Entegrasyon

Kayıt veya profil güncellemeleri sırasında iletişim verilerini yakalayan uygulamalar, hızlı ve senkron değerlendirmeye ihtiyaç duyar. EmailCheckPro, etkileşimli iş akışları için iki özel gerçek zamanlı uç nokta sağlar.

Bireysel gönderimler için geliştiriciler, tek bir tam adres ile POST /api/v1/check sorgusu yaparlar.

Küçük kullanıcı girişi gruplarını yönetirken, POST /api/v1/batch-check uç noktası 1 ila 100 adresi tek bir HTTP isteği içinde senkron olarak işler. Çoklu kontrol yanıtı, giriş listesinin tam sırasını korur. Her kayıt, doğrulama detaylarının yanı sıra bir exists özelliği içerir. Bu şemada exists=false, teslim edilemez bir karardan ziyade, hizmetin o girdi için tamamlanmış bir sonuç üretemediğini belirtir. Bu ayrım, giriş sistemlerinin geçici sorunları yeniden denemesine ve onaylanmış teslim edilemez girişleri güvenli bir şekilde filtrelemesine olanak tanır.

Liste İşleme için Asenkron Toplu Görevler

Büyük veritabanı arşivlerini korumak, asenkron bir işleme mimarisi gerektirir. İletişim depolarını denetlerken, sistemler doğrulama işlerini POST /api/v1/bulk-tasks aracılığıyla gönderir.

Toplu gönderimler, satır başına bir tam e-posta adresi içeren yapılandırılmış TXT veya CSV dosyalarını kabul eder. Dosya alımı sırasında platform, yinelenen satırları ve hatalı biçimlendirilmiş girdileri otomatik olarak kaldırarak temiz bir görev hazırlar. Ürün başına belgelenmiş sayı limitleri geçerlidir; ekipler güncel görev limitleri için resmi belgeleri incelemelidir.

Toplu işler asenkron olarak yürütüldüğünden, uygulamalar ilerlemeyi GET /api/v1/bulk-tasks/{id} kullanarak izler. İstemci iş akışları bu uç noktayı 30 saniyede birden daha sık sorgulamamalıdır. İşleme tamamlandığında, uç nokta her tanımlayıcıyı ve onun etkinleştirilmiş sonucunu içeren bir CSV dosyasına bağlantı veren bir result_url sağlar. Oluşturulan indirme bağlantısı 12 saat boyunca geçerli kalır ve o görev durumu her sorgulandığında yenilenir.

Belirsiz Catch-All Adreslerin ve Biçimlendirme İstisnalarının Yönetimi

Güvenilir veri kalitesi hatları, açık teslim edilebilirlik hataları ile belirsiz veya hatalı biçimlendirilmiş girdiler arasında ayrım yapmalıdır.

RFC 5322: Internet Message Format uyarınca, bir e-posta adresi @ sembolü ile birleştirilmiş bir yerel bölüm ve alan adından oluşur. Gelen bir girdi bu yapıdan yoksunsa, API yükü geçersiz bir biçim olarak değerlendirir. Geçersiz bir biçim, teslim edilemez bir karardan farklıdır ve yapısal bir sözdizimi hatasını temsil eder.

Catch-all posta sunucuları başka bir operasyonel kategori oluşturur. Bu alan adları, herhangi bir rastgele yerel kullanıcı adına gönderilen iletileri kabul eder ve doğrulama motorunun geçerli posta kutularını kesin olarak izole etmesini engeller. Tahmin yürütmek yerine, EmailCheckPro catch-all yapılandırmalarını belirsiz olarak işaretler. Gerçek zamanlı doğrulamada, catch-all alan adları tamamlanmış bir sonuç olmadan 42200 durum kodunu döndürür. Belirsiz, geçersiz ve başarısız kontroller herhangi bir ücret gerektirmez; bu da ekiplerin catch-all kayıtlarını ayrı inceleme kuyruklarına yönlendirmesine olanak tanır.

SSS

Teslim edilemez bir karar ile belirsiz bir sonuç arasındaki fark nedir?

Catch-all alan adları için yapılan gerçek zamanlı kontroller, tamamlanmış bir karar olmadan 42200 durum kodunu döndürür; bu adresler ücretlendirilmez ve ayrı inceleme politikaları için kullanılabilir durumda kalır.

Çoklu kontrol API istekleri, asenkron toplu görevlerden nasıl farklıdır?

Çoklu kontrol çağrıları, 1 ila 100 adresi senkron olarak doğrulamak için POST /api/v1/batch-check kullanır ve giriş sırasını koruyarak sonuçları doğrudan HTTP yanıtı içinde döndürür. Asenkron toplu görevler, büyük TXT veya CSV listelerini işlemek için POST /api/v1/bulk-tasks kullanır. Toplu görevler çevrimdışı çalışır, 30 saniyelik aralıklarla GET /api/v1/bulk-tasks/{id} sorgulaması gerektirir ve 12 saat geçerli olan bir result_url üzerinden indirilebilir CSV çıktısı verir.

Daha Fazla Bilgi Edinin

İş akışınızdaki bir sonraki adıma uygun ürün bilgisini seçin.

• Ürün belgelerini görüntüleyin →
• Ekiple görüşün →