Ringkasan Lookup

Lookup menjawab pertanyaan tentang penerima sebelum Anda mengirim pesan. Berikan nomor telepon dan Lookup memberi tahu jaringan yang melayaninya, negara, apakah nomor tersebut pernah pindah jaringan, dan jenis salurannya. Berikan alamat email dan Lookup memberi tahu apakah alamat tersebut layak untuk dikirim.

Keduanya satu permintaan dan satu jawaban. Tidak ada yang perlu dibuat, tidak ada yang perlu di-poll, dan tidak ada yang perlu dibersihkan setelahnya. Halaman Lookup di dashboard menjalankan dua operasi yang sama satu per satu, dan ini cara tercepat untuk melihat seperti apa jawaban yang dihasilkan sebelum Anda menulis kode apa pun.

Biaya setiap lookup

Setiap lookup dibebankan ke wallet organisasi Anda, dan ini bagian yang perlu dipahami sebelum Anda membangun di atasnya.

Lookup nomor telepon selalu menagih satu kali untuk base lookup. Di atasnya, Anda dapat meminta properti, fakta tambahan yang berasal dari sumber data berbayar. Setiap properti yang Anda minta ditagih terpisah, tetapi hanya jika berhasil dikirim. Properti yang tidak bisa dijawab dikembalikan dengan status yang menyatakan demikian dan tidak dikenakan biaya.

Lookup alamat email menagih satu kali per alamat yang dijawab. Setiap verdik ditagih, termasuk undeliverable: itulah jawaban yang Anda minta, dan itulah yang menyelamatkan Anda dari bounce.

Tidak ada yang ditagih jika lookup gagal. Nomor tidak valid, alamat yang kami tolak, atau sumber data yang tidak dapat dijangkau semuanya tanpa biaya.

Harga Lookup mencantumkan tarif untuk base lookup, untuk setiap properti, dan untuk lookup alamat email.

Lookup nomor memiliki dua tingkat

Pembagian ini adalah inti desain lookup nomor telepon, jadi perlu dijelaskan secara eksplisit.

Base lookup selalu dijalankan. Ia menjawab jaringan yang melayani, jaringan yang menerbitkan nomor, negara, apakah nomor tersebut pernah pindah jaringan, dan line_type kasar (mobile, fixed line, VoIP, toll-free, dan sebagainya). Jika base lookup tidak bisa dijawab, seluruh permintaan gagal alih-alih mengembalikan jawaban setengah kosong yang harus Anda periksa untuk mengetahui bahwa isinya kosong.

Properti adalah yang Anda tambahkan di atasnya, dengan menyebutkan namanya di type. Properti menjawab pertanyaan lebih detail: layanan teralokasi yang tepat dari rentang tersebut, catatan porting lengkap, apakah nomor saat ini aktif di jaringan, apakah sedang roaming, kapan SIM terakhir diganti, dan skor kredibilitas. Properti yang tidak bisa dijawab tidak pernah menggagalkan permintaan. Ia turun ke status, dan base lookup tetap disajikan.

Hanya ok yang membawa nilai, dan hanya ok yang ditagih

Setiap blok properti memiliki status, dan membacanya bukan opsional.

ok berarti properti dijawab, nilainya ada di respons, dan ditagih.

unavailable berarti tidak ada jawaban yang diterima, jadi properti tidak menambahkan apa pun. Tidak ditagih.

inconclusive berarti jawaban diterima tetapi tidak menyelesaikan properti: nomor berada di luar cakupan data di belakangnya, atau sumber mengembalikan nilai yang tidak dilaporkan oleh properti ini. Ini adalah temuan nyata, bukan data yang hilang, dan juga tidak ditagih.

status adalah kosakata terbuka, jadi nilai baru dapat ditambahkan. Percabangan berdasarkan ok dan perlakukan yang lain sebagai "not answered" agar kode Anda tetap benar seiring perkembangannya.

Memilih antara Lookup dan validasi saat pengiriman

Lookup digunakan untuk memutuskan sebelum Anda berkomitmen: memeriksa nomor atau alamat saat pendaftaran, menyaring lead sebelum Anda menindaklanjutinya, atau merutekan pesan secara berbeda tergantung jenis salurannya. Setiap pemeriksaan dikenakan biaya dan memberikan jawaban yang bisa Anda tindaklanjuti.

Jika Anda hanya ingin berhenti mengirim ke alamat yang sudah bounce atau mengajukan keluhan, Anda tidak memerlukan Lookup. Supresi melakukannya secara otomatis dan gratis.

Lookup email juga menyediakan endpoint batch (POST /v1/lookup/email/batch) yang memeriksa hingga 1.000 alamat dalam satu permintaan, sedangkan lookup nomor telepon memeriksa satu nomor per permintaan. Keduanya menggunakan grup batas laju lookup; lihat Batas laju untuk kebijakan yang berlaku dan cara meminta batas yang lebih tinggi.

Langkah selanjutnya

• Lookup nomor telepon membahas base lookup, setiap properti, dan apa yang dikembalikan masing-masing.
• Lookup alamat email membahas verdik dan tindakan yang perlu dilakukan untuk masing-masing.
• Referensi API Lookup mendokumentasikan setiap field.
• Idempotency menjelaskan cara mencoba lagi lookup tanpa membayar dua kali.