Pemulihan Timeout Pencarian Operator Tanpa Hasil Parsial

Pemulihan timeout pencarian operator dimulai dengan memisahkan pencarian yang telah selesai dari peristiwa transmisi yang tidak pasti.

Pemulihan timeout pencarian operator dimulai dengan memisahkan pencarian yang telah selesai dari peristiwa transmisi yang tidak pasti. Pemeriksaan tunggal sinkron dapat berakhir tanpa hasil normal; permintaan multi sinkron yang mengalami timeout akan gagal sebagai satu permintaan dan tidak mengembalikan baris parsial. Simpan pengenal yang dikirimkan dan status percobaan untuk ditinjau, kemudian lakukan percobaan ulang hanya berdasarkan kebijakan pelanggan yang eksplisit. Jangan pernah mengisi kolom operator yang kosong dengan tebakan atau melabeli timeout sebagai “tidak ada operator.”

Identifikasi tahap mana yang benar-benar gagal

Pencarian Operator Asli menyediakan operator tempat rentang nomor awalnya dialokasikan, jenis nomor, dan geografi alokasi. Respons yang telah selesai dapat berisi kolom operator yang kosong, yang berarti nilai tersebut tidak tersedia dalam pencarian yang telah selesai tersebut. Hal itu berbeda dengan timeout layanan, format E.164 yang ditolak, atau kegagalan koneksi klien. Prosedur pemulihan harus mengklasifikasikan tahap tersebut sebelum memutuskan apakah akan mengirim permintaan lain.

Mulailah dengan catatan percobaan pelanggan sendiri: mode permintaan, nomor kanonik yang dikirimkan atau nomor yang dipesan, waktu pengiriman, apakah respons diterima, dan apakah aplikasi berhasil menguraikannya. Ini adalah diagnostik milik aplikasi yang diusulkan, bukan skema respons penyedia. Lindungi pengenal lengkap dan kredensial sesuai dengan kebijakan pencatatan organisasi. API publik menerima nomor E.164 dengan awalan plus untuk pemeriksaan waktu nyata; penolakan format harus kembali ke tahap persiapan, bukan ke dalam loop percobaan ulang timeout.

Untuk permintaan tunggal, bedakan respons selesai yang terdokumentasi dari hasil layanan yang Tidak dapat ditentukan dan dari tidak adanya respons yang diamati oleh klien. Tim tidak boleh berasumsi bahwa timer sisi klien membuktikan apa yang dilakukan server. Dokumentasi API adalah otoritas untuk kode bisnis dan perilaku timeout yang tepat.

Gunakan tabel status kegagalan

Tabel keputusan yang ringkas menjaga label operasional tetap konsisten. Tindakan di bawah ini adalah rekomendasi sisi pelanggan; tindakan tersebut tidak mengklaim perilaku percobaan ulang otomatis CarrierLookup.

Tabel tersebut sengaja menghindari “nomor tidak valid” sebagai interpretasi default dari operator yang hilang. CarrierLookup bukanlah produk validitas atau keterjangkauan nomor. Pemeriksaan yang Tidak dapat ditentukan atau gagal harus tetap terpisah dari pencarian yang telah selesai, bahkan ketika antarmuka pengguna hanya memiliki ruang untuk satu lencana status.

Memulihkan permintaan multi sebagai satu kesatuan

Pemeriksaan multi sinkron mengambil daftar nomor E.164 yang dipesan dalam satu permintaan. Timeout multi yang terdokumentasi akan menggagalkan seluruh permintaan tanpa hasil parsial dan mengembalikan jumlah penuh. Oleh karena itu, klien tidak boleh menyimpulkan bahwa bagian pertama berhasil karena indikator kemajuan bergerak atau karena panggilan sebelumnya dengan pengenal serupa memiliki hasil. Pertahankan input berurutan yang tepat dan hasil percobaan. Jika kebijakan pelanggan mengizinkan percobaan ulang, buat percobaan baru yang terikat pada pekerjaan yang sama dan rekonsiliasi daftar lengkap yang dikembalikan hanya setelah respons baru tersebut tiba.

Jika respons multi normal diterima, rekonsiliasi total yang dilaporkan dan hasil yang dipesan sebelum memperbarui catatan kontak. Entri exists=false individu menunjukkan tidak ada hasil normal untuk posisi tersebut, bukan bukti nomor yang tidak valid, terputus, atau tanpa operator. Jangan salin tanda tersebut ke dalam interpretasi CSV massal; output file massal menggunakan kontraknya sendiri. Pertahankan status per item secara independen dari kolom operator.

Aplikasi juga harus melindungi dari penulisan data lama. Jika nomor telepon kontak berubah saat permintaan sedang berlangsung, bandingkan nilai yang dikirimkan dengan catatan saat ini sebelum menerapkan hasil apa pun. Jalur pemulihan timeout tidak boleh melewati pemeriksaan integritas yang sama yang digunakan untuk respons sukses biasa.

Tentukan kebijakan percobaan ulang berdasarkan bukti dan biaya

Percobaan ulang adalah upaya pencarian baru, bukan perbaikan nilai yang hilang dalam respons lama. Tentukan status mana yang memenuhi syarat, berapa banyak percobaan yang diizinkan oleh aplikasi pelanggan, dan siapa yang meninjau ketidakpastian yang persisten. Itu adalah pilihan aplikasi; jangan deskripsikan sebagai batasan atau jaminan penyedia yang tidak terdokumentasi. Hindari percobaan ulang paralel segera yang bersaing untuk slot waktu nyata akun yang dibagikan. API publik mendokumentasikan kontrol konkurensi, sehingga percobaan ulang harus melewati antrean yang sama dengan pekerjaan baru.

Hasil kode nol yang telah selesai dengan semua kolom operator kosong masih dapat dikenakan biaya. Pencarian yang gagal atau Tidak dapat ditentukan tidak menyimpan biaya berdasarkan fakta penagihan yang terdokumentasi. Perbedaan tersebut berguna untuk rekonsiliasi operasional, tetapi artikel ini tidak mencantumkan jumlah atau mengubah timeout teknis menjadi janji pengembalian dana pembelian. Status penagihan dan arti hasil harus ditinjau secara terpisah.

Setelah insiden, ambil sampel log percobaan untuk tiga kesalahan: timeout yang disajikan sebagai hasil operator kosong, permintaan multi yang diperlakukan sebagai keberhasilan parsial, dan percobaan ulang yang diterapkan pada kontak yang nomornya berubah. Perbaiki pemetaan dan putar ulang hanya kasus yang diizinkan oleh kebijakan tim. Hasil dari proses pemulihan yang baik adalah jejak bukti yang jujur, bukan klaim bahwa setiap nomor pada akhirnya akan menghasilkan nilai operator.

Jaga bahasa status yang menghadap pelanggan sehati-hati status internal. “Kami tidak dapat menyelesaikan pemeriksaan” berbeda dengan “tidak ada operator yang ditemukan.” Peninjau harus dapat melacak status tersebut kembali ke catatan percobaan, memahami apakah percobaan baru terjadi, dan melihat hasil mana, jika ada, yang akhirnya digunakan. Disiplin kecil ini mencegah insiden transmisi menjadi kesimpulan kualitas data yang salah di CRM.

FAQ

Apakah timeout multi mengembalikan hasil operator parsial?

Tidak. Timeout multi sinkron yang terdokumentasi menggagalkan seluruh permintaan tanpa hasil parsial.

Apakah kolom operator kosong sama dengan timeout?

Tidak. Pencarian yang telah selesai mungkin memiliki kolom operator yang tidak tersedia dan tetap menjadi hasil yang selesai dan dapat dikenakan biaya.

Apa yang harus disimpan tim sebelum melakukan percobaan ulang?

Simpan pengenal kanonik yang dikirimkan, mode, waktu percobaan, dan status kegagalan yang diamati, kemudian terapkan kebijakan percobaan ulang pelanggan yang eksplisit.

Bisakah timeout membuktikan nomor telepon tidak memiliki operator?

Tidak. Timeout tidak memberikan kesimpulan operator normal, dan pencarian operator tidak menetapkan validitas atau keterjangkauan nomor.

Pelajari Lebih Lanjut

Pilih informasi produk yang sesuai dengan langkah selanjutnya dalam alur kerja Anda.

• Lihat dokumentasi produk →
• Hubungi tim →