WhatsApp Profil Fotoğrafı API: Telefon Numarası ile Gerçek Zamanlı Profil Fotoğrafı Analizi
WhatsApp profil fotoğrafı araçlarını karşılaştırın, gerçek zamanlı tekli ve çoklu analiz isteklerini nasıl oluşturacağınızı ve sonuçları nasıl yöneteceğinizi öğrenin.
WhatsApp profil fotoğrafı API'lerine yönelik bir geliştirici kılavuzu: sadece URL döndüren araçların işleyişi, AvatarLookup'ın gerçek zamanlı tekli ve eşzamanlı çoklu WhatsApp profil fotoğrafı analizi isteklerinin farkları ve sonuçların nasıl saklanıp yeniden deneneceği.
Bir WhatsApp profil fotoğrafı API'si, bir telefon numarası alır ve bu numaranın arkasındaki herkese açık profil fotoğrafı hakkında bilgi döndürür. Birçok araç, sizin indirip yorumlamanız gereken geçici bir resim URL'sinde durur. AvatarLookup'ın WhatsApp profil fotoğrafı analizi ise yapılandırılmış bir sonuç döndürür: POST /api/v1/check aracılığıyla gerçek zamanlı tekli sorgu veya istek başına 1–100 numara ile POST /api/v1/batch-check aracılığıyla eşzamanlı çoklu sorgu. Sonuçtaki görünüm nitelikleri algoritmik tahminlerdir. Yalnızca herkese açık profil fotoğrafları analiz edilir; bu nedenle fotoğrafını yalnızca kayıtlı kişilere kısıtlayan bir kişi herkese açık bir resim göstermez ve "belirlenemedi" sonucu, hesap hakkında bir hüküm olarak değil, daha sonra tekrar denenmesi gereken bir durum olarak ele alınmalıdır.
Üç tür WhatsApp profil fotoğrafı API'si
Bu ifade için yapılan arama sonuçları üç farklı şeyi birbirine karıştırır ve yanlış olanı seçmek entegrasyon süresini boşa harcar.
| Tür | Ne yapar | Ne zaman uygundur |
|---|---|---|
| Resmi işletme profili ayarları | Kendi işletme hesabı fotoğrafınızı ayarlar veya okur; Meta'nın profil fotoğrafı ayarları referansı eski şirket içi kurulumu kapsar | Kendi işletme numaranızı yönetiyorsanız |
| Sadece URL döndüren araçlar | Başka bir numaranın herkese açık fotoğrafı için bir resim bağlantısı döndürür | Sadece resmi görüntülemeniz gerekiyorsa |
| Profil fotoğrafı analizi | Görünüm tahminleri dahil olmak üzere herkese açık profil fotoğrafı hakkında yapılandırılmış bir sonuç döndürür | Bir liste genelinde saklamanız ve karşılaştırmanız gereken alanlara ihtiyacınız varsa |
Resmi işletme ayarları, diğer numaraları sorgulamak için değil, kendi hesabınızın fotoğrafı içindir. Sadece URL döndüren araçlar genellikle süresi dolan bağlantılar verir, bu nedenle ekipler resimleri kendileri indirmek, saklamak ve etiketlemek zorunda kalır. Profil fotoğrafı analizi, resim işleme adımını atlar ve bir kişi kaydına uygun veriler döndürür. Her üç tür de aynı kural ile sınırlıdır: fotoğrafın herkese açık olarak görünür olması gerekir.
POST /api/v1/check ile gerçek zamanlı tekli sorgu
Tekli sorguyu, bir destek temsilcisinin bir kişi kaydını açması gibi etkileşimli bir akış içinde bir numaranın cevaba ihtiyaç duyduğu durumlarda kullanın.
- Numarayı normalleştirin. ITU-T Recommendation E.164 yapısını izleyerek ülke koduyla birlikte uluslararası formata dönüştürün ve boşlukları, tireleri ve parantezleri kaldırın.
- Kimliği doğrulanmış bir istek gönderin. WhatsApp profil fotoğrafı ürününü ve numarayı belirterek POST /api/v1/check adresine bir istek gönderin. İstek gövdesinin tam yapısı için API dokümantasyonunu izleyin; alan adlarını tahmin etmeyin.
- Yanıtı bir kez okuyun ve saklayın. Sorgu tarihi ve WhatsApp kaynak etiketi ile birlikte kaydedin.
- Sonuca göre dallanın: Profil fotoğrafı mevcut, profil fotoğrafı yok veya belirlenemedi.
Çağrıyı, müşterinin beklediği herhangi bir engelleyici yolun dışında tutun. Sorgu yavaşsa veya belirlenemedi ise, profil fotoğrafı alanları boş bırakılarak ve daha sonra tekrar kontrol edilmesi gerektiğine dair bir işaretçi eklenerek kayıt yine de kaydedilmelidir. Çin ana karası, Hong Kong ve Makao numaraları yalnızca gerçek zamanlı tekli sorgularla desteklenir, bu nedenle bunları toplu dosyalara değil, buraya yönlendirin.
POST /api/v1/batch-check ile eşzamanlı çoklu sorgu
Çoklu sorgu, kısa bir listeyi tek bir çağrıda işler. Her istek, bir ürün türünden 1–100 arası tanımlayıcı kabul eder ve sonuçları gönderdiğiniz sırayla eşleşen JSON formatında döndürür.
Çoklu istekler için pratik kurallar:
- Ürünleri karıştırmayın. WhatsApp numaralarını bir istekte, desteklenen Gmail, Yandex veya Mail.ru adreslerini başka bir istekte gönderin.
- Sıraya güvenin, ancak doğrulayın. Sonuçlar giriş sırasını takip eder; yine de veritabanınıza yazmadan önce her sonucu kendi giriş numarasıyla eşleştirin.
- Uzun listeleri parçalara ayırın. 350 numaralık bir listeyi, her biri 100'e kadar olan dört isteğe bölün.
- Büyük dosyalar için toplu görevleri kullanın. Liste çok daha büyük olduğunda, asenkron WhatsApp toplu ürün, bir TXT veya CSV dosyası kabul eder ve görev için bir CSV döndürür.
Teknik olmayan ekipler, 500'e kadar tanımlayıcıyı kabul eden ve bunları tek tek işleyen paneli kullanabilir. Her iki durumda da, yalnızca WhatsApp ve desteklenen e-posta alan adları gerçek zamanlı ve çoklu sorgulara sahiptir; Telegram, Viber, MAX, LINE ve Zalo yalnızca toplu ürünlerdir.
Belirlenemedi ve profil fotoğrafı yok sonuçlarını yönetme
Çoğu entegrasyon hatası, farklı sonuçların tek bir boş değerde birleştirilmesinden kaynaklanır. Bunları ayrı tutun:
- Sonuç üretildi. Çoklu yanıt, sonucun üretildiği her öğeyi işaretler. Bu işaretçi, istek için bir sonuç olduğu anlamına gelir, WhatsApp hesabının var olduğu anlamına gelmez.
- Sonuç üretilmedi. Bu, geçersiz, belirlenemedi veya başarısız öğeleri kapsar. Bu, hesap veya profil fotoğrafı hakkında olumsuz bir hüküm değildir, bu nedenle kişiyi silmek yerine daha sonra tekrar deneme planlayın.
- Profil fotoğrafı yok. Tamamlanmış bir sonuç, herkese açık bir resmin mevcut olmadığını gösterebilir. WhatsApp'ın gizlilik ayarları, kullanıcıların profil fotoğraflarını Herkes, Kişilerim, Seçilen kişiler hariç kişilerim veya Hiç kimse olarak göstermesine izin verir; bu nedenle eksik bir herkese açık resim genellikle sadece bir gizlilik tercihidir.
Her durumu kendi değerine (örneğin: mevcut, yok veya tekrar dene) yazın ve tekrar deneme nedenlerini günlüğe kaydedin. Temiz bir durum modeli, raporlamayı da dürüst kılar: "profil fotoğrafı yok" şeklindeki bir panel sayısı, asla sadece belirlenemedi olan öğeleri içermemelidir.
Sonuçları tahmin olarak saklama
Resim türü, yaş aralığı veya saç rengi gibi görünüm nitelikleri, numaranın arkasındaki kişiyi değil, resmi tanımlar. Bir çizgi film, evcil hayvan, logo veya grup fotoğrafı geçerli profil fotoğrafları olabilir ve bunların analizi yine de tamamlanmış bir cevaptır.
Basit bir saklama modeli:
| Alan | Örnek içerik |
|---|---|
| Kaynak | WhatsApp herkese açık profil fotoğrafı |
| Sonuç | mevcut, yok veya tekrar dene |
| Resim türü tahmini | kişi, insan dışı vb. |
| Görünüm tahminleri | tahmin olarak adlandırılan alanlarda saklanır |
| Sorgu tarihi | isteğin yapıldığı tarih |
Bu alanları uygunluk, kredi, işe alım veya fiyatlandırma kararlarının ve insanlara tahmini yaş veya cinsiyete göre farklı davranan herhangi bir taramanın dışında tutun. Herkese açık bir profil fotoğrafı, bir kişi verisi sinyalidir; kimliği, hesap sahipliğini veya iletişim iznini doğrulamaz. Kullanıcılar resimlerini değiştirdiği için bir inceleme aralığı belirleyin ve eski tahminleri normal veri saklama politikanız uyarınca silin.
SSS
Ekipler analiz alanları yerine gerçek resim dosyasına nasıl ulaşabilir?
Profil fotoğrafı analizi, bir resim indirici olarak değil, herkese açık profil fotoğrafı hakkında yapılandırılmış sonuçlar döndürmek üzere tasarlanmıştır. Bir iş akışının resimleri görüntülemesi gerçekten gerekiyorsa, bunun amaç için gerekli olup olmadığını ve dosyaların nasıl saklanıp silineceğini değerlendirin. Birçok kişi verisi iş akışı, yalnızca herkese açık bir profil fotoğrafının var olup olmadığını ve ne tür bir resim olduğunu bilmeye ihtiyaç duyar; analiz zaten bunu yanıtlar.
Geliştiriciler belirlenemedi olan WhatsApp sorgularını nasıl tekrar denemelidir?
Belirlenemedi olan numaraları bir döngü içinde hemen yeniden göndermek yerine bir tekrar deneme kuyruğunda toplayın. Bunları daha sonra tekli veya çoklu bir istekte tekrar kontrol edin ve numara başına deneme sayısını sınırlayın, böylece kalıcı bir hata sonsuza kadar sürmez. Son denemeden sonra, kaydı profil fotoğrafı yok olarak dönüştürmek yerine belirlenemedi olarak tutun, çünkü bu sonuçlar farklı anlamlara gelir.
Ekipler bir telefon numarası yerine ellerinde bulunan bir resmi nasıl kontrol edebilir?
Görsel profil analizini kullanın. JPEG, PNG, WebP veya GIF dosyalarını kabul eder ve çok parçalı dosya yüklemesi ile belgelenmiş görsel profil uç noktası üzerinden çağrılır. Resmin kendisini tanımlar; resim türünü ve görünüm niteliklerini algoritmik tahminler olarak döndürür, herhangi bir telefon numarası veya hesap içermez. Bu, bir form aracılığıyla gönderilen profil fotoğrafı gibi müşterinin doğrudan yüklediği resimler için uygundur.
Daha Fazla Bilgi
İş akışınızın bir sonraki adımına uygun ürün bilgisini seçin.