Cari informasi perutean

Minta informasi perutean untuk nomor telepon Amerika Utara. Gunakan informasi ini untuk menafsirkan data perutean atau operator yang tersedia, bukan sebagai bukti identitas pelanggan, kepemilikan, dapat dihubunginya nomor, atau ketersediaannya untuk dibeli. Pencarian dapat menimbulkan biaya pada akun Anda.

Permintaan

Gunakan akun API Anda yang telah diaktifkan beserta alamat IP sumber yang diizinkan untuk akun tersebut. Masukkan nomor lengkap dalam bentuk digit, termasuk kode negara 1. Contoh ini menggunakan variabel lingkungan dan nomor fiktif. Pemroses permintaan tidak menormalkan tanda baca; validasi masukan sebelum mengirimkannya.

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

Respons

Hanya kolom tertentu yang ditampilkan sebagai ilustrasi; ketersediaannya bergantung pada sumber dan jenis nomor.

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

Pencarian standar mengubah nama kolom yang dikembalikan menjadi huruf kecil. Kolom operator, pusat tarif, lokasi, dan yurisdiksi mungkin tersedia, bergantung pada sumbernya. Respons ini bukan catatan pelanggan lengkap dengan susunan tetap. Penanda local dapat berupa angka 1 atau string 0. Pemroses permintaan menghitung ported dengan membandingkan nomor perutean yang dikembalikan dengan nomor telepon yang diberikan; jangan menafsirkannya sebagai riwayat lengkap perpindahan nomor antaroperator yang telah diverifikasi.

Harga dan percobaan ulang

Pemroses permintaan yang ditinjau memotong saldo akun sebesar $0.00025 saat mencapai alur penyelesaian dan mencatat pencarian. Biaya yang dikembalikan biasanya berupa string yang menyertakan tanda dolar, bukan sekadar nilai numerik. Tidak ada kunci idempotensi yang disediakan. Mengulangi permintaan dapat menimbulkan biaya lagi.

Untuk akun prabayar, kode memeriksa apakah saldo setidaknya 0.00025. Pesan saldo tidak mencukupi saat ini menyebutkan $5, yang tidak sesuai dengan ambang tersebut. Tafsirkan kegagalan ini sebagai penolakan karena saldo dan pastikan dana akun mencukupi sebelum mencoba lagi.

Kegagalan dan keberhasilan yang tidak lengkap

Baca status HTTP serta status.code/status.msg pada JSON. Hasil pencarian standar yang kosong mengembalikan kode API 404. Kode API 403 dapat menunjukkan saldo prabayar yang tidak mencukupi.

Salah satu alur kesalahan nomor bebas pulsa saat ini tetap dapat memotong saldo sebesar biaya pencarian dan melaporkan kode API 200 tanpa kolom perutean yang berguna; informasi biayanya dapat tidak lengkap. Karena itu, kode 200 saja tidak memastikan bahwa hasil pencarian dapat digunakan. Validasi kolom yang dibutuhkan aplikasi Anda, cocokkan biaya yang belum pasti dengan catatan penagihan akun, dan hubungi dukungan untuk hasil yang tidak lengkap.

Dalam implementasi yang ditinjau, penanganan nomor bebas pulsa berbeda menurut panjang masukan. Utamakan nomor internasional lengkap dalam bentuk digit dan pastikan cakupan nomor bebas pulsa yang diperlukan dengan dukungan. Jangan mencoba lagi secara otomatis jika hasilnya salah format atau tidak lengkap, dan jangan mengandalkan pencarian perutean untuk memutuskan bahwa suatu nomor aman atau diizinkan untuk dihubungi.