Polonya (+48) doğrulama kodları: kontrol listesi, API adımları ve çözümler

Ön kontrol: Polonya kayıtlarını test etmeden önce neye ihtiyacım var?

Bu listeyi bir kez gözden geçirin; ilk Polonya siparişi genellikle sorunsuz geçer:

1. Kimlik bilgileri. Developer console'da bir Bearer anahtarı oluşturun (or_live_ ile başlar). Staging, CI ve üretim için ayrı anahtarlar rotasyonu sorunsuz kılar.
2. Tanımlayıcılar. Polonya pl'dir. Görünen adları sabit kodlamak yerine hizmet kimliklerini GET /api/v1/services ile çekin.
3. Bakiye. Cüzdana bakiye yükleyin; her fiyat siparişten önce görünür.
4. Teslim hedefi. Bir HTTPS webhook kaydedin ve sırrını kaynak kontrolünün dışında tutun. Gelen trafik engelliyse sorgulama da çalışır.
5. İstek bütçesi. API hesap başına dakikada 300 isteğe izin verir; bu yüzden paralel paketleri buna göre kısıtlayın.
6. Kapsam. Yalnızca kendi ürününüze, şirketinize ya da müşterinize ait hesapları doğrulayın ve Kabul Edilebilir Kullanım Politikamızın yanı sıra her hizmetin şartlarına uyun.

Özellikle pipeline'lar için CI pipeline'larında SMS OTP testi yazısına bakın.

Şu anda hangi hizmetler +48 numaralarına kod gönderiyor?

OTP yönlendirmesi açısından Polonya, katalogdaki daha geniş girişlerden biridir ve 2.300'den fazla hizmeti kapsar. Popüler olanların güncel dökümü Facebook, Instagram, TikTok, WhatsApp, Telegram, Viber, Signal, Snapchat, Discord, X (Twitter), LinkedIn, Google (Gmail & YouTube), Amazon, AliExpress, Uber ve Netflix hizmetlerini içeriyor.

Bu listeyi bir söz olarak değil, bir başlangıç noktası olarak değerlendirin. Herhangi bir rotadaki kullanılabilirlik gün içinde değişir; bu yüzden her siparişten önce fiyat endpoint'ine belirli çifti sorun.

Polonya OTP API'si için kesin adımlar nelerdir?

https://otproute.com/api/v1 adresindeki SMS doğrulama API'sini kullanan otomatik bir test şunları yapar:

1. GET /api/v1/prices?country=pl&service=<id> o hizmet için Polonya'da canlı bir fiyatı doğrular.
2. {"service": "<id>", "country": "pl"} gövdesiyle POST /api/v1/activations +48 numarasını ve bir aktivasyon kimliğini döndürür.
3. Testiniz numarayı kayıt formuna yazar ve SMS ister.
4. İşleyici activation.sms_received alır; activation.expired ya da activation.cancelled görürse çalıştırmayı teslim edilmedi olarak işaretler.
5. Webhook yoksa, kod görünene ya da pencere bitene kadar birkaç saniyede bir GET /api/v1/activations/{id} okuyun.
6. Bir test erken sonlandırıldığında POST /api/v1/activations/{id}/cancel çağırın.

Herhangi bir yüke güvenmeden önce X-OTPRoute-Signature başlığını doğrulayın: t=<unix>,v1=<hex> içerir ve v1, endpoint sırrıyla imzalanmış <t>.<raw body> değerinin HMAC-SHA256'sıdır. Eski zaman damgalı her şeyi reddedin ve işleyiciyi aktivasyon kimliği üzerinden idempotent yapın. Webhook güvenliği rehberi kontrolü ayrıntılı gösterir.

Operasyon ekibim API olmadan bir Polonya numarası sipariş edebilir mi?

Evet. OTP Route panelinde OTP Gateway'i açın, Polonya'yı seçin, hizmeti arayın ve görüntülenen fiyatı onaylayın. Sipariş verdikten sonra Polonya doğrulama numarasını uygulamanın doğrulama ekranına kopyalayın ve aktivasyon kartını izleyin; SMS metni alındığında orada görünür. Hiçbir şey kurmanız gerekmez ve aynı cüzdan hem tarayıcıyı hem API'yi finanse eder.

Polonya numaralarını ve mesajlarını ele almayı farklı kılan nedir?

Polonya, trunk öneki olmayan kapalı bir numaralandırma planı kullanır: cep ya da sabit, her numara +48'den sonra dokuz hanedir. Bu da doğrulamayı hoş biçimde katı kılar. Dokuz ulusal haneye indirgenmeyen girişleri reddedin, kullanıcıların üçerli gruplar hâlinde eklediği boşlukları ve tireleri silin ve +48 artı dokuz haneyi tek bir E.164 dizesi olarak saklayın. Baştaki fazladan bir sıfır, korunacak bir önek değil, bir yazım hatasıdır.

Hesap dili Lehçe olduğunda doğrulama mesajları çoğunlukla Lehçe gelir. ą, ę, ł ve ż gibi karakterler GSM 7 bit alfabesinin dışında kalır; bu yüzden kendi Lehçe OTP metinlerinizi gönderiyorsanız daha kısa parçalar bekleyin ve şablonu bir cihazda gerçekten göründüğü hâliyle test edin. Gelen kodları ayrıştırırken rakamlara odaklanın ve çevresindeki kelimeleri yok sayın.

Burada test yapmanın yaygın nedenleri: Polonya pazarına giren bir ürün, Lehçe akışlar için yerelleştirme QA'sı, Orta Avrupa genelinde iş hesaplarına bakan bölgesel ekipler ve müşterileri arasında AB'nin başka yerlerinde yaşayan Lehçe konuşurlar bulunan uygulamalar.

Sorun giderme: +48 kodu neden eksik?

• Pencere hâlâ açık. Bir sonuca varmadan önce tam 20 dakika bekleyin; yalnızca kod gelirse ücretlendirilirsiniz.
• Hizmet sanal numaraları reddediyor olabilir. Bazı platformlar reddeder ve bu olduğunda otomatik iade tutarın tamamını cüzdana geri koyar.
• Rota yoğun. Daha sonra yeniden deneyin ya da farklı bir hizmet rotasını test edin.
• Test döngüde. Birkaç saniyede bir yeniden sipariş vermek istek bütçenizi tüketir; geri çekilme ekleyin.

Daha fazla örüntü başarısız OTP tesliminin azaltılması yazısında toplanmıştır.

Polonya'da dedicated numaralar var mı ve ödemeler nasıl işler?

Self servis bir ürün olarak yok. Ayda $1.95'ten başlayan Dedicated Virtual Numbers yalnızca Amerika Birleşik Devletleri ve Kanada'da sunulur. Uzun süreli bir Polonya hattı için sormak üzere [email protected] adresine e-posta gönderin; bunun mümkün olup olmadığına yerel kurallar karar verir, bu yüzden bir söz verilmez.

Ödemeler tek bir ön ödemeli USD cüzdanına gider: plan yok, aylık ücret yok, kartla ya da USDT/USDC ile bakiye yükleme ve her yükleme için e-postayla gönderilen bir PDF fatura. Geliştiriciler, entegrasyonu geliştirirken simüle edilmiş numaralar ve kodlar almak için bir geliştirme hesabında sandbox modunu isteyebilir. Canlı fiyatlar için fiyatlandırma sayfasına bakın.

Sık sorulan sorular

Ekipte kimsenin +48 SIM'i yoksa Polonya kayıt akışını nasıl test edebilirim?

OTP Gateway'de test için bir +48 numarası sipariş edin ve akışta kullanın. Kod panelde görünür ve webhook'unuza gönderilebilir.

OTP Route API çağrılarında Polonya ülke kodu nedir?

pl'dir; hem POST /api/v1/activations içinde hem de fiyat sorgusunda kullanılır.

Bir Polonya telefon numarası kaç haneden oluşur?

+48'den sonra dokuz ulusal hane, trunk sıfırı olmadan. Bu sabit uzunluk sunucu tarafı doğrulamasını kolaylaştırır.

Polonya SMS OTP'si almak ne kadar tutar?

Fiyatlar kod başına $0.20'den başlar ve hizmete göre değişir. Panel ve fiyat endpoint'i siparişten önce kesin rakamı gösterir.

Bir Polonya aktivasyonu boş biterse para kaybeder miyim?

Hayır. Kodsuz biten ya da iptal ettiğiniz bir aktivasyon cüzdana tam olarak iade edilir.

Canlıya geçmeden önce tüm Polonya akışını simüle edebilir miyim?

Evet. Cüzdan bakiyesi harcamadan simüle edilmiş numaralar ve kodlar almak için bir geliştirme hesabında sandbox modunu isteyin.

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.