Çekya SMS OTP kodlarını endpoint'ler, webhook'lar veya panel üzerinden almak

Çekya OTP API hangi endpoint'lere dayanır?

Her şey https://otproute.com/api/v1 adresinde, or_live_ ile başlayan bir Bearer anahtarıyla çalışır. Anahtarları Developer console'da oluşturursunuz ve bir hesap bunlardan en fazla 10 tanesini tutabilir; böylece staging, CI ve yerel dizüstü bilgisayara ayrı ayrı iptal edilebilen ayrı kimlik bilgileri vermek kolaylaşır. Hız sınırı hesap başına dakikada 300 istektir.

Tipik bir +420 çalıştırması şöyle görünür:

1. GET /api/v1/countries ve GET /api/v1/services çağrılarını her dağıtımda bir kez yapıp önbelleğe alın. Çekya ülke kimliği cz'dir.
2. Kullanmayı planladığınız hattın canlı fiyatını GET /api/v1/prices?country=cz&service=<id> ile sorun; fiyat servise ve stoğa göre değişir.
3. POST /api/v1/activations ve {"service": "<id>", "country": "cz"} JSON gövdesiyle aktivasyonu oluşturun. Yanıt size bir aktivasyon kimliği ve test ettiğiniz kayıt formuna yazacağınız numarayı verir.
4. Kodu webhook ile ya da GET /api/v1/activations/{id} çağrısını makul aralıklarla yaparak bekleyin.
5. Test iptal edilirse numarayı POST /api/v1/activations/{id}/cancel ile serbest bırakın; böylece bloke edilen tutar hemen cüzdana döner.

Büyük bir test paketi başlamadan önce GET /api/v1/balance çağırmak, cüzdan azaldığında hızlıca hata almanın ucuz bir yoludur. Tam başvuru dokümanlarda yer alır.

+420 aktivasyonları için webhook'ları nasıl doğrularım?

Webhook'lar polling ihtiyacını ortadan kaldırır ve paralel test çalıştırıcılarına uygundur. Uç noktalarınızdan birini (Developer console hesap başına 5 tanesine izin verir) Çekya akışına yönlendirin ve activation.sms_received, activation.expired ile activation.cancelled olaylarına abone edin.

Her istek, t=<unix>,v1=<hex> biçiminde bir X-OTPRoute-Signature başlığı taşır. Dokunulmamış istek baytlarından <t>.<raw body> dizesini yeniden oluşturun, o uç noktanın gizli anahtarıyla HMAC-SHA256 hesaplayın, sonucu v1 ile sabit zamanlı karşılaştırın ve zaman damgası taze bir teslimat olamayacak kadar eski olan her şeyi reddedin. HMAC ile OTP webhook'larının güvenliği rehberimiz bir işleyiciyi satır satır anlatır.

Olayları aktivasyon kimliğine göre ele alın ve işleyiciyi idempotent yapın: yeniden denenen bir teslimat aktivasyonu zaten tamamlanmış olarak bulmalı ve yalnızca başarı döndürmelidir. Genel bir uç noktanın bulunmadığı ortamlarda çalışan betikler için GET /api/v1/activations/{id} ile polling geçerli bir yedek yöntem olarak kalır.

Hangi servisler Çek numaralarına kod gönderebilir?

Çekya hattı şu anda 1.700'den fazla servisi kapsıyor. Son anlık görüntüdeki popüler isimler arasında WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, Microsoft & Outlook, LinkedIn, Discord, Uber, Airbnb, Signal, Viber ve ChatGPT (OpenAI) bulunur.

Bu liste sabit değildir. Stok gün içinde hareket eder; bu yüzden kodunuz erişilebilirliği sabit bir tablodan değil, çalışma anında API'den okumalıdır. İhtiyacınız olan servis bir anda görünmüyorsa daha sonra yeniden çıkabilir ya da komşu bir Orta Avrupa hattı test senaryonuza uyabilir.

Çek doğrulama numarası nasıl saklanmalı ve ayrıştırılmalı?

Çek numaralandırması kapalı bir plandır: ulusal numaralar dokuz haneli olup trunk öneki yoktur; dolayısıyla yurt içi biçim ile uluslararası biçim yalnızca başa gelen +420 ile ayrılır. Bu, normalleştirmeyi birçok pazara göre daha basit kılar, ancak formlara yine de boşluklu girişler, 00420 uluslararası öneki ya da çıplak dokuz hane gelebilir. Ayırıcıları temizleyin, 00 önekini + ile değiştirin, eksikse +420 ekleyin ve sonucu E.164 olarak saklayın.

Çekya'ya yönelik uygulamaların kodları genellikle Çekçe veya İngilizce gelir. Çekçe metin, háček ve čárka gibi aksanlı harfler kullanır; bazı gönderenler mesajı sade bir karakter kümesinde tutmak için bunları siler, bu yüzden bir ayrıştırıcı tam bir cümleyi eşleştirmek yerine rakam grubunu aramalıdır.

Ekipler +420 numarasını, Çek müşteriler için bir ürün yayınlarken, Çekçe onboarding metinlerini kontrol ederken ya da bölgesel bir kayıt akışının başında sıfır olmayan numaraları kabul ettiğini doğrularken test için kullanır. QA testi sayfası, ekiplerin bu çalıştırmaları nasıl yapılandırdığını özetler.

Çek kodu hiç gelmezse ne yapılmalı?

Bazı servisler sanal numaraları reddeder ve bazı hatlar belirli saatlerde daha yavaştır. Kaçan bir kodun size maliyeti yoktur: 20 dakikalık pencere içinde SMS gelmezse ya da siz önce iptal ederseniz tutarın tamamı otomatik olarak cüzdana döner.

• Denemeyi başarısız saymadan önce pencerenin dolmasını bekleyin.
• Test ettiğiniz servisin sanal numaraları kabul edip etmediğini kontrol edin.
• Daha sonra yeniden deneyin ya da servisin desteklediği başka bir ülke hattını deneyin.
• Denemeler arasında bekleyin; sıkı bir döngüyle yeniden sipariş vermek hız sınırını tüketir ve nadiren işe yarar.
• Her başarısızlıkta aktivasyon kimliğini kaydedin; böylece çalıştırmalar arasındaki örüntüler görünür olur.

Geliştirici olmayanlar +420 hattını panelden kullanabilir mi?

Evet. E-posta ve 6 haneli e-posta koduyla (ya da Google ile oturum açarak) kaydolduktan sonra OTP Gateway'i açın, servisi ve Çekya'yı seçin, gösterilen fiyatı kontrol edin ve sipariş verin. Çekya doğrulama numarası hemen görünür; onu uygulamaya yapıştırın, kod geldiğinde aynı ekranda belirir. Panelden iptal etmek, tutarı API çağrısıyla aynı şekilde cüzdana iade eder.

Uzun vadeli bir Çek numarası var mı, faturalama nasıl işler?

Bugün için kendi kendine alınabilen uzun vadeli bir Çek numarası yoktur. Dedicated Numbers, ABD ve Kanada'ya özel, $1.95/month'ten başlayan bir üründür; gelen ve giden SMS ile tarayıcıdan aramayı kapsar. Ayrıntılar için sanal numaralar sayfasına bakın. Ekibinizin kalıcı bir +420 hattına ihtiyacı varsa [email protected] adresine e-posta gönderip sorun; ancak bunun mümkün olup olmadığı yerel kurallara bağlıdır ve söz verilmez.

Faturalama, aylık ücreti ve seçilecek bir planı olmayan tek bir ön ödemeli USD cüzdanıyla yapılır. Bakiye kartla ya da USDT/USDC olarak yüklenir ve her yükleme için e-postayla bir PDF fatura gönderilir. Entegrasyon çalışmaları için geliştirme hesabı talep üzerine sandbox'a alınabilir; böylece simüle numaralar ve kodlar tüm akışı cüzdan bakiyesi harcamadan sınar. Hesabın kendisi için TOTP ile iki faktörlü oturum açma da mevcuttur.

Sık sorulan sorular

Çek SIM'i olmadan uygulamamın Çekya kayıt akışını test edebilir miyim?

Evet. Test ettiğiniz servis için OTP Gateway'den bir +420 numarası sipariş edin, uygulamanıza girin ve kodu panelden, API'den ya da bir webhook'tan okuyun.

OTP Route API'sinde Çekya'nın ülke kimliği nedir?

POST /api/v1/activations içindeki country alanında ve fiyat sorgularında cz kullanın.

Bir Çekya doğrulama kodu ne kadar tutar?

Kodlar $0.20'den başlar; her servis için kesin fiyatı GET /api/v1/prices döndürür ve siz sipariş vermeden önce gösterilir. Yalnızca kod geldiğinde ödeme yaparsınız.

Çek numaralarında baştaki sıfır gerekir mi?

Hayır. Çek numaralarında trunk öneki yoktur; bu yüzden onları +420 ve ardından dokuz ulusal hane olarak saklayın.

Bir +420 aktivasyonu ne kadar süre açık kalır?

Yirmi dakika. Bu sürede hiçbir şey gelmezse aktivasyonun süresi dolar ve cüzdana tam iade yapılır.

Çekya'ya OTP yönlendirmesi toplu hesap oluşturmak için uygun mu?

Hayır. OTP Route, kendi ürününüzü test etmek ve kendi meşru hesaplarınızı işletmek içindir. Her +420 aktivasyonunu kendi ürününüze veya hesabınıza bağlı tutun; her servisin şartları ve OTP Route Kabul Edilebilir Kullanım Politikası geçerlidir.

Sonraki girişler için aynı Çek numarasını elimde tutabilir miyim?

Kendi kendine alınan bir ürün olarak hayır. Uzun vadeli Dedicated Numbers yalnızca Amerika Birleşik Devletleri ve Kanada'da bulunur; diğer pazarlar için destek ekibine e-posta gönderip sorabilirsiniz.

Hizmet adları ilgili sahiplerinin ticari markalarıdır. OTP Route bunlarla bağlantılı değildir. Numaraları yasalara uygun kullanın; her hizmetin şartlarına ve Kabul Edilebilir Kullanım Politikamıza uyun.