Cara Memverifikasi Pendaftaran Telegram dari CSV Nomor Telepon secara Real-Time

Panduan teknis untuk memverifikasi pendaftaran Telegram dari CSV nomor telepon secara real-time dengan TG Validator, dengan fokus pada persiapan data, endpoint tunggal dan multi yang sinkron, pengelolaan konkurensi, dan penafsiran hasil.

TG Validator memverifikasi pendaftaran Telegram secara real-time: kirim satu nomor E.164 ke POST /api/v1/check, atau hingga 100 nomor ke endpoint multi sinkron POST /api/v1/batch-check, dan hasil yang sudah selesai dikembalikan dalam respons HTTP yang sama. Untuk memverifikasi CSV, standarkan kolomnya dalam E.164, kirimkan melalui endpoint multi hingga 100 identifier per permintaan, dan kelola konkurensi di sisi klien sesuai dokumentasi API. Seluruh file yang jauh melebihi satu permintaan real-time juga dapat diunggah sebagai tugas massal asinkron.

Menyiapkan Data Anda untuk Verifikasi

Saat memproses CSV berisi kontak, langkah pertama adalah menstandarkan masukan. TG Validator mewajibkan semua nomor telepon yang dikirim menggunakan format E.164. Rencana penomoran internasional ini memastikan setiap nomor unik secara global, biasanya diawali dengan '+' yang diikuti kode negara dan nomor pelanggan. Menstandarkan kolom CSV Anda ke E.164 sebelum memulai permintaan API mencegah kesalahan nomor telepon tidak valid dan memastikan sistem dapat memeriksa status pendaftaran Telegram secara akurat.

Memahami Alur Kerja TG Validator API

Model utama TG Validator adalah permintaan-respons sinkron, baik untuk pemeriksaan tunggal maupun pemeriksaan multi. Gunakan POST /api/v1/check untuk satu nomor, atau endpoint multi sinkron POST /api/v1/batch-check dengan service_type=tg untuk hingga 100 identifier E.164 dari CSV; keduanya mengembalikan hasil dalam respons HTTP yang sama, tanpa langkah pengiriman tugas, polling, atau unduhan.

Mengelola Throughput dan Batas API

Proses CSV melalui endpoint multi sinkron, hingga 100 identifier per permintaan, dan patuhi kontrol penggunaan API platform. TG Validator menerapkan batas konkurensi per pengguna, jadi pastikan nilai yang berlaku saat ini di dokumentasi API sebelum menentukan berapa banyak permintaan yang dibiarkan terbuka oleh skrip Anda. Untuk seluruh file yang jauh melebihi satu permintaan real-time, tugas massal asinkron juga tersedia (unggah, tunggu, unduh); lihat dokumentasi API untuk batasnya yang berlaku saat ini. Jika skrip Anda melampaui ambang ini, API akan mengembalikan kode kesalahan khusus yang menunjukkan bahwa semua slot konkurensi sedang terpakai atau bahwa pemeriksaan kehabisan waktu. Penolakan semacam ini tidak dikenakan biaya dan tidak menghasilkan hasil pemeriksaan. Menerapkan jeda atau antrean pembatas konkurensi dalam skrip pemrosesan CSV Anda memastikan eksekusi berjalan lancar tanpa kesalahan yang tidak perlu.

Menafsirkan Hasil dan Menangani Kesalahan

API mengembalikan amplop respons terdokumentasi yang berisi code, msg, dan data. Untuk pemeriksaan Telegram, kolom data.registered memberikan sinyal keberadaan akun. Untuk pemeriksaan Telegram yang selesai, data yang dikembalikan hanya berisi service_type, identifier, dan registered; kolom internal terkait catatan, transaksi, status, dan penagihan tidak dikembalikan.

FAQ

Dalam format apa nomor telepon harus dikirim untuk verifikasi?

Semua nomor telepon harus dikirim dalam format E.164, yang memastikan setiap nomor unik secara global dengan diawali '+' yang diikuti kode negara dan nomor pelanggan.

Apa yang terjadi jika saya melampaui batas konkurensi?

Jika Anda melampaui batas konkurensi yang terdokumentasi, API mengembalikan kode kesalahan. Penolakan karena batas ini tidak dikenakan biaya dan tidak menghasilkan hasil pemeriksaan.

Bisakah saya memeriksa beberapa nomor dalam satu permintaan?

Ya. Endpoint multi sinkron POST /api/v1/batch-check menerima hingga 100 identifier E.164 dan mengembalikan hasil yang sudah selesai dalam respons HTTP yang sama. Untuk seluruh file yang jauh melebihi itu, tugas massal asinkron juga tersedia (Anda memilih negara asal nomor-nomor tersebut saat mengirim, dan daftar tersebut pada dasarnya harus berasal dari satu negara itu), tetapi endpoint sinkron tetap menjadi cara utama untuk memeriksa.