WA Lookup
Catatan pemeriksaan registrasi yang melewati status selesai, belum terselesaikan, dan pembaruan
Pisahkan observasi yang selesai dari percobaan yang belum terselesaikan di sepanjang siklus hidup hasil.

Status registrasi adalah observasi, bukan label permanen

Pemeriksaan registrasi WhatsApp yang selesai menjawab apakah satu nomor E.164 dilaporkan terdaftar pada waktu pemeriksaan yang dicatat.

Hasilnya dapat langsung berguna, tetapi tidak boleh disimpan sebagai sifat abadi seperti phone.is_valid. Nomor telepon dan registrasi platform dapat berubah, dan kegagalan teknis di kemudian hari tidak membatalkan hasil yang sebelumnya sudah selesai. Karena itu, model yang tahan lama mencatat keputusan sekaligus konteks yang menghasilkannya.

WA Lookup mengembalikan informasi registrasi secara sinkron. Hal ini memudahkan penyimpanan observasi tepat pada saat aplikasi menerimanya. Model yang sama tetap harus membedakan pemeriksaan yang selesai dari permintaan yang tidak pernah menghasilkan keputusan registrasi.

Catatan hasil minimum yang berguna

Field Contoh Mengapa penting
source_phone Teks asli yang dikirim Mendukung koreksi dan audit tanpa mengubah sumber
e164_phone +17253100591 Mengidentifikasi nilai yang telah dinormalisasi dan benar-benar diperiksa
service_type ws Mengidentifikasi kontrak hasil
outcome completed Klasifikasi aplikasi Anda untuk hasil yang selesai atau permintaan yang gagal
registered true atau false Menyimpan hasil registrasi yang selesai
received_at Stempel waktu aplikasi Mencatat kapan respons sinkron diterima
api_code 0 Memisahkan hasil API luar dari observasi registrasi

Hanya isi registered untuk keputusan yang selesai. Catat status HTTP dan kode API secara terpisah ketika aplikasi memerlukan riwayat error; jangan mengubah respons tersebut menjadi nilai registrasi lain.

Simpan tiga bentuk respons secara akurat

Kontrak yang terdokumentasi memiliki dua bentuk hasil selesai dan satu bentuk error yang terpisah:

  1. Hasil selesai terdaftar — code=0 dan data.registered=true.
  2. Hasil selesai tidak terdaftar — code=0 dan data.registered=false.
  3. Tanpa keputusan — kode API bukan nol, tanpa nilai registered yang perlu disimpan.

Input tidak valid, saldo tidak mencukupi, batas konkurensi, timeout, pemeliharaan, dan kegagalan internal menggunakan kode API bukan nol. Semua itu adalah error permintaan, bukan nilai dari hasil registrasi WhatsApp.

Pertahankan riwayat saat pemeriksaan baru dijalankan

Jika aplikasi memerlukan status yang lebih baru, tambahkan observasi baru atau buat versi baru dari catatan yang ada. Jangan menimpa checked_at lama sambil mempertahankan hasilnya, dan jangan mengganti nilai terakhir yang selesai dengan false hanya karena pembaruan gagal.

Tampilan status saat ini yang sederhana dapat memilih observasi selesai yang paling baru, sementara tabel di baliknya menyimpan setiap percobaan. Dengan begitu aplikasi mendapatkan jawaban terkini bila tersedia dan tetap menunjukkan apakah percobaan yang lebih baru belum terselesaikan.

Situasi Hasil selesai terbaru Log permintaan terpisah
Pemeriksaan pertama selesai true true diterima pada T1 Berhasil pada T1
Permintaan API berikutnya mengembalikan error true diterima pada T1 Error HTTP/API pada T2
Pemeriksaan berikutnya selesai false false diterima pada T3 Berhasil pada T3

Tentukan waktu pembaruan berdasarkan keputusan bisnis

Tidak ada waktu kedaluwarsa universal untuk hasil registrasi. Rentang kesegaran yang tepat bergantung pada seberapa besar keterlambatan yang dapat ditoleransi oleh alur kerja di sekitarnya. Tindakan pengguna sesuai permintaan mungkin memerlukan pemeriksaan sinkron baru, sedangkan laporan analitis dapat menerima stempel waktu yang lebih lama selama usianya terlihat.

Tetapkan aturannya secara eksplisit:

  • usia hasil maksimum yang diterima oleh alur kerja;
  • respons API bukan nol mana yang harus memicu panggilan berikutnya;
  • error API mana yang membuat pemanggil memilih untuk mengirim ulang;
  • bagaimana batas konkurensi dan timeout dihormati;
  • bagaimana stempel waktu ditampilkan kepada operator.

Hal yang penting adalah tidak memasarkan nilai database lama sebagai real-time. WA Lookup memberikan observasi terkini secara sinkron saat dipanggil; aplikasi yang mengintegrasikannya menentukan kapan perlu memanggil lagi.

Prinsip penyimpanan yang andal

Simpan bukti registrasi sebagai observasi bertanda waktu dan simpan percobaan operasional sebagai status tersendiri.

Cara ini menjaga registered=false tetap bermakna, membuat percobaan ulang lebih aman, dan memungkinkan setiap antarmuka menyatakan secara persis kapan status yang ditampilkannya diperiksa. Cara ini juga sesuai dengan batasan produk: WA Lookup menyediakan hasil pemeriksaan registrasi, sedangkan sistem pelanggan bertanggung jawab atas retensi, kebijakan pembaruan, dan keputusan hilir.

Sumber