Tekil ve Toplu Avatar Sorgulama: Veri Kaynağına Göre Seçim

Görsel yüklemelerden asenkron mesajlaşma platformu toplu işlemlerine kadar, veri kaynağınıza göre tekil veya toplu avatar analizini nasıl seçeceğinizi öğrenin.

Tekil ve toplu avatar sorgulama arasındaki seçim, iş akışınızın görsel varlıklarla mı yoksa ham tanımlayıcılarla mı başladığına bağlıdır. AvatarLookup, analizi üç net katmanda yapılandırır. Bir görsel varlık zaten mevcut olduğunda, Görsel profil analizi dosya üzerinde doğrudan görsel analiz gerçekleştirir. Elinizde yalnızca bir tanımlayıcı olduğunda, WhatsApp ve desteklenen e-posta alan adları gerçek zamanlı tekil sorgular veya senkronize çoklu tanımlayıcı sorguları sağlar. Telegram, Viber, LINE, Zalo ve MAX üzerindeki büyük hacimli veriler için asenkron toplu dosya görevleri, tanımlayıcı listelerini aşamalı CSV dışa aktarımları aracılığıyla işler. Bu kaynağa özel ayrımı anlamak, ekiplerin her veri hattı için uygun istek modelini entegre etmesini sağlar.

Mevcut Görsel Varlıklar için Görsel Profil Analizi

Görsel profil analizi, ekiplerin halihazırda bir grafik dosyasına veya barındırılan bir görsel varlığa sahip olduğu durumlarda birincil değerlendirme katmanı olarak hizmet eder. Bu iş akışı, bir telefon numarası veya kullanıcı adı kullanarak harici bir iletişim ağını sorgulamak yerine, görseli doğrudan değerlendirir. Gönderim, JPEG, PNG, WebP veya GIF gibi yaygın web görsel formatlarını kabul eden çok parçalı (multipart) dosya yüklemesine dayanır.

Sistem, gönderilen dosyayı kişisel bir hesap tanımlayıcısıyla ilişkilendirmek yerine, dosyadan algoritmik bir içerik parmak izi türetir. Ortaya çıkan veri paketi; resim kategorisi sınıflandırmasının yanı sıra yaş, cinsiyet, cilt rengi ve saç rengi için algoritmik tahminler içeren yapılandırılmış portre öznitelikleri sağlar. Ekipler bu yöntemi, hesap oluşturma sırasında kullanıcı tarafından gönderilen profil resimlerini taramak, eski fotoğraf depolarını denetlemek veya gelen yaratıcı medyayı kategorize etmek için kullanır. Analiz, görsel verileri harici platform varlığından bağımsız olarak değerlendirdiğinden, bireysel medya dosyaları için talep üzerine çalışır.

WhatsApp ve E-posta için Gerçek Zamanlı Tanımlayıcı Sorguları

Elinizde bir görsel varlık yerine yalnızca bir tanımlayıcı olduğunda, gerçek zamanlı sorgular desteklenen hizmetlerde herkese açık bir avatarın erişilebilir olup olmadığını kontrol eder. Bu yetenek, özellikle WhatsApp telefon numaraları ve Gmail, Yandex ve Mail.ru adreslerini kapsayan desteklenen web postası alan adları için geçerlidir.

Ekipler, tekil kayıtlar için POST /api/v1/check veya gruplandırılmış tanımlayıcı setleri için POST /api/v1/batch-check kullanarak senkronize sorgular uygular. Çoklu sorgu uç noktası, tek bir istek içinde 1 ila 100 tanımlayıcıdan oluşan grupları işler ve sıralı bir JSON dizisi döndürür. E-posta profilleri için sorgu, adresin posta alıp alamayacağını ve herkese açık portre özniteliklerini belirtir. Senkronize yanıtlarda, exists özelliği bir yürütme göstergesi olarak işlev görür; true değeri bir sonucun oluşturulduğunu doğrular, false değeri ise geçersiz bir girişi veya belirlenemeyen bir sonucu ifade eder. Bu model, canlı müşteri yönlendirmeyi, kayıt taramasını ve duyarlı iletişim zenginleştirme iş akışlarını destekler.

Mesajlaşma Ağları için Asenkron Toplu Dosya Görevleri

Daha geniş sosyal ekosistemlerde yüksek hacimli veri işleme, gerçek zamanlı çağrılardan asenkron dosya tabanlı yürütmeye kayar. Telegram, Viber, MAX, LINE ve Zalo profil hizmetleri yalnızca toplu görevler aracılığıyla çalışır. Yüksek hacimli WhatsApp ve e-posta koleksiyonları da, sürekli soket bağlantılarını yönetmeden uzun listeleri işlemek için toplu işleme yoluyla kuyruğa alınabilir.

Toplu iş akışları, her satırda bir tanımlayıcı listeleyen düz TXT veya CSV dosyaları gerektirir. XLSX gibi elektronik tablo formatları desteklenmez. Telefon numarası dosyaları, boşluk veya başta sembol olmadan standartlaştırılmış rakamlar içermeli ve bir ISO 3166-1 ülke kodu ile birlikte gönderilmelidir. Telegram kullanıcı adı görevleri, bölgesel ülke parametrelerini atlayarak, önek sembolleri olan veya olmayan kullanıcı adlarını kabul eder. Ürün bazlı dosya sınırları ve minimum tanımlayıcı eşikleri geçerli olduğundan, ekipler giriş setlerini hazırlamadan önce güncel platform API belgelerini incelemelidir.

Uçtan Uca Toplu Yaşam Döngüsü ve CSV Sonuç Alımı

Asenkron bir toplu görevi yürütmek, arka plan iş kuyrukları için tasarlanmış üç aşamalı bir entegrasyon modelini izler:

• Görev Oluşturma: İstemci sistemi, biçimlendirilmiş dosyayı POST /api/v1/bulk-tasks kullanarak gönderir. Telefon hizmetleri için, ülke kodu çok parçalı iletimde dosya yükünün önünde yer alır. Platform, benzersiz bir görev kimliği (ID) döndürür.
• Durum Sorgulama: İstemci, GET /api/v1/bulk-tasks/{id} çağrısı yaparak işin ilerleyişini izler. Gereksiz ağ geçidi yükünü önlemek için otomatik sorgu döngüleri 30 saniyeden daha sık gerçekleşmemelidir.
• CSV Alımı: Başarılı bir tamamlamanın ardından, durum uç noktası 12 saat boyunca geçerli olan güvenli bir CSV indirme URL'si sağlar. Veri hatlarında alım gecikmeleri yaşanırsa, görev sorgusunu yenilemek süresi dolan bağlantıları uzatır.

Çıktı şemaları, temel ürün ailesini yansıtır. E-posta grupları tanımlayıcı, activated durumu ve avatar görsel yollarını döndürürken; Telegram dosyaları platform tanımlayıcılarını, etkinlik günlerini ve görsel öznitelik tahminlerini döndürür. Hat mühendisleri, her ürün dosyasını belgelenmiş sütun özelliklerine göre ayrıştırmalıdır.

SSS

Hangi mesajlaşma platformları gerçek zamanlı tekil sorguları destekler?

Gerçek zamanlı tekil sorgular ve senkronize çoklu sorgular yalnızca WhatsApp ve desteklenen e-posta alan adları (özellikle Gmail, Yandex ve Mail.ru adresleri) için mevcuttur. Telegram, Viber, LINE, Zalo ve MAX dahil olmak üzere diğer mesajlaşma platformları, anlık senkronize sorgular yerine kesinlikle asenkron toplu dosya iş akışları olarak çalışır.

Telefon numarası toplu görevleri için hangi dosya gereksinimleri geçerlidir?

Toplu görevler, elektronik tablo biçimlendirmesi olmadan her satırda bir tanımlayıcı içeren biçimlendirilmiş TXT veya CSV dosyaları gerektirir. Telefon tabanlı listeler için numaralar, artı işaretleri veya noktalama işaretlerinden arındırılmış, ülke kodlu rakamlar gerektirir. Ekipler, çok parçalı gönderimlerde dosyanın önünde bir ISO 3166-1 ülke parametresi gönderir; ürün bazlı dosya sınırları resmi API belgelerinde detaylandırılmıştır.

Ekipler boş bir avatar veya exists=false yanıtını nasıl yorumlamalıdır?

Senkronize çoklu sorgularda exists=false, hesabın var olmadığına dair kesin bir kanıt değil; geçersiz bir tanımlayıcıyı, belirlenemeyen bir sorguyu veya ulaşılamayan bir uç noktayı ifade eder. Benzer şekilde, boş bir avatar URL'si veya insan dışı kategori, profil doğrulaması veya kimlik onayı değil, algoritmik olarak belirlenemeyen görsel alanları yansıtır.

Daha Fazla Bilgi Edinin

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

• Ürün web sitesini ziyaret edin →