Periksa cakupan alokasi nomor Amerika Utara

Periksa cakupan tabel alokasi

Periksa apakah nomor Amerika Utara cocok dengan prefiks dalam tabel alokasi MultiTEL, lalu dapatkan kota, negara bagian, dan negara yang terkait. Ini adalah pencarian dalam tabel prefiks. Pencarian ini tidak membuktikan bahwa pelanggan aktif, bahwa nomor telah diberikan kepada pelanggan, bahwa nomor tersebut milik akun Anda, atau bahwa Anda dapat memesannya.

Permintaan

Gunakan akun API Anda yang telah diaktifkan dan alamat IP sumber yang diizinkan. Contoh ini menggunakan kredensial HTTP Basic dari variabel lingkungan dan nomor fiktif. Isi permintaan tidak diperlukan.

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

Sebaiknya gunakan nomor Amerika Utara sepanjang sebelas digit yang diawali dengan 1. Penangan permintaan menghapus karakter selain digit dan menambahkan 1 di awal masukan sepanjang sepuluh digit. Masukan dengan jumlah digit lainnya ditolak. Normalisasi ini tidak memvalidasi setiap aturan penomoran Amerika Utara, sehingga kecocokan yang berhasil ditemukan dalam tabel bukanlah validasi nomor secara menyeluruh.

Respons

Nilai kolom hanya untuk ilustrasi; ini bukan hasil dari tabel alokasi aktual.

{
  "status": {
    "code": 200,
    "msg": "12025550123"
  },
  "response": {
    "number": "12025550123",
    "npanxx": "1202555",
    "city": "Example City",
    "state": "DC",
    "country": "US"
  }
}

Kolom hasil kecocokan alokasi
Kolom	Arti
number	Masukan yang telah dinormalisasi sehingga hanya berisi digit.
npanxx	Prefiks tersimpan yang cocok. Penangan permintaan mengutamakan prefiks negara/wilayah/sentral sepanjang tujuh digit dan dapat menggunakan prefiks negara/wilayah sepanjang empat digit sebagai alternatif; jangan menganggap kolom ini selalu mengidentifikasi sentral secara lengkap.
city, state, country	Metadata untuk prefiks alokasi yang cocok. Kolom-kolom ini tidak mengidentifikasi lokasi fisik pelanggan saat ini atau operator yang digunakan saat ini setelah pemindahan nomor ke operator lain.

Kesalahan

Baca JSON status.code alih-alih hanya mengandalkan HTTP 200. Kode API 404 dengan pesan Not part of NANPA berarti tidak ada prefiks yang cocok dalam tabel yang digunakan layanan; ini bukan penetapan definitif dari otoritas penomoran global. Kode API 500 digunakan untuk jumlah digit yang tidak valid atau nomor yang tidak disertakan.

Biaya dan langkah berikutnya

Penangan permintaan yang ditinjau melakukan kueri pada tabel alokasi lokal dan tidak memuat pendebitan akun atau pencarian eksternal. Penangan ini tidak mengenakan biaya pencarian. Gunakan pencarian nomor yang tersedia untuk menemukan persediaan nomor yang dapat dipesan. Pencarian nama, pencarian perutean, atau pemesanan nomor merupakan operasi yang berbeda dengan tarif akun masing-masing.