Verifikasi sinkron
Cara memeriksa registrasi nomor telepon Telegram secara real-time
Kirim satu nomor telepon E.164 dan baca status registrasi Telegram-nya dari respons API sinkron yang sama.
Produk ini menjawab satu pertanyaan yang tepat
TG Validator memeriksa apakah nomor telepon yang dikirim terdaftar di Telegram pada saat permintaan dibuat.
Produk ini menerima satu nomor telepon E.164, menggunakan service_type=tg, dan mengembalikan hasil yang sudah selesai dalam respons HTTP yang sama. Tidak ada job ID yang perlu di-polling dan tidak diperlukan callback sebelum aplikasi dapat membaca data.registered.
Cakupannya berakhir pada status registrasi. Respons tidak menyediakan username Telegram, profil, status aktivitas, kontak, grup, atau data pesan. Respons juga tidak mengidentifikasi orang yang menguasai nomor telepon tersebut. Ini bukan fitur tersembunyi; semua itu memang berada di luar kontrak produk.
False yang selesai berbeda dari pemeriksaan yang gagal
| Data yang dikembalikan | Keputusan registrasi | Cara menggunakannya |
|---|---|---|
code=0, registered=true |
Terdaftar pada saat pemeriksaan | Gunakan true sebagai hasil permintaan ini |
code=0, registered=false |
Tidak terdaftar pada saat pemeriksaan | Gunakan false sebagai hasil permintaan ini |
| Kode bisnis bukan nol | Tidak ada keputusan registrasi | Jangan membuat nilai boolean; tangani error atau coba ulang sesuai dokumentasi API |
Perbedaan ini penting karena registered=false adalah informasi yang dapat dipakai, dihasilkan oleh pemeriksaan yang selesai. Error API dikembalikan melalui amplop luar dengan status HTTP dan code numeriknya sendiri; error tersebut bukan nilai lain dari data.registered.
Jalur permintaan sinkron
- Siapkan masukan E.164 — Mulailah dengan konteks negara yang diketahui dan normalisasikan nomor menjadi tanda plus, kode panggilan negara, dan digit.
- Autentikasi permintaan — Gunakan kunci API yang dibuat di Pengaturan dan kirimkan dengan header yang terdokumentasi.
- Pilih produk Telegram — Atur
service_type=tg; jangan menyimpulkan produk dari field yang tidak berkaitan. - Tunggu respons yang sama — Pemeriksaannya sinkron, sehingga aplikasi menerima keputusan tanpa polling.
- Baca field hasil secara persis — Gunakan
data.registeredketikacode=0; biarkan kosong ketika API mengembalikan kode bisnis bukan nol. - Catat waktu pemeriksaan — Perlakukan hasil sebagai observasi terkini, bukan jaminan tanpa batas waktu.
Di mana perilaku real-time membantu
Kontrak sinkron cocok untuk perangkat lunak yang memerlukan satu keputusan registrasi terkini sebelum melanjutkan proses. Operator dapat memeriksa sebuah catatan di dasbor, aplikasi internal dapat memvalidasi nomor yang dikirim, atau worker backend dapat memproses catatan satu per satu.
Untuk daftar kecil, endpoint batch sinkron menerima hingga 100 identifier E.164 dan mengembalikan batch yang sudah selesai dalam respons yang memulainya. Klien bertanggung jawab atas penjadwalan dan konkurensi. Ini menjaga kontrak API tetap sederhana: setiap hasil yang selesai memiliki satu masukan, satu hasil registrasi Telegram, dan satu waktu observasi.
Catatan aplikasi minimal
Gunakan field yang eksplisit alih-alih label valid yang samar:
| Field | Tujuan |
|---|---|
source_phone |
Menyimpan apa yang diberikan oleh sistem sumber |
e164_phone |
Menyimpan nomor kanonis yang diperiksa |
service_type |
Mencatat tg sebagai kontrak hasil |
outcome |
Klasifikasi aplikasi Anda: selesai, dapat dicoba ulang, atau permintaan gagal |
registered |
Menyimpan true/false hanya untuk pemeriksaan yang selesai |
checked_at |
Memberi tanda waktu pada observasi registrasi |
Jika aplikasi memerlukan jawaban yang lebih baru, aplikasi sebaiknya melakukan panggilan sinkron lain. Aplikasi tidak boleh mengubah tanda waktu pada nilai lama atau mengklaim bahwa nilai cache bersifat real-time.
Aturan integrasi yang mencegah data keliru
code=0 memastikan bahwa boolean registered adalah jawaban registrasi yang sudah selesai.
Interpretasi dua tahap ini menjaga masalah masukan dan kondisi layanan sementara agar tidak masuk ke field status Telegram. Ini juga membuat janji produk menjadi tepat: TG Validator memberikan observasi registrasi terkini secara sinkron ketika pemeriksaan selesai, sementara sistem yang mengintegrasikannya menentukan kapan observasi baru diperlukan.