İsviçre (+41) doğrulama kodlarına geliştirici yolu

İsviçre kodunu API üzerinden almak için hangi istekler gerekir?

İsviçre OTP API'si her ülkede kullanılan aynı küçük yüzeydir; ülke kimliği olarak ch kullanılır. Developer console'da oluşturduğunuz, öneki or_live_ olan bir Bearer anahtarıyla kimlik doğrulayın; bir hesap en fazla 10 anahtar tutabilir.

1. Kimlikleri GET /api/v1/services ve GET /api/v1/countries ile öğrenin ve çalıştırmalar arasında önbelleğe alın.
2. GET /api/v1/prices?country=ch&service=<id> çağrısıyla fiyatı kontrol edin. Yanıt güncel fiyatı ve rotanın şu an açık olup olmadığını verir.
3. POST /api/v1/activations isteğini {"service": "whatsapp", "country": "ch"} ya da testinizin kapsadığı hizmetle gönderin. Dönen aktivasyon kimliğini saklayın.
4. +41 numarasını kendi ürününüzün telefon alanına girin.
5. Sonucu GET /api/v1/activations/{id} ile ya da bir webhook ile okuyun; testi temiz biçimde bırakmak için POST /api/v1/activations/{id}/cancel kullanın.

GET /api/v1/balance çağrısı test paketinizin hazırlık adımında yer almalıdır. Hız sınırı hesap başına dakikada 300 istektir; bu, rahat bir aralıkla polling yapan birkaç eşzamanlı işe fazlasıyla yeter. Uç nokta başvurusu: dokümantasyon.

+41 aktivasyonları için polling mi, webhook mu?

Hızlı bir betik için polling işi basit tutar. Testler paralel çalışmaya başlar başlamaz webhook öne geçer, çünkü Zürih'e giden bir SMS yoldayken hiçbir şeyin boşuna dönmesi gerekmez.

OTP Route en fazla beş uç nokta kaydetmenize izin verir; her birini activation.sms_received, activation.expired ve activation.cancelled olaylarına abone edin. Her teslimatı güvenmeden önce doğrulayın: X-OTPRoute-Signature başlığındaki t ve v1 bölümlerini alın, uç nokta sırrıyla "<t>.<raw body>" üzerinden HMAC-SHA256 hesaplayın, sabit zamanlı karşılaştırın ve kısa bir toleransın dışındaki zaman damgalarını reddedin. İşlemeyi aktivasyon kimliğine göre yapın; böylece yeniden denenen bir teslimat zararsız bir işlem olmaz.

İmza kontrollerinin daha derin anlatımı için OTP webhook'larını HMAC ile güvenceye alma yazısına bakın.

Veritabanınızda bir İsviçre numarası nasıl görünmeli?

İsviçre'de numaralar yurt içinde 0 trunk önekiyle başlar; örneğin bir cep numarası 079 123 45 67 biçiminde yazılır. Uluslararası biçimde bu sıfır düşer: E.164 gösterimi +41 79 123 45 67 olur ve ülke kodundan sonra dokuz hane gelir. Cep numarası aralıkları 07x bloğundadır. Kanonik +41… dizesini saklayın ve yalnızca gösterim için biçimlendirin; aksi halde bir kayıt 079, bir diğeri +4179 dediğinde tekilleştirme ve aramalar bozulur.

İsviçre'nin diğer özelliği dildir. Almanca, Fransızca, İtalyanca ve Romanşça ulusal dil olduğundan, bir doğrulama SMS'i göndericinin yerel ayar işleyişine göre ilk üç dilden herhangi birinde gelebilir; birçok uygulama da doğrudan İngilizceye düşer. Ürününüz bölgeye göre yerelleştiriliyorsa, gerçek bir +41 kodu doğru şablonun tetiklendiğini doğrulamanın ucuz bir yoludur.

Ekipler burada, İsviçre pazarına fintech veya e-ticaret ürünü çıkarmadan önce, Cenevre ya da Basel'den iş hesaplarını yöneten personeli desteklerken veya kendi +423 koduna sahip Lihtenştayn ile de kesişen sınır ötesi akışları doğrularken test yapar.

İsviçre doğrulama numarasıyla hangi hizmetleri doğrulayabilirsiniz?

ch için güncel görüntü şunları listeler: Google (Gmail & YouTube), Microsoft & Outlook, LinkedIn, WhatsApp, Telegram, Signal, Uber, Airbnb, Amazon, eBay, Netflix, Discord, ChatGPT (OpenAI) ve Claude; liste bunlarla sınırlı değildir. İsviçre toplamda OTP Gateway üzerinde 1.700'den fazla hizmet barındırır.

Erişilebilirlik gün boyunca değiştiği için bu listeyi bir başlangıç noktası olarak görün ve çalışma anında canlı veriyi sorgulayın. Önce fiyatlara bakan ve rota kapalıysa testi atlandı olarak işaretleyen bir altyapı, körü körüne yeniden deneyenden çok daha temiz raporlar üretir.

Boş kalan bir İsviçre aktivasyonunda sorun nasıl giderilir?

Bir +41 numarasına hiçbir şey gelmiyorsa, kodunuza dokunmadan önce şunları sırayla deneyin:

• Tam 20 dakikalık pencereye şans verin; bazı platformlar giden mesajları kuyruğa alır.
• Hizmetin sanal numaraları reddedip reddetmediğine bakın. Birçoğu reddeder ve otomatik iade tam olarak bu durum için vardır.
• Aynı siparişi sıkı bir döngüde tekrarlamak yerine bir süre bekleyip yeniden deneyin ya da farklı bir hizmet rotası kullanın.
• Terk edilen aktivasyonları iptal edin ki para hemen iade edilsin.

OTP için ülke yönlendirme yazısı, aynı uygulamanın bir ülke rotasından diğerine neden farklı davranabileceğini açıklar.

Uzun süreli bir İsviçre numarası var mı?

Self-servis bir ürün olarak yok. İsviçre için OTP Route yalnızca OTP Gateway üzerinden tek kullanımlık numaralar sunar.

Yenilendiği sürece sizde kalan Dedicated Virtual Numbers yalnızca Amerika Birleşik Devletleri ve Kanada ile sınırlıdır ve aylık $1.95'ten başlar. Kalıcı bir İsviçre hattına özellikle ihtiyacınız varsa [email protected] adresine yazın ve kullanım amacınızı anlatın; yanıt yerel kurallara bağlıdır ve önceden söz verilemez.

İsviçre OTP yönlendirmesi için cüzdan, fatura ve sandbox

Tek bir ön ödemeli USD cüzdanından kullandıkça öde esasıyla ödersiniz. Aylık ücret yoktur ve seçilecek bir plan yoktur. Cüzdanı kartla veya USDT/USDC ile doldurun; her yükleme için e-postayla bir PDF fatura gönderilir. Bu, frank üzerinden mutabakat yapan İsviçreli şirketler için muhasebeyi düzenli tutar.

Entegrasyon çalışmaları için bir geliştirme hesabında sandbox modu isteyin. Sandbox, simüle edilmiş numaralar ve kodlar döndürür; böylece tüm SMS doğrulama API yolu cüzdan bakiyesi harcamadan test edilebilir. Gerçek aktivasyonları yalnızca kendi ürünleriniz ve hesaplarınız için, her hizmetin şartları ve OTP Route Kabul Edilebilir Kullanım Politikası çerçevesinde kullanın. QA test çözümü sayfası, ekiplerin bunu sürüm kontrollerine nasıl dahil ettiğini gösterir.

Sık sorulan sorular

API İsviçre için hangi ülke kimliğini kullanır?

İsviçre için ch kullanılır. Ülke beklenen her yerde, aktivasyon gövdesi dahil, İsviçre istekleri bu iki harfli değeri taşır.

İsviçre SIM kartım olmadan bir İsviçre giriş akışını kontrol edebilir miyim?

Evet. OTP Gateway'den alınan test amaçlı bir +41 numarası kodu alır; siz de kodu panelde ya da API ile okursunuz.

Bir İsviçre cep numarasını kaydederken 0'ı korumalı mıyım?

Hayır. 0, yurt içi bir trunk önekidir; numarayı +41 ile başlayan ve ardından dokuz hane gelen E.164 biçiminde saklayın.

İsviçre doğrulama SMS'i hangi dilde olur?

Göndericiye bağlıdır: Almanca, Fransızca, İtalyanca veya İngilizce hepsi yaygındır. Kodu sabit bir ifadeyle değil, rakam desenine göre ayıklayın.

İsviçre SMS OTP'si ne kadara mal olur?

Kod başına $0.20'den başlar; hizmete göre kesin fiyat, siparişten önce GET /api/v1/prices ile döndürülür.

Kod gelmezse param ne olur?

Pencere kapandığında ya da aktivasyonu iptal ettiğinizde otomatik olarak cüzdanınıza döner.

Lihtenştayn İsviçre rotasına dahil mi?

Hayır, Lihtenştayn'ın kendi +423 ülke kodu ve ülke listesinde kendi sayfası vardır; onu ayrıca sipariş edin.

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.