Cara TG Validator memverifikasi nomor Telegram

Menyelesaikan satu pemeriksaan

Bagian ini membahas pemeriksaan real-time: dasbor SaaS dan endpoint REST sinkron berbagi satu layanan pemeriksaan dan satu arti respons. Daftar yang sangat besar memiliki opsi massal asinkron, yang dibahas di akhir halaman ini.

1. 1

   Kirim nomor

   Kirim satu nomor E.164 beserta kode negaranya, sebagaimana dijelaskan dalam dokumentasi API.

2. 2

   Gunakan service_type=tg

   Produk tg memeriksa apakah nomor terdaftar di Telegram pada saat pemeriksaan.

3. 3

   Baca hasilnya

   Baca registered dalam respons yang sama. Jalankan pemeriksaan baru jika Anda membutuhkan status terbaru.

Format nomor yang harus dikirim

TG Validator menerima satu nomor per pemeriksaan, ditulis dalam format E.164: tanda plus, kode negara, lalu nomor pelanggan tanpa spasi atau tanda baca — misalnya +17253100591. Ini adalah format yang sama yang disimpan aplikasi Telegram secara internal, sehingga nomor dalam bentuk ini terpetakan ke tepat satu akun. Nomor tanpa kode negara tidak dapat diperiksa dengan andal: deretan angka yang sama ada di banyak negara.

• Selalu sertakan kode negara; jangan mengandalkan negara akun Anda sendiri.
• Hapus spasi, tanda hubung, tanda kurung, dan angka nol di depan yang digunakan untuk panggilan domestik — sisakan hanya + dan digit.
• Nomor dengan format yang salah ditolak sebelum ada tagihan; format yang ditolak bukan hasil "tidak terdaftar".

Apa arti registered?

registered adalah jawaban dari pemeriksaan Telegram. Field ini hanya muncul dalam respons yang berhasil, dan berupa boolean: true berarti nomor terdaftar di Telegram pada saat permintaan, false berarti tidak. Hal lain — batas waktu habis, hasil yang tidak dapat ditentukan, nomor tidak valid — dikembalikan sebagai kode error, dan TG Validator mengembalikan biaya pemeriksaan tersebut secara otomatis. Jadi, field registered yang tidak ada tidak pernah berarti "tidak terdaftar"; artinya pemeriksaan tidak menghasilkan hasil. Nilainya mencerminkan saat Anda bertanya: akun dibuat dan dihapus setiap saat, jadi perbarui pemeriksaan sebelum bertindak berdasarkan hasil lama, alih-alih menyimpannya dalam cache selama berminggu-minggu.

• registered=true berarti terdaftar.
• registered=false berarti tidak terdaftar.
• Tangani hasil lain sesuai kode respons API; jangan menyimpulkan registered sendiri.

Gunakan hasil sesuai cakupannya

Pemeriksaan mencerminkan status pada saat permintaan. Ini bukan verifikasi identitas atau izin untuk menghubungi seseorang.

• Tidak mengonfirmasi siapa pemilik nomor, apakah mereka sedang online saat ini, atau isi pesan apa pun; produk aktivitas mengembalikan hari aktif (hari sejak terakhir terlihat), bukan kehadiran langsung.
• Hasil terdaftar tidak menetapkan persetujuan untuk menghubungi nomor tersebut.
• Jalankan pemeriksaan baru jika keputusan bisnis membutuhkan status terkini.

Daftar yang sangat besar: opsi asinkron

Pemeriksaan multi di dasbor dan endpoint multi API mencakup sebagian besar daftar. Hanya jika daftar jauh melebihi batas tersebut, masuk akal untuk mengirim seluruh file sebagai satu tugas massal asinkron — Anda memilih negara asal daftar, dan daftar tersebut sebaiknya pada dasarnya berasal dari satu negara itu.

• Unggah file .txt atau .csv dengan satu nomor E.164 per baris, dari halaman pemeriksaan massal atau melalui API.
• Pilih negara asal nomor saat mengirim; daftar sebaiknya pada dasarnya berasal dari satu negara itu. Terlalu banyak nomor dari negara lain membuat tugas gagal saat file sedang disiapkan — tugas tidak dikirim untuk diperiksa dan dikembalikan sepenuhnya.
• Saldo dicadangkan untuk baris yang valid saat pengiriman, Anda hanya ditagih untuk nomor yang mengembalikan hasil, dan selisihnya dikembalikan.
• Tugas berjalan di latar belakang; unduh file hasil setelah selesai. Tugas yang gagal dikembalikan sepenuhnya.