Yönlendirme bilgilerini sorgulama

Bir Kuzey Amerika telefon numarası için yönlendirme bilgilerini isteyin. Bu bilgileri mevcut yönlendirme ve operatör verilerini yorumlamak için kullanın; abonenin kimliğinin, numaranın sahipliğinin, ulaşılabilirliğinin veya satın alınabilirliğinin kanıtı olarak kullanmayın. Sorgulama, hesabınıza ücret yansıtılmasına neden olabilir.

İstek

Etkin API hesabınızı ve bu hesap için izin verilen kaynak IP adresini kullanın. Numaranın tamamını, 1 ülke kodu dahil olacak şekilde rakamlarla belirtin. Örnekte ortam değişkenleri ve hayali bir numara kullanılmıştır. İstek işleyicisi noktalama işaretlerini normalleştirmez; göndermeden önce girdiyi doğrulayın.

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

Yanıt

Yalnızca örnek olarak seçilmiş alanlar gösterilmektedir; bu alanların kullanılabilirliği kaynağa ve numara türüne bağlıdır.

{
  "status": {
    "code": 200,
    "msg": "Success"
  },
  "response": {
    "lrn": "12025550123",
    "ocn": "0000",
    "local": 1,
    "ported": 0,
    "cost": "$0.00025"
  }
}

Standart sorgulama, döndürülen alan adlarını küçük harfe çevirir. Kaynağa bağlı olarak operatör, tarife bölgesi, konum ve yargı yetkisi alanları bulunabilir. Yanıt, yapısı sabit ve eksiksiz bir abone kaydı değildir. local bayrağı sayısal 1 veya dize olarak 0 olabilir. İstek işleyicisi, döndürülen yönlendirme numarasını verilen telefon numarasıyla karşılaştırarak ported değerini hesaplar; bu değeri doğrulanmış ve eksiksiz bir numara taşıma geçmişi olarak yorumlamayın.

Ücret ve yeniden denemeler

İncelenen istek işleyicisi, tamamlama akışına ulaşıp sorgulamayı kaydettiğinde hesaptan $0.00025 düşer. Döndürülen maliyet genellikle yalnızca sayısal bir tutar yerine dolar işaretini de içeren bir dizedir. İdempotans anahtarı sunulmaz. Bir isteğin tekrarlanması ek bir ücret doğurabilir.

Ön ödemeli hesaplarda kod, bakiyenin en az 0.00025 olup olmadığını kontrol eder. Yetersiz bakiye mesajında şu anda $5 belirtilmektedir; bu tutar söz konusu eşikle uyuşmaz. Hatayı bakiye nedeniyle ret olarak yorumlayın ve yeniden denemeden önce hesaptaki bakiyeyi doğrulayın.

Hatalar ve eksik başarılı sonuçlar

Hem HTTP durumunu hem de JSON içindeki status.code/status.msg alanlarını inceleyin. Boş bir standart sorgulama sonucu, 404 API kodunu döndürür. 403 API kodu, ön ödemeli bakiyenin yetersiz olduğunu gösterebilir.

Ücretsiz aranan numaralarla ilgili mevcut bir hata akışı, yararlı yönlendirme alanları olmadan yine de sorgulama tutarını hesaptan düşebilir ve 200 API kodunu bildirebilir; maliyet bilgisi eksik olabilir. Bu nedenle tek başına 200 kodu, sorgulamanın kullanılabilir bir sonuç verdiğini göstermez. Uygulamanızın ihtiyaç duyduğu alanları doğrulayın, belirsiz ücretleri hesabın faturalandırma kayıtlarıyla karşılaştırın ve eksik sonuçlar için destek ekibiyle iletişime geçin.

İncelenen uygulamada ücretsiz aranan numaraların işlenişi, girdinin uzunluğuna göre değişir. Numarayı uluslararası biçimde eksiksiz rakamlarla vermeyi tercih edin ve ücretsiz aranan numaralar için gereken kapsamı destek ekibiyle doğrulayın. Bozuk biçimli veya eksik bir sonuç aldığınızda otomatik olarak yeniden denemeyin ve bir numarayı aramanın güvenli veya izin verilen bir işlem olup olmadığına karar vermek için yönlendirme sorgulamasına güvenmeyin.