Yeşil Burun (+238) doğrulama kodlarını test altyapınıza çekmek

Bir +238 aktivasyonu hangi uç noktalara dokunur?

Bir Cabo Verde OTP API entegrasyonu https://otproute.com/api/v1 altında yalnızca kısa bir çağrı listesine ihtiyaç duyar. Her istek, Developer console'da oluşturulan ve or_live_ ile başlayan bir Bearer anahtarı taşır. Cabo Verde'nin ülke kimliği cv'dir; servis kimliği ise test ettiğiniz uygulamanın api_service değeridir.

1. GET /api/v1/services ve GET /api/v1/countries kataloğu getirir; gün boyunca önbelleğe alın.
2. GET /api/v1/prices?country=cv&service=<id> güncel fiyatı okur ve bir rotanın şu an açık olup olmadığını söyler. Envanter gün içinde değiştiği için hiçbir şeyi sabit kodlamak yerine her siparişten önce sorgulayın.
3. {"service": "whatsapp", "country": "cv"} ile POST /api/v1/activations, bir aktivasyon kimliği ve kayıt formunuza yazılacak +238 numarasını döndürür.
4. Webhook kullanmıyorsanız GET /api/v1/activations/{id} kodu polling ile yoklamanızı sağlar.
5. POST /api/v1/activations/{id}/cancel, bir test yarıda kesildiğinde numarayı serbest bırakır; böylece bloke edilen tutar cüzdana döner.

Çalıştırmadan önce yapılan bir GET /api/v1/balance çağrısı, test paketinin yarı yolda başarısız olmak yerine erkenden durmasını sağlar. Hesap başına üst sınır dakikada 300 istektir ve API referansı her alanı listeler.

Bir Cabo Verde kodu için imzalı webhook'u nasıl kabul ederim?

Polling tek bir betik için uygundur; birkaç iş paralel çalışmaya başlayınca webhook daha düzenlidir. Developer console'da bir uç nokta kaydedin (bir hesap beş tane tutabilir) ve activation.sms_received, activation.expired ile activation.cancelled olaylarına abone olun.

Her POST, t=<unix>,v1=<hex> biçiminde bir X-OTPRoute-Signature başlığıyla gelir. <t>.<raw body> dizesini yeniden oluşturun, o uç noktanın sırrıyla HMAC-SHA256 olarak imzalayın ve sonucu v1 ile sabit zamanlı bir kontrolle karşılaştırın. Zaman damgası birkaç dakikadan eski olan her şeyi atın; böylece yakalanmış bir istek yeniden oynatılamaz. Ardından işlemenizi aktivasyon kimliği üzerinden yürütün: aynı olay iki kez gelirse ikinci kopya hiçbir şeyi değiştirmemelidir. OTP webhook'larını HMAC ile güvenceye alma makalemiz uç durumları ele alır.

Bugün hangi uygulamalar bir Yeşil Burun numarasına kod gönderebilir?

cv için canlı katalog 800'den fazla servisi kapsar. Şu anda açık olan popüler olanlar arasında WhatsApp, Facebook, Instagram, TikTok, Google (Gmail & YouTube), Microsoft & Outlook, Amazon, Airbnb, Uber, Viber, Telegram ve Netflix yer alır. Bu listeyi bir anlık görüntü olarak okuyun: rotalar ortak kapasitesine göre açılıp kapanır; OTP yönlendirmesinin amacı da bunu söz veren bir sayfa yerine kullanılabilirliği gerçek zamanlı bildiren bir API ile yapmaktır.

Ekipte kimse kod yazmıyorsa panel aynı işi görür. Servisi seçin, Cabo Verde'yi seçin, ekrandaki fiyatı onaylayın ve numarayı kopyalayın. Kod geldiğinde aktivasyon kartında belirir.

Bir +238 numarasını sakladığınızda nasıl görünür?

Cabo Verde kapalı bir numaralandırma planı kullanır: yedi haneli ulusal numaralar ve ön ek yok; yani silinecek bir baştaki sıfır bulunmaz. E.164'te bir numara basitçe +238 ve ardından bu yedi hanedir. Normalleştirme bu yüzden önemsizdir; yine de kısa uzunluk, her abone numarasının daha uzun olduğunu varsayan doğrulayıcıları şaşırtır ve bir formun tamamen geçerli bir Yeşil Burun girişini reddetmesinin yaygın nedenidir. E.164 dizesini saklayın, arayüzünüzün istediği gibi biçimlendirin ve telefon alanı birim testlerinize bir +238 vakası ekleyin.

Resmî dil Portekizcedir, günlük hayatta çoğu kişi ise Yeşil Burun Kreolü konuşur; bu yüzden Portekizce bir OTP şablonunun orada bir telefonda nasıl göründüğünü kontrol edin. Ekipler bir +238 numarasını genellikle diaspora nedeniyle alır: Amerika Birleşik Devletleri'ndeki, Portekiz'deki ve Avrupa'nın başka yerlerindeki Yeşil Burunlu topluluklar hesaplarını memleket numaralarına bağlı tutar; havale, seyahat ve mesajlaşma ürünleri de bu kayıtların çalışmasını ister.

20 dakika içinde SMS gelmezse cüzdana ne olur?

Her aktivasyon 20 dakika açık kalır. Bu pencerede bir kod gelirse ücret geçerli kalır; pencere boş kapanırsa ya da önce siz iptal ederseniz tutarın tamamı destek talebi gerekmeden cüzdanınıza döner. Hiçbir şey gelmediğinde:

• Birkaç saniyede bir yeni sipariş vermek yerine sürenin işlemesine izin verin; sıkı bir yeniden deneme döngüsü yalnızca bakiyeyi bloke eder.
• Daha sonra tekrar deneyin ya da aynı akışı farklı bir servis rotasından sınayın.
• Uygulamanın sanal numaraları hiç kabul edip etmediğini doğrulayın; bazıları politika gereği reddeder ve iade tam da bu durum için vardır.
• Formunuzun +238 numarasını kesilmiş değil, eksiksiz gönderdiğinden emin olun.

Başarısız OTP teslimatlarını azaltma rehberi teşhis konusunda daha ayrıntılıdır.

Tekrarlanan girişler için bir Cabo Verde numarasını elimde tutabilir miyim?

Self-servis olarak hayır. OTP Route'un gelen/giden SMS, tarayıcıdan arama ve webhook iletme sunan uzun vadeli hatları olan Dedicated Numbers, aylık $1.95'ten başlayan bir Amerika Birleşik Devletleri ve Kanada ürünüdür. Self-servis uzun vadeli bir +238 hattı yoktur. Ekibinizin gerçek bir ihtiyacı varsa [email protected] adresine e-posta gönderin; bunun ayarlanıp ayarlanamayacağı yerel kurallara bağlıdır ve garanti edilmez. Tekrar tekrar giriş yapması gereken bir staging hesabı için bir ABD ya da Kanada sanal numarası çoğu zaman pratik cevaptır.

Kullanım nasıl faturalandırılır ve canlıya çıkmadan önce nasıl test edilir?

Faturalandırma tek bir ön ödemeli USD cüzdanından yürür; aylık ücret ve paket kademesi yoktur. Kartla ya da USDT/USDC stablecoin'lerle yükleme yapın; her yükleme e-postayla bir PDF fatura getirir ve bu, finans mutabakatını basit tutar. Production anahtarları cüzdana dokunmadan önce geliştirme hesabınızın sandbox'a alınmasını isteyin: bu, simüle numaralar ve kodlar döndürür; böylece SMS doğrulama API istemcinizin sipariş, webhook ve iptal yolu hiçbir şey harcamadan CI'da çalışabilir. Fiyatlandırma ve QA testi genel bakışı sayfalarına bakın. Süreç boyunca her servisin kurallarına ve OTP Route Kabul Edilebilir Kullanım Politikasına uyun.

Sık sorulan sorular

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

Evet. OTP Gateway'den bir +238 numarası sipariş edin, kayıt formunuza girin ve kodu panelden, API'den ya da bir webhook'tan okuyun. Ekipten kimsenin adalarda olması gerekmez.

OTP Route API'sinde Cabo Verde'nin ülke kimliği nedir?

cv. POST /api/v1/activations içinde ve fiyat sorgusunda country olarak verin.

Bir Yeşil Burun numarasının başına 0 eklemem gerekir mi?

Hayır. Cabo Verde'de ön ek yoktur; uluslararası biçim basitçe +238 artı yedi haneli ulusal numaradır.

Bir Cabo Verde doğrulama numarası ne kadar tutar?

OTP Gateway fiyatlandırması kod başına $0.20'den başlar ve servise göre değişir; API ve panel kesin fiyatı siparişten önce gösterir. Yalnızca bir kod geldiğinde ücretlendirilirsiniz.

Her uygulama bir Yeşil Burun sanal numarasına kod gönderir mi?

Hayır. Bazı servisler sanal numaraları reddeder ve rotalar gün içinde değişir. 20 dakika içinde kod düşmezse tutar cüzdana iade edilir.

+238 entegrasyonunu test etmek için bir sandbox var mı?

Evet, talep üzerine. Bir geliştirme hesabı sandbox moduna alınabilir; bu mod simüle numaralar ve kodlar döndürür, böylece entegrasyonu cüzdandan harcama yapmadan uçtan uca çalıştırabilirsiniz.

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.