Tahsis tablosunun kapsamını kontrol edin
Bir Kuzey Amerika numarasının MultiTEL’in tahsis tablosundaki bir önekle eşleşip eşleşmediğini kontrol edin ve ilgili şehir, eyalet ve ülke bilgilerini alın. Bu işlem bir önek tablosu sorgusudur. Bir abonenin aktif olduğunu, bir numaranın tahsis edilmiş olduğunu, hesabınıza ait olduğunu veya numarayı sipariş edebileceğinizi göstermez.
İstek
Etkinleştirilmiş API hesabınızı ve izin verilen kaynak IP adresinizi kullanın. Örnekte, ortam değişkenlerinden alınan HTTP Basic kimlik bilgileri ve kurgusal bir numara kullanılır. İstek gövdesi gerekmez.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
https://api.multitel.net/v3/nanpacheck/120255501231 ile başlayan on bir haneli bir Kuzey Amerika numarasını tercih edin. İsteği işleyen kod, rakam dışındaki karakterleri kaldırır ve on haneli girdinin başına 1 ekler. Diğer hane sayıları reddedilir. Bu normalleştirme, Kuzey Amerika numaralandırma kurallarının tamamını doğrulamaz; dolayısıyla tabloda başarılı bir eşleşme bulunması, kapsamlı bir numara doğrulaması değildir.
Yanıt
Alan değerleri yalnızca örnek amaçlıdır; bu, canlı tahsis tablosundan alınmış bir sonuç değildir.
{
"status": {
"code": 200,
"msg": "12025550123"
},
"response": {
"number": "12025550123",
"npanxx": "1202555",
"city": "Example City",
"state": "DC",
"country": "US"
}
}| Alan | Anlamı |
|---|---|
| number | Yalnızca rakamlardan oluşan, normalleştirilmiş girdi. |
| npanxx | Eşleşen kayıtlı önek. İsteği işleyen kod, yedi haneli ülke/alan/santral önekini tercih eder ve gerekirse dört haneli ülke/alan önekini kullanabilir; bu alanın her zaman bir santrali tam olarak tanımladığını varsaymayın. |
| city, state, country | Eşleşen tahsis önekine ilişkin üst veriler. Bu alanlar, bir abonenin mevcut fiziksel konumunu veya numara taşıma sonrasındaki mevcut operatörünü belirtmez. |
Hatalar
Yalnızca HTTP 200 durumuna güvenmek yerine JSON yanıtındaki status.code alanını okuyun. Not part of NANPA mesajıyla birlikte dönen 404 API kodu, hizmetin kullandığı tabloda hiçbir önekin eşleşmediği anlamına gelir; bu, küresel numaralandırma otoriteleri açısından kesin bir tespit değildir. 500 API kodu, geçersiz hane sayısı veya eksik numara için kullanılır.
Maliyet ve sonraki adımlar
İncelenen istek işleme kodu, yerel tahsis tablosunu sorgular; hesaptan ücret düşme veya harici sorgulama işlemi içermez. Bu kod tarafından sorgulama ücreti uygulanmaz. Kullanılabilir numara araması ile sipariş edilebilir numara envanterini bulun. Ad sorgulama, yönlendirme sorgulama veya numara siparişi, her biri hesaba özel kendi fiyatlandırması olan ayrı bir işlemdir.