Glosarium

Istilah didefinisikan sesuai penggunaannya oleh API. Jika sebuah kata juga memiliki makna sehari-hari yang lebih longgar, makna dari API yang berlaku.

Pengenal dan produk

Istilah	Arti
pengenal	Hal tunggal yang menjadi subjek pemeriksaan realtime: satu nomor telepon atau satu alamat email. Pengiriman massal membawa daftar berisi hal-hal tersebut.
seri	Apakah sebuah pengenal berupa phone atau email. Produk, endpoint, dan permintaan semuanya spesifik per seri, dan sebuah permintaan hanya boleh mencampur seri dalam arti justru tidak boleh mencampurnya sama sekali.
produk	Satu target deteksi — sebuah platform, ditambah jenis pemeriksaan yang dilakukan terhadapnya. “WhatsApp Number Checker” dan “WhatsApp Activity Details” adalah dua produk yang berbeda, meskipun keduanya menyangkut WhatsApp.
produk realtime	Produk yang digunakan melalui endpoint sinkron. Dialamatkan dengan ID numeriknya.
produk massal	Produk yang digunakan melalui endpoint asinkron. Dialamatkan dengan slug-nya.
ID	Bilangan bulat yang mengidentifikasi produk realtime, ditampilkan sebagai #47 di katalog. ID adalah yang diterima product_ids.
slug	String yang mengidentifikasi produk massal, misalnya waValid. Slug adalah yang diterima field product.
mode	realtime atau async. Sebuah produk hanya termasuk salah satunya, dan mode menentukan endpoint mana yang menerimanya.

ID dan slug tidak dapat dipertukarkan

ID realtime tidak pernah dikenali di endpoint massal, dan slug massal tidak pernah dikenali di endpoint realtime. Mencampurnya adalah kesalahan integrasi yang paling sering terjadi, dan tidak ada sisi yang menyelesaikannya secara diam-diam — tetapi keduanya gagal dengan cara berbeda, karena kedua sisi memvalidasi secara berbeda:

• product_ids divalidasi sebagai array bilangan bulat, sehingga slug berupa string ditolak sebagai 400 invalid_realtime_request sebelum pencarian produk apa pun terjadi.
• Field product pada massal dicari berdasarkan slug, sehingga slug produk realtime ditemukan — lalu ditolak sebagai 422 product_mode_not_supported, karena endpoint asinkron hanya menerima produk asinkron.

Putusan

Istilah	Arti
terdaftar	Apa yang sebenarnya dijawab deteksi: apakah pengenal ini terdaftar di platform ini? Ini bukan pernyataan tentang apakah nomor atau alamat tersebut valid secara sintaksis, dapat dihubungi, atau aktif.
valid	Dipastikan terdaftar. Ditagih.
invalid	Dipastikan tidak terdaftar. Ditagih — jawaban negatif tetap sebuah jawaban.
unknown	Penyedia tidak dapat menyelesaikannya. Tidak ditagih; dikembalikan dananya.
di-cache	Putusan disajikan dari fakta tersimpan, bukan dengan menanyai pemasok. Hit cache tetap ditagih.
kombinasi	Satu permintaan realtime, satu pengenal, dan satu hingga sepuluh produk yang diperiksa terhadapnya. Sebuah kombinasi dapat berhasil sebagian — lihat partial_succeeded.

Uang

Istilah	Arti
reservasi	Mengambil jumlah di muka sebelum pekerjaan berjalan. Setiap pengiriman direservasi terhadap saldo akun.
penyelesaian	Menentukan tagihan akhir sebuah item setelah putusannya diketahui.
pengembalian dana	Mengembalikan jumlah yang direservasi untuk item yang tidak menghasilkan putusan yang dapat dipakai.
billing_status	Field per item: charged atau refunded. Bacalah ini alih-alih menyimpulkan dari status HTTP.
total_reserved	Direservasi sebelum pekerjaan berjalan. Selalu sama dengan total_charged + total_refunded.
charged_amount	Tagihan bersih. refunded_amount adalah pengembalian bersihnya.

Permintaan dan tugas

Istilah	Arti
request_id	UUID yang mengidentifikasi satu pengiriman realtime. Sertakan dalam permintaan dukungan.
task_id	Token yang mengidentifikasi satu pengiriman massal, dikembalikan saat pengiriman. Juga merupakan parameter jalur {token} pada endpoint tugas — satu nilai, dua nama dalam dokumentasi.
Idempotency-Key	Header yang disediakan pemanggil, wajib pada panggilan realtime, yang membuat percobaan ulang aman: kunci yang sama dengan body yang sama mengembalikan hasil tersimpan alih-alih menagih lagi.
diputar ulang	Respons berasal dari hasil tersimpan, bukan dari pekerjaan baru. replayed pada respons realtime, idempotent_replay pada pengiriman massal. Pemutaran ulang tidak pernah memindahkan uang.
recovery_pending	Tugas massal sudah masuk antrean, tetapi pembukuannya masih direkonsiliasi.

Penghitung tugas

Istilah	Arti
submitted	Baris yang Anda kirim.
prefiltered	Baris yang dibuang sebelum deteksi — misalnya baris yang formatnya salah.
deduped	Baris duplikat yang dihapus.
total	Baris yang benar-benar diperiksa: submitted dikurangi prefiltered dikurangi deduped.
processed	Baris yang telah diselesaikan kanal hulu sejauh ini.
unknown_unprocessed	Baris yang tidak pernah terselesaikan. Inilah baris yang dikembalikan dananya.

Batas dan retensi

Istilah	Arti
batas per kunci	Anggaran yang melekat pada kunci API Anda. Inilah yang perlu dijadikan acuan perencanaan.
batas per IP	Plafon yang lebih kasar yang dipakai bersama oleh setiap kunci di balik satu alamat. Bukan kontrol akses.
retensi	Berapa lama sebuah catatan bertahan. Log realtime dan hasil pemutaran ulang: 30 hari. Berkas hasil massal: 7 hari.

Terkait

• Format Respons — envelope, dan bagaimana uang serta stempel waktu dikodekan
• Kode Kesalahan — kosakata yang sama yang diterapkan pada kegagalan