API/1. Inisialisasi Proses Verifikasi
2 min read
1. Inisialisasi Proses Verifikasi
Memulai sesi verifikasi baru dan mengaktifkan server koneksi.
Sistem ReOTP menggunakan fitur Wake-on-demand untuk menghemat sumber daya server. Ini berarti koneksi WhatsApp Anda dalam keadaan tidur, dan saat Anda mengirim permintaan ini, server akan bangun untuk membuka koneksi dan siap menerima pesan dari pelanggan.
Payload Permintaan (Request Body):
apiKey(string - wajib): API Key proyek Anda.
phoneNumber(string - wajib): Nomor telepon pengguna (contoh:+966500000000).
method(string - opsional): Metode verifikasi"WHATSAPP"atau"TELEGRAM"(default:"WHATSAPP").
returnUrl(string - opsional): URL tujuan setelah verifikasi berhasil di aplikasi Telegram.
Payload Respons (Response Body):
requestId(string): ID unik permintaan untuk memantau status verifikasi.
waLink(string): Link WhatsApp (hanya jika metodeWHATSAPP).
tgLink(string): Link Telegram (hanya jika metodeTELEGRAM).
expectedText(string): Teks pesan otomatis yang harus dikirim.
expiresIn(string): Waktu kadaluwarsa permintaan (2 menit).
Catatan Penting:
- Durasi Kadaluwarsa: Pengguna hanya memiliki 2 menit (02:00) untuk membuka link dan mengirim pesan otomatis sebelum sesi habis.
- Antarmuka Pengguna: Kami sangat menyarankan untuk menampilkan penghitung waktu mundur (countdown) agar pengguna segera mengirim pesan.
Kirim permintaan POST ke URL yang tertera di panel samping untuk memulai proses.
Integration Code (SDKs)
Interactive Playground
Platform Interaktif untuk Uji API
Masukkan nomor telepon untuk menginisialisasi sesi dan menguji respons server secara instan:
Interactive API Playground
Coba kirim permintaan verifikasi langsung dan generate kode integrasi dalam bahasa pemrograman favorit Anda.
curl -X POST https://reotp.com/api/verify/init \
-H "Authorization: Bearer 15a1c1c7-ed05-40df-b7c3-69c327542a07" \
-H "Content-Type: application/json" \
-d '{
"phoneNumber": "201000000000",
"method": "WHATSAPP"
}'