Apa itu HLR lookup?

HLR lookup menanyakan ke jaringan seluler yang bertanggung jawab atas sebuah nomor apa yang disimpannya tentang nomor tersebut, seperti jaringan mana yang melayaninya dan apakah nomor itu dapat menerima lalu lintas pada saat kueri dilakukan.

Istilah ini menggambarkan dari mana jawaban berasal, bukan apa yang Anda dapatkan. Jaringan seluler menyimpan register pelanggannya sendiri. Lookup adalah pertanyaan yang diajukan ke register tersebut, melalui layanan yang memiliki akses ke sana. Apa yang akan dijawab register bervariasi tergantung jaringan.

Apa itu HLR itu sendiri?

Register pelanggan di dalam jaringan seluler.

GSM adalah standar seluler yang menjadi dasar pembangunan sebagian besar jaringan sebelum core berbasis paket. Di dalamnya, Home Location Register menyimpan catatan setiap pelanggan yang terdaftar di jaringan tersebut, termasuk elemen jaringan mana yang melayani mereka. Arsitektur yang lebih baru memindahkan peran yang sama ke Home Subscriber Server. Kedua nama ini menggambarkan tugas yang sama di generasi jaringan yang berbeda.

Keduanya bukan direktori publik. Tidak ada satu register global yang bisa dikueri. Tidak ada lookup yang mengembalikan nama atau alamat pelanggan. Yang bisa diperoleh dari lookup adalah informasi routing dan status yang bersedia dijawab oleh jaringan yang melayani nomor tersebut.

Apa yang sebenarnya bisa diberitahukan oleh lookup?

Jaringan mana yang memegang nomor tersebut saat ini, jenis salurannya, dan apakah nomor itu aktif.

Yang Anda tanyakanYang dikembalikanYang tidak dapat dipastikan
Base lookupNegara, jaringan yang melayani dan yang menerbitkan, jenis saluran, apakah nomor telah berpindah operatorApakah ada yang menggunakannya
presenceApakah nomor tersebut terdaftar dan dapat menerima lalu lintas saat iniSiapa yang memegang perangkat
roamingApakah nomor sedang roaming, dan di jaringan manaDi mana orang tersebut berada
sim_swapKapan SIM terakhir berubahMengapa SIM berubah
portingKapan nomor terakhir berpindah jaringan, dan catatannyaApa pun tentang pelanggan
classificationLayanan tepat yang dialokasikan untuk rentang tersebut, di mana base lookup hanya memberikan kategori umumMengapa rentang dialokasikan seperti itu
scoreSkor kredibilitas dari 0 sampai 100Bagaimana skor tersebut disusun, yang tidak bisa diberikan oleh properti lain

Base lookup sudah membedakan jaringan yang melayani nomor dari jaringan yang menerbitkannya. Itulah cara nomor yang telah berpindah operator terlihat: keduanya berbeda, dan flag ported menunjukkannya.

Apakah live check membuktikan sesuatu?

Itu membuktikan bahwa jaringan menjawab, dan tidak lebih dari itu.

Hasil presence mencerminkan kueri real-time ke jaringan tempat nomor tersebut terdaftar. Jadi reachable: true berarti jaringan tersebut melaporkan bahwa nomor mampu menerima lalu lintas pada saat itu. Ini tidak mengidentifikasi pemiliknya. Ini bukan persetujuan. FAQ libphonenumber Google mengatakan hal yang sama tentang memastikan siapa pemegang sebuah nomor:

Do not rely on libphonenumber to determine whether numbers are currently assigned to a specific user and reachable.

Nomor yang terjangkau juga tidak berarti pesan pasti akan sampai. Pengiriman bergantung pada pengirim, rute, dan penyaringan di tujuan, yang semuanya tidak dikonsultasikan oleh lookup.

Bagaimana cara membaca jawaban yang tidak bisa diberikan siapa pun?

Dari status pada properti, yang membedakan tiga kemungkinan hasil.

Setiap properti yang Anda minta melaporkan status-nya sendiri:

  • ok: properti terjawab dan nilainya tersedia.
  • unavailable: tidak ada jawaban yang diterima, sehingga blok tersebut null.
  • inconclusive: jawaban diterima tetapi tidak menyelesaikan properti tersebut.

Hanya ok yang membawa nilai, dan hanya ok yang ditagih. Ini menyisakan perbedaan yang penting untuk alur pendaftaran. Blok presence dengan status: unavailable berarti tidak ada yang bisa memberi tahu Anda. Blok dengan status: ok dan reachable: false berarti jaringan menyatakan nomor tersebut tidak dapat menerima lalu lintas. Memperlakukan yang pertama seperti yang kedua mengubah pertanyaan yang belum terjawab menjadi pelanggan yang ditolak.

Bagaimana cara menjalankannya di Bird?

Kirim nomor tersebut, sebutkan properti yang Anda inginkan.

POST /v1/lookup/phone-number menerima phone_number dan array type opsional yang berisi classification, porting, presence, roaming, sim_swap, dan score. Hilangkan type untuk base lookup saja. Setiap properti yang Anda tambahkan ditagih terpisah dan hanya saat berhasil dikirimkan. Minta presence hanya saat Anda membutuhkan live check, bukan secara default.

Lakukan percabangan berdasarkan ok. Perlakukan setiap status lain sebagai tidak terjawab. Kosakata status adalah open enum, jadi nilai yang tidak dikenali adalah status masa depan, bukan kesalahan. Percabangan seperti ini tetap benar seiring kosakata berkembang. Panduan lookup membahas alurnya. Pemeriksaan validasi nomor telepon apa saja membahas pertanyaan mana yang bisa dijawab oleh setiap jenis pemeriksaan.

Singkatnya

  1. HLR adalah nama dari arsitektur jaringan, bukan basis data publik.

    Home Location Register adalah register pelanggan di jaringan seluler lama, dengan Home Subscriber Server mengisi peran yang sama di jaringan yang lebih baru.

  2. Hasil terjangkau bukan berarti seseorang.

    Jawaban dari jaringan bahwa sebuah nomor dapat menerima lalu lintas tidak mengatakan apa pun tentang siapa yang memegang perangkat atau apakah mereka menyetujui untuk dihubungi oleh Anda.

  3. Setiap jawaban memiliki statusnya sendiri.

    Bird melaporkan setiap properti yang diminta sebagai ok, unavailable, atau inconclusive, dan hanya ok yang membawa nilai.

  4. Unavailable dan unreachable adalah jawaban yang berbeda.

    Yang satu berarti tidak ada yang bisa memberi tahu Anda. Yang lain berarti jaringan memberi tahu Anda bahwa nomor tersebut tidak dapat menerima lalu lintas saat ini.

Bangun di jaringan yang sama.

Kunci API uji coba langsung tersedia untuk Anda. Akses produksi terbuka saat Anda menambahkan metode pembayaran dan memverifikasi pengirim.

Ide Anda berikutnya. Siap terhubung.