Menerima kode OTP SMS Republik Ceko lewat endpoint, webhook, atau dasbor

Endpoint mana yang dipakai API OTP Republik Ceko?

Semuanya berjalan di https://otproute.com/api/v1 dengan kunci Bearer berawalan or_live_. Anda membuat kunci di konsol Developer, dan satu akun bisa menyimpan hingga 10 kunci, sehingga staging, CI, dan laptop lokal dapat diberi kredensial terpisah yang bisa dicabut sendiri-sendiri. Batas lajunya 300 permintaan per menit per akun.

Satu putaran +420 yang umum terlihat seperti ini:

1. Ambil GET /api/v1/countries dan GET /api/v1/services sekali per deploy lalu simpan di cache. ID negara Ceko adalah cz.
2. Minta harga langsung untuk rute yang akan dipakai lewat GET /api/v1/prices?country=cz&service=<id>; harganya berubah menurut layanan dan stok.
3. Buat aktivasi dengan POST /api/v1/activations dan badan JSON {"service": "<id>", "country": "cz"}. Responsnya memberi ID aktivasi dan nomor yang diketik ke formulir pendaftaran yang sedang diuji.
4. Tunggu kodenya, lewat webhook atau dengan membaca GET /api/v1/activations/{id} pada interval yang wajar.
5. Jika pengujian dibatalkan, lepaskan nomor dengan POST /api/v1/activations/{id}/cancel agar dana yang ditahan langsung kembali ke dompet.

Memanggil GET /api/v1/balance sebelum rangkaian pengujian besar dimulai adalah cara murah untuk langsung gagal saat saldo dompet menipis. Referensi lengkapnya ada di dokumentasi.

Bagaimana memverifikasi webhook untuk aktivasi +420?

Webhook menghilangkan kebutuhan polling dan cocok untuk test runner paralel. Arahkan salah satu endpoint Anda (konsol Developer mengizinkan 5 per akun) ke alur Ceko dan langganan event activation.sms_received, activation.expired, dan activation.cancelled.

Setiap permintaan membawa header X-OTPRoute-Signature dengan format t=<unix>,v1=<hex>. Susun ulang string <t>.<raw body> dari byte permintaan yang belum diubah, hitung HMAC-SHA256 dengan secret endpoint tersebut, bandingkan hasilnya dengan v1 secara constant-time, dan buang apa pun yang timestamp-nya terlalu lama untuk dianggap pengiriman baru. Panduan kami tentang mengamankan webhook OTP dengan HMAC membahas handler baris demi baris.

Perlakukan event sebagai terkait pada ID aktivasi dan buat handler bersifat idempoten: pengiriman ulang harus menemukan aktivasi sudah ditandai selesai dan cukup mengembalikan sukses. Polling GET /api/v1/activations/{id} tetap menjadi cadangan yang sah untuk skrip yang berjalan di tempat tanpa endpoint publik.

Layanan apa saja yang bisa mengirim kode ke nomor Ceko?

Rute Ceko saat ini mencakup lebih dari 1.700 layanan. Nama-nama populer dalam snapshot terbaru antara lain WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, Microsoft & Outlook, LinkedIn, Discord, Uber, Airbnb, Signal, Viber, dan ChatGPT (OpenAI).

Daftar ini tidak beku. Stok bergerak sepanjang hari, jadi kode sebaiknya membaca ketersediaan dari API saat dijalankan, bukan dari tabel yang ditulis tetap. Jika layanan yang Anda butuhkan hilang pada satu saat, ia mungkin muncul lagi nanti, atau rute Eropa Tengah di sekitarnya bisa cocok untuk kasus uji Anda.

Bagaimana menyimpan dan mengurai nomor verifikasi Ceko?

Penomoran Ceko bersifat tertutup: nomor nasional terdiri dari sembilan digit dan tidak ada awalan trunk, sehingga bentuk domestik dan internasional hanya berbeda pada +420 di depannya. Itu membuat normalisasi lebih sederhana daripada di banyak pasar, tetapi formulir tetap bisa menerima spasi, awalan internasional 00420, atau sembilan digit tanpa kode negara. Buang pemisah, ubah 00 menjadi +, tambahkan +420 bila belum ada, lalu simpan hasilnya dalam format E.164.

Kode dari aplikasi yang menyasar pengguna Ceko biasanya datang dalam bahasa Ceko atau Inggris. Teks Ceko memakai tanda diakritik seperti háček dan čárka, dan sebagian pengirim menghapusnya agar pesan tetap memakai set karakter polos, jadi parser sebaiknya mencari kelompok digit, bukan mencocokkan kalimat utuh.

Tim memakai nomor +420 untuk pengujian saat meluncurkan produk bagi pelanggan Ceko, memeriksa teks onboarding berbahasa Ceko, atau memastikan alur pendaftaran regional menerima nomor tanpa nol di depan. Halaman pengujian QA menguraikan bagaimana tim menyusun putaran semacam ini.

Apa yang harus dilakukan saat kode Ceko tidak pernah tiba?

Sebagian layanan menolak nomor virtual, dan sebagian rute lebih lambat pada jam tertentu. Kode yang tidak masuk tidak dikenai biaya: jika tidak ada SMS dalam jendela 20 menit, atau Anda membatalkan lebih dulu, seluruh jumlahnya otomatis kembali ke dompet.

• Biarkan jendela waktu berjalan sebelum menyimpulkan percobaan gagal.
• Periksa apakah layanan yang Anda uji menerima nomor virtual sama sekali.
• Coba lagi nanti, atau coba rute negara lain yang didukung layanan tersebut.
• Beri jeda antarpercobaan; memesan ulang dalam putaran cepat menghabiskan batas laju dan jarang membantu.
• Catat ID aktivasi pada setiap kegagalan agar pola terlihat di berbagai putaran.

Bisakah non-developer memakai rute +420 dari dasbor?

Bisa. Setelah mendaftar dengan email dan kode email 6 digit (atau masuk dengan Google), buka OTP Gateway, pilih layanan dan Republik Ceko, periksa harga yang ditampilkan, lalu pesan. Nomor verifikasi Republik Ceko langsung muncul; tempelkan ke aplikasi, dan kode tampil di layar yang sama saat tiba. Pembatalan dari dasbor mengembalikan dana ke dompet dengan cara yang sama seperti panggilan API.

Adakah nomor Ceko jangka panjang, dan bagaimana penagihannya?

Saat ini tidak ada nomor Ceko jangka panjang swalayan. Nomor Khusus (Dedicated Numbers) adalah produk khusus Amerika Serikat dan Kanada mulai $1.95/month, mencakup SMS masuk dan keluar serta panggilan lewat browser; lihat nomor virtual untuk detailnya. Jika tim Anda membutuhkan saluran +420 yang bertahan lama, kirim email ke [email protected] dan tanyakan, dengan pemahaman bahwa ketersediaan bergantung pada aturan setempat dan tidak dijanjikan.

Penagihan memakai satu dompet USD prabayar tanpa biaya bulanan dan tanpa paket yang harus dipilih. Dana masuk lewat kartu atau USDT/USDC, dan setiap isi saldo memicu faktur PDF yang dikirim lewat email. Untuk pekerjaan integrasi, akun pengembangan dapat dialihkan ke sandbox atas permintaan sehingga nomor dan kode simulasi menjalankan seluruh alur tanpa memakai dana dompet. Masuk dua faktor dengan TOTP juga tersedia untuk akun itu sendiri.

Pertanyaan umum

Bisakah saya menguji alur pendaftaran Ceko di aplikasi saya tanpa SIM Ceko?

Bisa. Pesan nomor +420 dari OTP Gateway untuk layanan yang Anda uji, masukkan di aplikasi, lalu baca kodenya dari dasbor, API, atau webhook.

Apa ID negara Republik Ceko di API OTP Route?

Gunakan cz pada kolom country di POST /api/v1/activations dan pada pencarian harga.

Berapa harga satu kode verifikasi Ceko?

Kode mulai dari $0.20 per kode, dan harga pasti tiap layanan dikembalikan oleh GET /api/v1/prices serta ditampilkan sebelum Anda memesan. Anda hanya membayar jika kode tiba.

Apakah nomor Ceko memerlukan angka nol di depan?

Tidak. Nomor Ceko tidak punya awalan trunk, jadi simpan sebagai +420 diikuti sembilan digit nasional.

Berapa lama aktivasi +420 tetap terbuka?

Dua puluh menit. Jika tidak ada yang masuk dalam waktu itu, aktivasi kedaluwarsa dan dompet dikembalikan penuh.

Apakah perutean OTP ke Republik Ceko cocok untuk pembuatan akun massal?

Tidak. OTP Route ditujukan untuk menguji produk Anda sendiri dan mengoperasikan akun sah milik Anda sendiri. Kaitkan setiap aktivasi +420 dengan produk atau akun Anda sendiri, sesuai ketentuan tiap layanan dan Kebijakan Penggunaan yang Dapat Diterima OTP Route.

Bisakah saya mempertahankan nomor Ceko yang sama untuk login berikutnya?

Tidak sebagai produk swalayan. Nomor Khusus jangka panjang hanya ada di Amerika Serikat dan Kanada, dan Anda bisa mengirim email ke tim dukungan untuk menanyakan pasar lain.

Nama layanan adalah merek dagang milik pemiliknya masing-masing. OTP Route tidak berafiliasi dengan mereka. Gunakan nomor secara sah, patuhi ketentuan tiap layanan dan Kebijakan Penggunaan yang Dapat Diterima kami.