Merencanakan Alur Kerja API Verifikasi Nomor Telepon Real-Time untuk Telegram

Panduan teknis untuk merancang alur kerja API verifikasi nomor telepon real-time dengan TG Validator, yang mencakup endpoint tunggal dan multi yang sinkron, batas konkurensi, format E.164, dan penafsiran sinyal.

Alur kerja verifikasi TG Validator dibangun di atas pemeriksaan real-time: kirim satu identifier E.164 ke POST /api/v1/check, atau hingga 100 identifier ke endpoint multi sinkron POST /api/v1/batch-check, dan hasil pendaftaran yang sudah selesai dikembalikan dalam respons HTTP dari permintaan tersebut. Kendalikan konkurensi di sisi klien sesuai dokumentasi API. Untuk seluruh daftar yang jauh melebihi satu permintaan real-time, tugas massal asinkron juga tersedia sebagai tambahan.

Memahami Model Verifikasi Sinkron

Model utama TG Validator bersifat sinkron. Gunakan POST /api/v1/check untuk satu identifier atau endpoint multi sinkron POST /api/v1/batch-check untuk hingga 100 identifier; hasil yang sudah selesai dikembalikan dalam respons HTTP yang sama, tanpa langkah pengiriman tugas, polling, callback, atau unduhan, dan tanpa syarat nomor dari negara yang sama. Sebagai alternatif untuk seluruh daftar berukuran besar, tugas massal asinkron (/api/v1/bulk-tasks) juga tersedia: unggah file, terima ID tugas, lalu pantau tugas dan unduh file hasil saat tugas selesai. Anda memilih negara asal nomor-nomor tersebut saat mengirim tugas, dan daftar tersebut pada dasarnya harus berasal dari satu negara itu. Bagian selanjutnya dari panduan ini berfokus pada jalur sinkron.

Menyiapkan Data Anda untuk Verifikasi

Sebelum memulai permintaan, pastikan semua nomor telepon dalam dataset Anda diformat sesuai rencana penomoran internasional E.164. API mewajibkan header X-API-Key dan header Content-Type: application/json. Gunakan POST /api/v1/check dengan service_type=tg dan satu identifier E.164, atau gunakan endpoint multi sinkron POST /api/v1/batch-check dengan service_type=tg dan array identifiers berisi hingga 100 nomor E.164. Karena TG Validator berfokus khusus pada Telegram, jenis layanannya harus selalu tg.

Merancang Arsitektur Alur Kerja API Verifikasi Nomor Telepon Real-Time

Mengelola throughput adalah komponen paling penting dalam alur kerja API verifikasi nomor telepon real-time. TG Validator API membatasi berapa banyak pemeriksaan yang dapat berjalan bersamaan untuk satu akun, dan dokumentasi API mencantumkan batas atas yang berlaku saat ini. Aplikasi di sisi klien Anda harus membatasi laju permintaan agar tetap dalam batas tersebut. Jika sistem Anda melampaui ambang ini, API akan menolak permintaan. Penolakan karena batas konkurensi tidak dikenakan biaya dan tidak menghasilkan hasil pemeriksaan, sehingga aplikasi Anda sebaiknya dirancang untuk berhenti sejenak dan mencoba ulang permintaan tersebut dengan aman.

Menafsirkan Sinyal Pendaftaran

API mengembalikan amplop respons terdokumentasi berisi code, message, dan data. Di dalam amplop ini, status pendaftaran Telegram terdapat di kolom data.registered. Hasil ini semata-mata berfungsi sebagai sinyal keberadaan akun pada saat pemeriksaan. Produk ini tidak mengembalikan kolom avatar atau business, sehingga payload sepenuhnya berfokus pada status pendaftaran.

Pemantauan dan Penanganan Kesalahan

Gunakan kode respons API untuk menangani kegagalan yang dapat dicoba ulang; lihat dokumentasi API untuk kode kesalahan dan batas yang berlaku saat ini.

FAQ

Apa yang harus saya lakukan jika mencapai batas konkurensi?

API hanya mengizinkan sejumlah pemeriksaan bersamaan yang terbatas untuk setiap akun, sebagaimana tercantum dalam dokumentasi API. Jika Anda melampauinya, API menolak permintaan tanpa memotong saldo Anda atau menghasilkan hasil. Aplikasi Anda sebaiknya menangkap kode kesalahan konkurensi, berhenti sejenak, lalu mencoba ulang permintaan.

Apakah status 'registered' memastikan bahwa pengguna dapat dihubungi?

Tidak. Sinyal pendaftaran hanya menunjukkan keberadaan akun Telegram tepat pada saat pemeriksaan.

Bagaimana alur kerja menangani daftar yang lebih besar dari satu permintaan?

Pertahankan endpoint multi sinkron sebagai jalur utama, hingga 100 identifier per permintaan, dalam batas konkurensi yang terdokumentasi. Untuk seluruh daftar yang jauh melebihi itu, tugas massal asinkron juga tersedia (unggah, tunggu, unduh); Anda memilih negara asal nomor-nomor tersebut saat mengirim, daftar tersebut pada dasarnya harus berasal dari satu negara itu, dan jumlah minimum serta maksimum per produk tercantum dalam dokumentasi API.

Bagaimana pemeriksaan yang gagal ditangani dari sisi penagihan?

Pemeriksaan yang gagal, melewati batas waktu, dan tidak dapat ditentukan tidak dikenakan biaya. Lihat halaman harga untuk detail paket dan saldo yang berlaku saat ini.