ws_avatar hizmet türü: İstek, yanıt ve alan başvurusu

WA Lookup, WhatsApp kontrollerini tek bir senkron çağrı üzerinden sunar ve hangi kontrolün çalışacağına service_type değeri karar verir. Bu, ws_avatar varyantı için alan düzeyinde başvuru belgesidir.

WA Lookup ile bir WhatsApp profil fotoğrafı kontrolü yapmak için X-API-Key başlığı ve {"service_type": "ws_avatar", "identifier": "<E.164 number>"} JSON gövdesiyle POST /api/v1/check gönderin. Yanıt, standart kontrol alanlarına ek olarak boolean bir avatar alanı ve bir avatar_url dizesi döndürür; URL yoksa avatar_url boş bir dizedir.

İstek sözleşmesi

WA Lookup tek bir senkron çağrıyı belgeler: X-API-Key başlığı ve Content-Type: application/json ile gönderilen POST /api/v1/check. Gövde tam olarak iki değer taşır: kontrolü seçen service_type ve E.164 biçiminde telefon numarası olması gereken identifier. Bir numarayı yerel biçimde göndermek, önlenebilir başarısızlıkların en yaygın nedenidir; bu yüzden göndermeden önce normalize edin.

Her zaman aldığınız yanıt alanları

Tamamlanmış bir WhatsApp kontrolü için döndürülen data; service_type, identifier ve registered alanlarını içerir; ws_avatar ayrıca avatar ve avatar_url, ws_business ise business alanını içerir. Dahili kayıt, işlem, durum ve faturalandırma alanları döndürülmez.

ws_avatar'ın eklediği iki alan

service_type=ws_avatar seçmek boolean bir avatar alanı ve bir avatar_url dizesi ekler. avatar boolean alanı, bir profil fotoğrafı algılanıp algılanmadığını bildirir. avatar_url alanı başarılı bir ws_avatar yanıtında her zaman bulunur ve URL yoksa boş bir dizedir. İki alan farklı soruları yanıtladığı için onu avatar boolean alanından ayrı tutun.

Her şey tek bir yanıtta gelir

Çağrı senkron olduğundan kayıt ve profil fotoğrafı alanları istekle aynı HTTP yanıtında geri gelir. Saklanacak bir iş kimliği veya yoklanacak bir durum rotası yoktur; bu da entegrasyonu tek bir çağrı ve tek bir hata yoluyla sınırlı tutar. Yoklama tabanlı bir API için yazılmış kodda genellikle burada doğrudan silinebilecek yapılar bulunur.

SSS

avatar_url alanını nasıl ele almalıyım?

avatar_url alanı başarılı bir ws_avatar yanıtında her zaman bulunur. Boş bir dizeyi “URL mevcut değil” olarak saklayın; bunu avatar boolean alanının yerine kullanmayın.

identifier hangi numara biçimini gerektirir?

E.164. Göndermeden önce normalize etmek, başarısız kontrollerin en yaygın kategorisini önler.

Kayıt durumunu almak için ikinci bir çağrıya ihtiyacım var mı?

Hayır. ws_avatar, kayıt alanını profil fotoğrafı alanlarıyla birlikte aynı yanıtta döndürür.