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, satu penerima pada satu waktu: memeriksa nomor atau alamat saat pendaftaran, menyaring lead sebelum Anda menindaklanjutinya, atau merutekan pesan secara berbeda tergantung jenis salurannya. Biayanya per pemeriksaan dan memberikan jawaban yang bisa Anda tindaklanjuti.

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

Tidak ada operasi yang memiliki bentuk batch, dan pembatasan laju permintaan lookup dimulai dari 10 permintaan per menit per kredensial, jadi memeriksa seluruh daftar bukan yang dirancang untuk saat ini. Hubungi kami untuk menaikkan batas jika Anda membutuhkannya.

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.