Arayan adını sorgulama

Arayan adını sorgulama

Bir telefon numarası için mevcut arayan adı sonucunu alın. Bu, canlı ortamda yapılan bir sorgudur ve sonuç hizmetin önbelleğinden gelse bile hesabınıza ücret yansıyabilir. Sahibi olduğunuz bir numaradan yapılan aramalarda gösterilen adı değiştirmez.

Döndürülen ad; kimliğin, sahipliğin veya arama izninin doğrulandığı anlamına gelmez. Adlar eksik, güncelliğini yitirmiş, kısaltılmış veya coğrafi etiketler olabilir; ad yerine telefon numarası da kullanılabilir.

İstek

Etkinleştirilmiş API hesabınızı, hesap için izin verilen kaynak IP adresinden kullanın. Kimlik bilgilerini sunucu tarafında gizli bilgi deposunda saklayın. Örnekte ortam değişkenleri ve kurgusal bir Kuzey Amerika numarası kullanılır; kimlik bilgilerini URL'lere veya herkese açık tarayıcı koduna koymayın.

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  https://api.multitel.net/v3/cnam/12025550123

Numaranın tamamını ülke kodu dahil rakamlarla gönderin; örneğin Kuzey Amerika için 1 ile başlayan on bir rakam kullanın. İstek işleyicisinin noktalama işaretlerini veya artı işaretini normalleştireceğine güvenmeyin. İstek gövdesi veya bölge seçici gerekmez. Amaçladığınız kullanım için desteklenen kapsamı MultiTEL ile teyit edin.

Yanıt

Değerler yalnızca örnek amaçlıdır; maliyet bir fiyat teklifi değildir.

{
  "status": {
    "code": 200,
    "msg": ""
  },
  "response": {
    "number": "12025550123",
    "name": "EXAMPLE NAME",
    "cost": 0.0037,
    "balance": 9.9963
  }
}

Ücretler ve mutabakat

Ad içeren sonuçlar, hesap için yapılandırılmış CNAM ücreti üzerinden ücretlendirilir. Tekrarlanan veya önbellekten karşılanan bir sorgu ek ücret doğurabilir; arayüzde bir idempotans anahtarı sunulmaz. Otomatik sorguları etkinleştirmeden önce hesabın güncel tarifesini kontrol edin.

Önbellekteki ad boş olduğunda yanıtta bilinen bir sınırlama vardır: bu işlem dalı hesaptan ücret düşmediği halde işleyici boş bir ad, sıfırdan farklı bir maliyet ve azaltılmış hesaplanmış bakiye ile API kodu olarak 200 döndürebilir. Bu yanıtı tek başına ücret tahsil edildiğinin kanıtı olarak görmeyin. Mutabakat için hesap faturalandırma kayıtlarını ve yeni bir bakiye sorgusunun sonucunu karşılaştırın; belirsiz sonuçlar için destek birimine başvurun.

Ön ödemeli bakiye kontrolü, yapılandırılmış sorgu başına ücretten bağımsız olarak, şu anda sorgudan önce en az 0.004 bakiye bulunmasını gerektirir. Satın alma işlemleri devre dışı bırakılmış hesaplar da reddedilir. Bu kontroller, bu uç noktayı fiyat teklifi veya harcama sınırı API'si haline getirmez.

Hatalar ve yeniden denemeler

Hem HTTP durumunu hem de JSON içindeki status.code/status.msg alanlarını kontrol edin. API kodu 403; yetersiz ön ödemeli bakiye, satın alma yasağı, hesap yetkilendirme sorunu veya arayan adının bulunamaması anlamına gelebilir. Ad bulunamayan işlem akışı, kodu metin dizesi olarak döndürebilir. Her 403 kodunu hatalı kimlik bilgileri olarak değerlendirmek yerine mesajı inceleyin. Yapılandırma çakışmaları, API kodu olarak 500 döndürebilir.

Ücretlendirilebilir bir sorgudan sonra zaman aşımı oluşabilir. Yalnızca uygulamanız için uygunsa, artan bekleme süreleriyle sınırlı sayıda yeniden deneme yapın ve önce sonucu belirsiz denemelerin ücretlendirme mutabakatını tamamlayın. Reddedilen bir numara veya hesap izni ya da bakiye hatası için tekrar tekrar denemeyin. Kendi uygulamanızdaki yanıt önbelleği, sözleşmenize ve doğruluk gereksinimlerinize uygun olmak kaydıyla, tekrarlanan istekleri azaltabilir.

Diğer numara işlemleri

Bu okuma işlemi; giden aramalarda gösterilen adın/LIDB kaydının güncellenmesinden, rehber kaydından veya arayan kaydından ayrıdır. Bu işlemlerin kendilerine özgü zorunlu alanları, yetkilendirmeleri ve ücretleri vardır. Şu işlevleri kullanın: tahsis kapsamı ile önek tablosunu kontrol edin veya numara arama ile sipariş edilebilen numara envanterini sorgulayın. Bunların hiçbiri arayanın iddia ettiği kişi olduğunu doğrulamaz.