CNAM entegrasyonu
CNAM REST API referansı
HTTPS üzerinden bir arayan adı isteyin; sonucu, ücreti ve hataları ele alın.
Sorgu davranışını seçin
| Katman | Sorgu başına herkese açık fiyat | Ne yapar |
|---|---|---|
| Starter | $0,0026 | Özel veri kaynaklarındaki ve önbelleğe alınmış arayan adı bilgilerini kullanır. |
| Standard | $0,0037 | Her sorgu için gerçek zamanlı bir ağ sorgusu yapar. |
| Mixed | $0,004 | Önce gerçek zamanlı sorgu dener, ad bulunamazsa Starter verilerine döner. |
Sorgu davranışını seçilen hizmet belirler; Mixed önce önbelleğe bakan bir sorgu değildir. Üretimde kullanmadan önce hesabınıza atanmış ücreti gözden geçirin. Arayan adı, kimliğin veya sahipliğin kanıtı değildir.
Kimliği doğrulanmış bir sorgu gönderin
Uç nokta: GET https://api.multitel.net/v3/cnam/NUMBER. Ülke kodu dahil, noktalama işareti ve baştaki artı olmadan uluslararası rakamları kullanın. Bunu uygulama sunucunuzdan, onaylı API kimlik bilgileriyle çalıştırın.
curl --fail-with-body \
--user "$MULTITEL_API_USERNAME:$MULTITEL_API_PASSWORD" \
--header "Accept: application/json" \
"https://api.multitel.net/v3/cnam/12025550123"İki ortam değişkenini sunucu tarafı gizli bilgi yapılandırması üzerinden sağlayın. Sağlanmış bir bearer kimlik bilgisi, yalnızca bu erişim etkinleştirilmişse ve kaynak IP kısıtlamaları karşılanıyorsa bir alternatiftir. Hiçbir API gizli anahtarını herkese açık bir tarayıcı paketine koymayın.
JSON yanıtını okuyun
Bu yanıt örnek amaçlıdır. Dönen ad ve ücret, sorguya ve seçilen hizmete bağlıdır.
{
"status": {
"code": 200,
"msg": ""
},
"response": {
"number": "12025550123",
"name": "EXAMPLE CALLER",
"cost": "0.004",
"balance": "24.9960"
}
}status.code- Uygulama sonuç kodu; 200 ile karşılaştırmadan önce dize/sayısal değerleri normalleştirin.
status.msg- Eşlik eden sonuç veya ret mesajı.
response.number- Sorgulanan numara.
response.name- Mevcut arayan adı.
response.cost- Bu sorgu için bildirilen ücret; ondalık bir tutar olarak ele alın.
response.balance- Varsa bildirilen hesap bakiyesi.
Ad dönmeyen sonuçlar ve hatalar
Başarılı bir istek, kullanışlı bir arayan adı döneceğini garanti etmez. Boş bir adı, ad yerine dönen bir numarayı ve reddedilen bir sorguyu ele alın. 403 uygulama kodu yetersiz krediyi, yasaklanmış bir satın almayı veya sonuç bulunmayan bir numarayı ifade edebilir; mesajı inceleyin.
response.name değerine erişmeden önce hem HTTP durumunu hem de JSON status değerini kontrol edin. Hata durumunda yanıt nesnesi bulunmayabilir. Eksik bir ad, normal aramanın yönlendirilmesini engellememelidir.
Faturalama, yeniden denemeler ve arayan kimliği güncellemesinden farkı
Yeni bir sorgu, sorgu ücretine neden olabilir. Bu sorgu arayüzleri bir idempotency anahtarı belgelemez; bu nedenle yeni bir yeniden deneme ikinci bir ücretli sorgu olabilir. Aktarım/hizmet hataları için sınırlı bir geri çekilme (backoff) kullanın, önce hesap hatalarını çözün ve bildirilen sorgu ücretlerini mutabakata bağlayın. Yalnızca uygulamanız için uygun bir süre boyunca önbelleğe alın; arayan adı verileri değişebilir.
Bir CNAM sorgusu bir adı okur. Giden aramalarınızda sunulan adı değiştirmez. LIDB arayan adı güncellemesi ise kendi alanları, yetkilendirmesi, fiyatı ve işleme süreciyle ayrı bir işlemdir.