Tiga pertanyaan berbeda tersembunyi di balik kata validasi. Satu menanyakan apakah nomor tersebut berbentuk seperti nomor asli. Satu menanyakan apakah ada jaringan yang menjawab untuk nomor tersebut. Satu menanyakan apakah orang yang sedang Anda ajak bicara memiliki nomor itu. Masing-masing membutuhkan pemeriksaan yang berbeda. Masing-masing menyisakan sesuatu yang tidak diketahui.
Apa yang bisa diketahui dari pemeriksaan format?
Bahwa nomor tersebut termasuk dalam rentang yang boleh diberikan oleh operator.
libphonenumber Google menganggap suatu rentang valid jika operator bebas memberikan nomornya kepada pelanggan. FAQ-nya:
A valid number range is one from which numbers can be freely assigned by carriers to users.
Validitas tidak mengatakan apa pun tentang apakah nomor tertentu sudah diberikan atau menjawab. Halaman yang sama:
Do not rely on libphonenumber to determine whether numbers are currently assigned to a specific user and reachable.
Jadi pemeriksaan format menjawab pertanyaan tentang rencana penomoran. Pemeriksaan ini tidak mengatakan apa pun tentang apakah rentang tersebut sudah ditetapkan kepada siapa pun, dan tidak mengatakan apa pun tentang apakah telepon berdering.
Menelepon juga bukan pengganti yang valid. FAQ memberikan dua alasan mengapa panggilan bisa tersambung ke nomor yang tidak valid. Beberapa negara mengabaikan digit tambahan di akhir, sehingga 1800 MICROSOFT menjangkau nomor yang lebih pendek. Selama penomoran ulang, beberapa operator tetap mengaktifkan nomor lama setelah nomor tersebut berhenti berfungsi secara umum.
Apa yang ditambahkan oleh pencarian jaringan?
Bagian dari jawaban yang hanya dimiliki oleh jaringan.
Pencarian menanyakan sumber operator dan inteligensi nomor tentang nomor tertentu, bukan tentang rentangnya. Ini mengubah beberapa pertanyaan dari tidak diketahui menjadi terjawab:
| Pemeriksaan | Apa yang dikembalikan | Apa yang masih belum diketahui |
|---|---|---|
| Format | Nomor dapat diurai dan berada dalam rentang yang dapat ditetapkan | Apakah rentang tersebut sudah ditetapkan kepada siapa pun |
| Tipe saluran | Apakah nomor tersebut seluler, saluran tetap, VoIP, bebas pulsa, atau mesin-ke-mesin | Layanan apa yang dialokasikan ke rentang tersebut secara lebih rinci |
| Jaringan penyaji | Jaringan yang menjawab untuk nomor tersebut sekarang, dan jaringan yang menerbitkannya | Apakah perangkat sedang aktif |
| Status porting | Kapan nomor terakhir berpindah jaringan | Tidak ada tentang pelanggan |
| Kehadiran | Apakah nomor terdaftar dan dapat menerima lalu lintas saat ini | Siapa yang memegang perangkat |
| Kepemilikan | Tidak ada. Pencarian tidak pernah menanyai orangnya | Apakah pengguna Anda menguasai nomor tersebut |
Baris terakhir adalah yang paling penting untuk alur pendaftaran. Tidak ada pencarian yang membuktikan kepemilikan, karena pencarian tidak pernah melibatkan orangnya.
Apa yang hanya bisa dibuktikan oleh tantangan verifikasi?
Bahwa siapa pun yang ada di alur Anda dapat menerima lalu lintas di nomor tersebut.
FAQ libphonenumber menganggap tantangan sebagai satu-satunya jawaban yang bisa diterapkan, karena praktik penomoran terlalu berbeda antarnegara sehingga cara lain tidak bisa menyelesaikannya:
This is not technically feasible without such a verification step given the complicated international world we live in, with varying standardization practices in different regions.
Mengirim kode dan menerima kode tersebut kembali adalah jenis pemeriksaan yang berbeda dari dua pemeriksaan di atas. Ini membutuhkan satu pesan dan satu perjalanan bolak-balik. Ini juga satu-satunya pemeriksaan yang menghubungkan nomor dengan orang di depan Anda. Apa arti OTP membahas kode itu sendiri, dan panduan Verify membahas cara menjalankan tantangan.
Bagaimana cara membaca pemeriksaan yang tidak bisa dijawab siapa pun?
Sebagai tidak diketahui, yang tidak sama dengan tidak.
Nomor yang kehadirannya tidak dapat ditentukan bukan nomor yang tidak dapat dijangkau. Memperlakukan keduanya sama akan memblokir pelanggan yang jaringannya kebetulan tidak menjawab.
Bird memisahkan keduanya dalam respons. Setiap properti yang Anda minta melaporkan status-nya sendiri:
ok: properti dijawab dan nilainya ada.unavailable: tidak ada jawaban yang masuk, jadi bloknyanull.inconclusive: jawaban masuk tetapi tidak menyelesaikan properti tersebut.
Hanya ok yang membawa nilai. Blok kehadiran dengan status: ok dan reachable: false adalah negatif yang sesungguhnya, karena jaringan menjawab dan melaporkan nomor tersebut sebagai tidak dapat dijangkau.
Jadi periksa ok terlebih dahulu. Perlakukan yang lain sebagai tidak terjawab. Kosakata status adalah open enum, jadi nilai yang tidak dikenali adalah status masa depan, bukan error. Memeriksa berdasarkan ok tetap benar seiring kosakata bertambah.
Bagaimana cara memilih penyedia pencarian nomor telepon?
Pilih penyedia yang field, cakupan pasar, dan aturan penagihannya sesuai dengan keputusan yang perlu Anda buat.
| Poin keputusan | Bird Lookup | Pertanyaan untuk penyedia lain |
|---|---|---|
| Sintaks dan validitas | Memerlukan nomor internasional dan melaporkan apakah nomor tersebut sesuai dengan rencana penomoran. | Apakah penyedia menormalisasi input dan menolak nomor yang salah format tanpa menebak? |
| Tipe saluran dan operator | Mengembalikan tipe saluran, jaringan penyaji, dan jaringan penerbit dalam hasil dasar. | Field operator dan tipe saluran mana yang disertakan, dan apakah nilainya saat ini atau saat ditetapkan? |
| Porting | Melaporkan status porting dalam hasil dasar dan dapat mengembalikan data porting tambahan. | Apakah menampilkan operator saat ini, operator asal, atau riwayat perpindahan? |
| Kesegaran | Kehadiran dan roaming menanyakan kondisi jaringan saat ini; field lain menjelaskan penomoran dan penetapan. | Field mana yang real-time, di-cache, atau memiliki stempel waktu? |
| Hasil tidak diketahui | Setiap properti yang diminta memiliki status ok, unavailable, atau inconclusive. | Bisakah Anda membedakan properti yang tidak terjawab dari hasil negatif? |
| Cakupan pasar | Suatu properti bisa tidak tersedia untuk nomor atau operator tertentu meskipun pencarian berhasil. | Negara dan operator mana yang mendukung setiap properti? |
| Penagihan | Pencarian dasar ditagih sekali. Properti opsional ditagih hanya saat berhasil dikirim, dan properti yang gagal tidak ditagih. | Berapa biaya properti yang tidak terjawab, dan tambahan mana yang mengubah tagihan? |
Daftar alternatif menunjukkan pertimbangan yang berbeda. Twilio Lookup menawarkan pemformatan dan validasi dasar. Paket opsional mencakup tipe saluran, status saluran, penukaran SIM, identitas, nama pemanggil, nomor yang ditetapkan ulang, dan sinyal risiko. Cakupan dan syarat persetujuan berbeda menurut paket dan pasar.
Dokumentasi validasi telepon Abstract API menjelaskan field validitas, negara, operator, dan tipe saluran. Halaman validasi dan pencarian operator Veriphone menjelaskan field validitas, negara, operator, tipe saluran, dan operator saat ini. Keduanya menerbitkan aturan cakupan dan kredit terpisah. Cakupan yang didokumentasikan, perilaku hasil tidak diketahui, dan penagihan setiap penyedia menentukan apakah penyedia tersebut cocok untuk keputusan pendaftaran atau routing.
Bagaimana cara mencari nomor di Bird?
Kirim nomor ke endpoint pencarian. Baca blok yang Anda minta.
POST /v1/lookup/phone-number menerima phone_number dan array type opsional. Setiap pencarian mengembalikan jaringan penyaji dan penerbit, status porting, negara, dan tipe saluran. Array type menambahkan classification, porting, presence, roaming, sim_swap, atau score, masing-masing ditagih terpisah dan hanya saat berhasil dikirim. Pencarian tidak menghubungi nomor tersebut.
Menggunakan kembali Idempotency-Key mengembalikan hasil yang tersimpan alih-alih melakukan dan menagih pencarian kedua. Panduan pencarian membahas alurnya dan referensi API membahas field-nya.
Singkatnya
Valid berarti rentang nomor ada, bukan berarti nomor tersebut digunakan.
Library nomor telepon Google mendefinisikan rentang valid sebagai rentang yang nomornya bebas diberikan oleh operator kepada pengguna.
Panggilan yang tersambung tidak membuktikan nomor valid.
Beberapa negara mengabaikan digit tambahan di akhir, dan beberapa operator tetap mengaktifkan nomor lama selama penomoran ulang lama setelah nomor tersebut berhenti berfungsi di tempat lain.
Hanya tantangan verifikasi yang membuktikan kepemilikan.
Mengirim kode dan menerima kode tersebut kembali adalah satu-satunya pemeriksaan yang memastikan siapa yang menguasai nomor itu, sehingga verifikasi ada sebagai langkah terpisah.
Pemeriksaan yang tidak terjawab bukan berarti jawaban negatif.
Bird melaporkan setiap properti yang diminta dengan statusnya sendiri, sehingga properti yang tidak bisa dijawab siapa pun tetap dapat dibedakan dari properti yang dijawab tidak.