Qatar OTP API: Webhook, Polling, dan Nomor Uji +974

Seperti apa urutan panggilan Qatar OTP API?

Semuanya berada di bawah https://otproute.com/api/v1, diautentikasi dengan Bearer key berawalan or_live_. Anda dapat memegang hingga 10 key, jadi berikan key terpisah untuk CI, staging, dan skrip operasional agar satu key bisa dicabut tanpa mengganggu yang lain. Satu aktivasi +974 lengkap paling banyak membutuhkan empat panggilan:

1. GET /api/v1/prices?country=qa&service=<id> mengembalikan harga live dan memberi tahu bahwa rute terbuka untuk layanan itu saat ini.
2. POST /api/v1/activations dengan {"service": "<id>", "country": "qa"} memesan nomor Qatar dan mengembalikan id aktivasi.
3. GET /api/v1/activations/{id} adalah panggilan polling: ia menunjukkan posisi pesanan Qatar dan memuat kodenya setelah terkirim.
4. POST /api/v1/activations/{id}/cancel mengakhiri pesanan lebih awal dan mengembalikan jumlahnya ke dompet.

Dua pembantu melengkapi gambaran: GET /api/v1/services memetakan nama ke id layanan, dan GET /api/v1/balance memungkinkan pipeline berhenti sebelum saldo habis. Jaga lalu lintas di bawah 300 permintaan per menit per akun. Ikhtisar developer mengumpulkan halaman-halaman referensinya.

Bagaimana handler webhook sebaiknya memperlakukan event aktivasi Qatar?

Polling memang berfungsi, tetapi webhook memungkinkan test runner Anda bereaksi begitu sesuatu terjadi. Daftarkan hingga lima endpoint dan berlangganan activation.sms_received, activation.expired, dan activation.cancelled; yang pertama membawa kode, sedangkan dua lainnya memberi tahu runner untuk berhenti menunggu.

Setiap permintaan menyertakan X-OTPRoute-Signature dalam bentuk t=<unix>,v1=<hex>. Susun ulang string yang ditandatangani sebagai timestamp, titik, dan body mentah permintaan, hitung HMAC-SHA256 dengan secret endpoint, lalu bandingkan secara constant-time. Tolak apa pun dengan timestamp kedaluwarsa. Karena percobaan ulang dapat mengirim event yang sama lebih dari sekali, simpan id aktivasi dan abaikan pengulangan. Untuk implementasi acuan, baca penangkapan OTP berbasis webhook.

Layanan apa saja yang bisa mengirim kode ke nomor +974?

Qatar termasuk rute yang luas, dengan lebih dari 1.600 layanan pada snapshot terbaru. Entri populer antara lain WhatsApp, Google (Gmail & YouTube), Microsoft & Outlook, Telegram, Instagram, Facebook, LinkedIn, Snapchat, TikTok, Uber, Airbnb, ChatGPT (OpenAI), Claude, dan Discord.

Inventaris bergeser sepanjang hari, jadi anggap snapshot sebagai orientasi dan jawaban API sebagai kebenaran. Beberapa layanan menolak nomor virtual; ketika itu terjadi, pesanan cukup kedaluwarsa dan uangnya kembali. Setiap nama di atas adalah merek dagang pemiliknya, tanpa afiliasi yang tersirat.

Menormalkan nomor Qatar pada fixture pengujian

Nomor Qatar memiliki delapan digit setelah +974 dan tanpa awalan trunk, jadi tidak ada yang perlu dibuang saat mengubah nomor lokal ke bentuk internasional. Simpan fixture dalam E.164 (+974 ditambah delapan digit), dan bersihkan input yang diketik pengguna dengan 00974, spasi, atau angka nol di depan yang terbawa dari kebiasaan negara lain.

Bahasa Arab adalah bahasa resmi, sedangkan bahasa Inggris dipakai luas dalam bisnis dan oleh penduduk dengan porsi ekspatriat yang besar. Karena itu teks verifikasi tiba dalam bahasa apa pun yang dipilih layanan pengirim untuk akun tersebut, sering kali Inggris atau Arab. Pastikan logika ekstraksi Anda menemukan kode dalam kedua aksara dan bahwa UI berbahasa Arab menjaga input OTP tetap nyaman dipakai pada tata letak kanan-ke-kiri.

Tim menguji rute Qatar saat meluncur di GCC, melokalkan aplikasi konsumen untuk penutur Arab, menjalankan operasi perhotelan atau logistik di Doha, atau memverifikasi akun bisnis regional tanpa memasang nomor pribadi karyawan. Panduan pengujian CI menunjukkan cara menyambungkan pemeriksaan ini ke eksekusi otomatis.

Menjalankan pemeriksaan Qatar dari dasbor

Tidak semua verifikasi membutuhkan skrip. Di dasbor, buka OTP Gateway, pilih Qatar dan layanannya, tinjau harga yang ditampilkan, lalu konfirmasi. Salin nomor +974 ke aplikasi, minta SMS, dan kode muncul pada pesanan. Jendela 20 menit dihitung sejak Anda membuat pesanan, dan Anda hanya membayar jika kode muncul.

Kode yang tidak tiba: daftar debugging

• Sudah menunggu cukup lama? Biarkan aktivasi menjalani seluruh jendelanya sebelum menganggapnya gagal.
• Nomor virtual diterima? Sebagian layanan memblokirnya, dan percobaan berulang tidak akan mengubahnya.
• Kebijakan retry sudah waras? Lakukan backoff dan coba lagi nanti, atau pindah ke rute lain untuk layanan yang sama. Memesan ulang dalam perulangan cepat menghabiskan batas laju Anda dan jarang membantu.
• Handler sehat? Jika pemeriksaan tanda tangan gagal atau endpoint mengembalikan error, polling GET /api/v1/activations/{id} untuk melihat apakah kode terkirim saat webhook Anda terlewat.

Aktivasi yang berakhir tanpa SMS, baik karena kedaluwarsa maupun dibatalkan, dikembalikan penuh.

Adakah jalur Qatar jangka panjang, dan bagaimana pemakaian ditagih?

Tidak ada nomor jangka panjang swalayan untuk Qatar. Dedicated Virtual Numbers (jalur milik Anda dengan SMS masuk dan keluar, penerusan webhook, dan panggilan lewat browser) hanya ditawarkan di Amerika Serikat dan Kanada, mulai $1.95/bulan. Untuk kebutuhan khusus Qatar, kirim email ke [email protected]; aturan setempat menentukan apa yang mungkin.

Pemakaian Qatar diambil dari satu dompet USD prabayar, dan tidak ada tagihan bulanan. Isi saldo lewat kartu atau USDT/USDC, ambil faktur PDF untuk setiap isi saldo, dan minta mode sandbox pada akun pengembangan jika Anda ingin menguji integrasi dengan nomor simulasi. Gunakan nomor +974 hanya untuk produk Anda sendiri dan akun bisnis yang sah, hormati ketentuan tiap layanan, dan patuhi Acceptable Use Policy OTP Route.

Pertanyaan umum

Bagaimana cara menerima kode SMS OTP Qatar dalam pengujian otomatis?

Buat aktivasi dengan negara qa, masukkan nomor yang dikembalikan ke aplikasi yang diuji, lalu tunggu webhook activation.sms_received. OTP Route juga mendukung polling aktivasi jika test runner Anda tidak bisa menerima permintaan masuk.

Bisakah saya memakai nomor +974 untuk pengujian tanpa SIM Qatar?

Bisa. OTP Gateway menyediakan nomor verifikasi Qatar untuk satu kode, sehingga Anda dapat menguji alur pendaftaran atau login tanpa SIM atau perangkat lokal.

Bagaimana cara memeriksa harga Qatar sebelum memesan?

Panggil GET /api/v1/prices?country=qa&service=<id> atau lihat di dasbor. Tarif mulai $0.20 per kode dan bervariasi menurut layanan.

Apakah saya ditagih untuk aktivasi Qatar yang gagal?

Tidak. Anda hanya ditagih ketika kode tiba; aktivasi yang kedaluwarsa atau dibatalkan dikembalikan otomatis ke dompet.

Mengapa menguji dengan nomor Qatar dan bukan nomor dari negara tetangga?

Pilih negara yang sesuai dengan pasar sebenarnya dari akun tersebut. Jika produk Anda diluncurkan di Qatar, nomor +974 menguji penanganan kode negara, bahasa, dan OTP routing yang akan dilihat pelanggan Anda, seperti dijelaskan di routing negara untuk OTP.

Bisakah akun pengembangan berjalan tanpa dana di dompet?

Bisa. Atas permintaan, akun pengembangan dapat dialihkan ke sandbox, yang mengembalikan nomor dan kode simulasi untuk pengujian end-to-end.

Bisakah saya mempertahankan nomor Qatar untuk login berulang?

Tidak secara swalayan, karena jalur dedicated terbatas pada AS dan Kanada. Kirim email ke [email protected] jika Anda ingin menanyakan jalur Qatar jangka panjang.

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.