Cara CarrierLookup mencari operator sebuah nomor

Menyelesaikan satu pemeriksaan

Bagian ini membahas pemeriksaan real-time: dasbor SaaS dan endpoint REST sinkron berbagi satu layanan pemeriksaan dan satu arti respons. Daftar yang sangat besar memiliki opsi massal asinkron, yang dibahas di akhir halaman ini.

1. 1

   Kirim nomor

   Kirim satu nomor lengkap, seperti dijelaskan dalam dokumentasi API.

2. 2

   Gunakan service_type=carrier

   Produk carrier mengembalikan jaringan tempat nomor awalnya dialokasikan, beserta jenis saluran dan wilayah alokasi.

3. 3

   Baca hasilnya

   Baca kolom operator dalam respons yang sama. Kolom tersebut menggambarkan alokasi awal, bukan operator yang melayani nomor tersebut saat ini.

Format nomor yang harus dikirim

CarrierLookup menerima satu nomor per pencarian, ditulis dalam format E.164: tanda plus, kode negara, lalu nomor pelanggan tanpa spasi atau pemisah.

• Kirim nomor lengkap, termasuk kode negara. Nomor nasional tanpa kode negara tidak dapat dicari.
• Format nasional dengan nol di depan, spasi, tanda hubung, atau tanda kurung tidak diterima — kirim hanya + dan angka.
• Nomor dengan format yang salah ditolak sebelum ada tagihan; format yang ditolak bukanlah jawaban “tidak ada hasil”.

Apa arti kolom operator?

Kolom operator adalah jawaban dari pencarian operator: carrier, underlying_carrier, number_type, country_code, region, dan city, di tingkat atas respons yang berhasil. Kolom ini memuat operator dan jenis saluran yang dialokasikan semula, negara, serta wilayah dan kota alokasi jika penyedia menyediakannya. Tidak ada flag registered — respons yang berhasil itulah hasilnya. Selain itu — batas waktu habis, hasil yang tidak dapat ditentukan, nomor tidak valid — dikembalikan sebagai kode error, dan pencarian tersebut dikembalikan dananya secara otomatis. Nilai kosong tidak pernah berarti “tidak ada operator”; artinya penyedia tidak menyediakan kolom tersebut.

• carrier adalah jaringan tempat nomor dialokasikan saat diterbitkan.
• number_type, region, dan city dapat kosong jika penyedia tidak menyediakannya; kuncinya selalu ada.
• Tangani hasil lainnya sesuai kode respons API; jangan menyimpulkan alokasi sendiri.

Gunakan hasil sesuai cakupannya

Hasil operator menggambarkan jaringan tempat nomor awalnya dialokasikan. Ini bukan pemeriksaan keterjangkauan, bukan verifikasi identitas, dan bukan izin untuk menghubungi seseorang.

• Hasil ini tidak mengonfirmasi siapa pemilik nomor, dan tidak mengikuti portabilitas nomor — nomor yang telah dipindahkan tetap melaporkan operator tempat rentangnya awalnya dialokasikan.
• Hasil operator tidak menetapkan persetujuan untuk menghubungi nomor tersebut.
• Jangan anggap hasilnya sebagai operator saat ini: mencari nomor itu lagi akan mengembalikan alokasi awal yang sama, bukan jaringan tujuan jika nomor tersebut telah dipindahkan.

Daftar yang sangat besar: opsi asinkron

Pemeriksaan multi di dasbor dan endpoint multi API mencakup sebagian besar daftar. Hanya jika daftar jauh melampaui batas tersebut, masuk akal untuk mengirim seluruh file sebagai satu tugas massal asinkron.

• Unggah file .txt atau .csv dengan satu nomor per baris, dari halaman pemeriksaan massal atau melalui API.
• Pilih negara asal nomor saat mengunggah; setiap baris tetap harus dalam format E.164.
• Saldo dicadangkan untuk baris yang valid saat pengiriman, Anda hanya ditagih untuk nomor yang mengembalikan hasil, dan selisihnya dikembalikan.
• Tugas berjalan di latar belakang; unduh file hasil setelah selesai. Tugas yang gagal dikembalikan sepenuhnya.