Bahamalar'ın +1 242 OTP'lerini REST çağrıları ve webhook'larla toplamak

Bir Bahamalar OTP API entegrasyonu hangi isteklere ihtiyaç duyar?

Bahamalar OTP API entegrasyonu, Developer console'da ürettiğiniz ve öneki or_live_ olan bir Bearer anahtarıyla yetkilendirilen, https://otproute.com/api/v1 üzerindeki kısa bir çağrı zinciridir. Bahamalar'ın ülke kimliği bs'dir; whatsapp veya telegram gibi hizmet kimlikleri katalogdan gelir.

1. Kataloğu GET /api/v1/services ve GET /api/v1/countries ile yükleyin, ardından görünen adlara göre eşleştirmek yerine kimlikleri yapılandırmada tutun.
2. Her siparişten önce GET /api/v1/prices?country=bs&service=<id> isteyin. Yanıt güncel fiyatı taşır ve kullanılabilirlik gün içinde değiştiği için şu anda bir rotanın açık olup olmadığını söyler.
3. Aktivasyonu POST /api/v1/activations ve {"service": "<id>", "country": "bs"} gövdesiyle oluşturun. Bir aktivasyon kimliği ve bir +1 242 numarası alırsınız.
4. Bu numarayı test edilen ürünün kayıt veya giriş adımına girin.
5. Kodu webhook ile bekleyin ya da GET /api/v1/activations/{id} ile polling yapın. Bir çalıştırmayı temiz biçimde POST /api/v1/activations/{id}/cancel ile bırakın.

Bir hesap en fazla 10 anahtar tutabilir ve dakikada 300 istek gönderebilir; böylece staging, CI ve bir meslektaşın dizüstü bilgisayarı her biri ayrı bir anahtar alabilir ve bunlar tek tek iptal edilebilir. Bu SMS doğrulama API'sinin parametreleri ve yanıtları API dokümanlarında listelenir.

+1 242 kodları için imzalı webhook'ları nasıl doğrularım?

Tek bir manuel kontrol için polling yeterlidir; birkaç test paketi yan yana çalışmaya başladığında push teslimat daha derli toplu olur. Developer console'da en fazla 5 uç nokta kaydedin ve activation.sms_received, activation.expired ile activation.cancelled olaylarına abone olun.

Her teslimat X-OTPRoute-Signature: t=<unix>,v1=<hex> taşır. İmzalanan dizeyi <t>.<raw body> olarak yeniden oluşturun, üzerinde uç nokta sırrıyla HMAC-SHA256 çalıştırın ve sonucu v1 ile sabit zamanlı bir fonksiyonla karşılaştırın. Baytlar üzerinde tam olarak geldikleri hâliyle çalışın; ayrıştırılmış JSON'u yeniden serileştirmek boşlukları değiştirir ve özetler artık eşleşmez. Yakalanmış bir isteğin yeniden oynatılamaması için birkaç dakikadan eski her zaman damgasını reddedin.

İşleyicinizi aktivasyon kimliğine göre anahtarlayın ve idempotent yapın, çünkü yeniden denenen bir teslimat bir testi asla iki kez geçti olarak işaretlememelidir. HMAC ile OTP webhook'larını güvenceye alma yazısı saat sapmasını ve sır rotasyonunu kapsar.

Bahamalar rotasında hangi hizmetler var ve personel elle sipariş verebilir mi?

Bahamalar rotası şu anda 900'den fazla hizmet listeliyor. Popüler seçenekler arasında WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, X (Twitter), ChatGPT (OpenAI), Microsoft & Outlook, Amazon, Discord, LinkedIn, Uber, Airbnb ve Signal yer alıyor. Bu listeyi bir anlık görüntü olarak değerlendirin; sipariş anındaki API yanıtı belirleyicidir.

Bir anahtara hiç dokunmayan meslektaşlar aynı sonucu tarayıcıda alır. Oturum açın, OTP Gateway'i açın, Bahamalar'ı ve hizmeti seçin, gösterilen fiyatı okuyun ve siparişi verin. Bahamalar doğrulama numarası bir geri sayımla görünür ve kod geldiğinde aynı ekranda belirir.

20 dakikalık pencerede ne olur ve hiçbir şey gelmezse ne yapılır?

Her aktivasyon 20 dakika açık kalır. Bu sürede bir SMS gelirse listelenen fiyatı ödersiniz; pencere boş kapanırsa ya da önce siz iptal ederseniz, tüm tutar otomatik olarak cüzdanınıza döner.

Bir Bahamalar kodu görünmediğinde:

• Testi başarısız saymadan önce pencerenin dolmasına izin verin; bazı göndericiler mesajlarını kuyruğa alır.
• Daha sonra ya da başka bir hizmet rotasıyla yeniden deneyin, çünkü envanter ve gönderici davranışı gün içinde değişir.
• Hizmetin sanal numaraları hiç kabul edip etmediğini kontrol edin. Bazıları reddeder ve iade tam da bu yüzden vardır.
• Sıkı bir döngüde yeniden sipariş vermekten kaçının. Tek bir kararsız test istek bütçenizi tüketmesin diye denemeler arasında geri çekilin.

Daha fazla sorun giderme kalıbı başarısız OTP teslimatlarını azaltma yazısında toplanmıştır.

Bir +1 242 numarası nasıl saklanıp normalleştirilmeli?

Bahamalar, Kuzey Amerika Numaralandırma Planı'nın bir parçasıdır; bu yüzden numaraları Amerika Birleşik Devletleri ve Kanada ile 1 ülke kodunu paylaşır. Tam bir numara 1, 242 alan kodu ve yedi haneli bir abone numarasından oluşur; E.164'te bu, +1242 ve ardından yedi hane, toplamda on bir hane olur. Sakinler çoğunlukla yalnızca yedi yerel haneyi söyler, planın başka yerlerindeki arayanlar ise 242'den önce baştaki 1'i çevirir.

Kodunuz için iki sonuç çıkar. Ülkeyi yalnızca +1'den çıkaran bir doğrulayıcı Bahamalı kullanıcıları Amerikalı olarak etiketler; bu yüzden alan koduna bakın ya da NANP bölgelerini bilen bir numaralandırma kütüphanesine güvenin. Ayrıca aramalar ve tekilleştirme tutarlı kalsın diye her numarayı E.164'te saklayın, biçimlendirmeyi yalnızca gösterim için yapın. Bahamalar hatlarındaki doğrulama metinleri genellikle resmî dil olan İngilizce gelir; bu da yerelleştirme kontrollerini çevrilmiş metne değil, numara biçimlendirmesine ve ülke etiketlerine odaklı tutar.

Ürün ekipleri kayıt akışlarını neden Bahamalar'a karşı test eder?

Turizm, konaklama ve finansal hizmetler Bahama ekonomisinin büyük bölümünü taşır; bu yüzden Karayipli müşterileri olan rezervasyon platformları, araç ve teslimat uygulamaları, ödeme ürünleri ve bankaların hepsinin +1 242 kullanıcıları için çalışan bir yola ihtiyacı vardır. Test için bir +1 242 numarası, bir QA mühendisinin formun numarayı kabul ettiğini, ülke seçicisinin Bahamalar'ı ABD'nin içine katmak yerine gösterdiğini ve SMS onay metninin doğru göründüğünü doğrulamasını sağlar. İyi OTP yönlendirme ayrıca, varsayılan olarak anakara numarasına dönmek yerine test senaryosu başına doğru ülkeyi seçmek demektir. QA test el kitabı bunu otomatik test paketlerine nasıl bağlayacağınızı gösterir. Her kontrolü kuruluşunuza ait hesaplarla sınırlı tutun ve her hizmetin şartlarına uyun; OTP Route'un Acceptable Use Policy'si tüm siparişler için geçerlidir.

Uzun vadeli bir Bahamalar numarası mümkün mü, kullanım nasıl faturalanıyor?

Bahamalar için kendi kendine alınabilen uzun vadeli bir numara yoktur. Dedicated Number'lar, gelen ve giden SMS, tarayıcıdan arama ve webhook yönlendirmeyle $1.95/ay'dan başlayan bir ABD ve Kanada ürünüdür. Ekibinizin süregelen bir Bahamalar hattına ihtiyacı varsa [email protected] adresine e-posta gönderin; bir şeyin mümkün olup olmadığı yerel kurallara bağlıdır ve söz verilemez.

Kullanım, aylık ücreti ve seçilecek bir planı olmayan tek bir ön ödemeli USD cüzdanından düşer. Kartla ya da USDT/USDC ile yükleme yapın; her yükleme için gelen kutunuza bir PDF fatura ulaşır. Entegrasyon çalışmaları için bir geliştirme hesabının sandbox'a alınmasını isteyin: simüle numaralar ve kodlar döndürür, böylece tüm akış cüzdan bakiyesi harcamadan denenebilir. Ücretlerin nasıl görüneceğini fiyatlandırma sayfası gösterir.

Sık sorulan sorular

Yerel SIM olmadan uygulamamın Bahamalar kayıt akışını test edebilir miyim?

Evet. Test ettiğiniz hizmet için OTP Gateway'den bir +1 242 numarası sipariş edin, akışınıza girin ve kodu panelde ya da webhook ile okuyun. Kod başına $0.20'den başlayan ücreti yalnızca SMS geldiğinde ödersiniz.

API'de Bahamalar'ın ülke kimliği nedir?

bs'dir. Bunu GET /api/v1/prices çağrısına ve POST /api/v1/activations gövdesine verin.

Telefon kütüphanem +1 242'yi bir ABD numarası olarak mı değerlendirir?

Yalnızca ülkeyi sadece ülke kodundan tahmin ediyorsa. Alan koduna bakın ya da NANP bölge verilerini taşıyan bir kütüphane kullanın; böylece Bahamalar numaraları doğru etiketlenir.

Kod hiç gelmezse ücretlendirilir miyim?

Hayır. 20 dakika içinde hiçbir şey gelmezse ya da iptal ederseniz, tüm tutar otomatik olarak cüzdanınıza döner.

Gelecekteki girişler için bir Bahamalar doğrulama numarasını tutabilir miyim?

Kendi kendine alınabilen bir ürün olarak değil. Uzun vadeli Dedicated Number'lar yalnızca Amerika Birleşik Devletleri ve Kanada'da vardır; bir Bahamalar hattı için [email protected] adresine e-posta gönderin, ekip yerel kuralların neye izin verdiğini size söyler.

Bir test paketi kaç istek gönderebilir?

Hesap başına dakikada 300 istek, en fazla 10 API anahtarına yayılmış olarak. Birkaç saniyede bir polling yapmak ya da webhook'lara geçmek sizi rahatça bu sınırın içinde tutar.

Cüzdanı stabil kriptolarla doldurabilir miyim?

Evet. Cüzdan kartları ve USDT/USDC'yi kabul eder; her yükleme e-postayla bir PDF faturayla gelir.

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.