Kosova SMS OTP kodları API ya da panelle nasıl alınır

Bir ürün ekibinin neden bir +383 numarasına ihtiyacı olsun ki?

Kosova küçük bir pazardır ama yurtdışındaki ayak izi büyüktür: büyük bir diaspora Almanya'da, İsviçre'de ve Batı Avrupa'nın başka yerlerinde yaşar ve bu insanların çoğu aile ve bankacılık için bir Kosova numarası tutar. Seyahatten para transferine kadar bu kitleye hizmet eden uygulamaların, bir +383 kullanıcısının kayıt sırasında ne yaşadığını görmesi gerekir.

Yerelleştirme diğer etkendir. Arnavutça ve Sırpça ikisi de resmî dildir; bu yüzden bu dillerden birine çevrilmiş bir akış, ekran görüntüsü incelemesi yerine gerçek bir uçtan uca testi hak eder. OTP Gateway üzerinden bir Kosova doğrulama numarası, QA'nın bu kontrolü herhangi bir ofisten yapmasını sağlar.

Priştine merkezli ya da daha geniş Batı Balkanlar'ı kapsayan bölgesel operasyon ekiplerinin üçüncü bir nedeni vardır: yerel bir iletişim kişisiyle kayıtlı iş profilleri bazen yeni bir kod ister ve bunu bir çalışanın telefonunu elden ele dolaştırmak yerine ortak, denetlenebilir bir araçtan geçirmek daha iyidir.

Kosova rotasında şu anda hangi uygulamalar var?

Bugünün özeti Kosova için 400'den fazla servis gösteriyor. Şu anda sunulan popüler olanlar arasında WhatsApp, Viber, Telegram, Facebook, Instagram, TikTok, Google (Gmail & YouTube), Microsoft & Outlook, Amazon, Snapchat, Netflix, Airbnb, Uber ve Flipkart yer alıyor.

Liste, daha büyük Avrupa pazarlarına göre daha küçüktür ve daha sık değişir; bu yüzden yazılı her listeyi bir ipucu olarak değerlendirin. Yetkili cevap, sipariş verdiğiniz anda GET /api/v1/countries ve panelin döndürdüğü şeydir.

Kosova OTP API'siyle pratikte çalışmak

Ülke kimliği xk'dir. Tipik bir entegrasyon, servis kimliklerini GET /api/v1/services ile çözer, maliyeti GET /api/v1/prices?country=xk&service=<id> ile kontrol eder ve ardından {"service": "telegram", "country": "xk"} gibi bir gövdeyle POST /api/v1/activations ile bir aktivasyon açar. Yanıt, numarayı ve sonrası için sakladığınız bir aktivasyon kimliğini taşır.

Buradan sonra kod size activation.sms_received webhook'u olarak ulaşır; bu webhook X-OTPRoute-Signature başlığında "<t>.<raw body>" üzerinden HMAC-SHA256 ile imzalanır. Eski zaman damgalarını reddedin ve yeniden denenen bir teslimin yalnızca bir kez işlenmesi için işleyicinizi aktivasyon kimliği üzerinden kurun. Bir CI işinin herkese açık adresi yoksa GET /api/v1/activations/{id} sorgulaması da işe yarar. Tam örnekler için entegrasyon rehberine bakın.

Kosova +383 aldığında ne değişti ve numaralar nasıl saklanmalı?

Kosova kendi ülke kodu +383'ü ancak 2010'ların sonlarında aldı. Öncesinde mobil ağları, Monako ve Slovenya'nınkiler dahil ödünç kodlar kullanıyordu ve bazı eski müşteri kayıtları numaraları hâlâ bu biçimlerde tutuyor. Eski verileri içe aktarırsanız bu kayıtları otomatik olarak yeniden yazmak yerine işaretleyin.

Yurt içi numaralar 0 ulusal ön ekiyle başlar; yerel olarak 044 123 456 gösterilen bir cep numarası E.164'te +383 44 123 456'dır. Uluslararası biçimi kaydedin, girişte sıfırı atın ve yalnızca görüntülerken biçimlendirin. Arnavutça metin, temel GSM alfabesinin dışında kalan ë gibi harfler kullanır; bu yüzden yerelleştirilmiş bir mesaj daha kısa segmentlerle UCS-2 olarak gönderilebilir.

Kosova kodu geç geldiğinde ya da gelmediğinde ne olmalı?

Aktivasyona tam 20 dakikasını verin. Süre SMS gelmeden kapandığında ya da iptal ettiğinizde ücret otomatik olarak cüzdana iade edilir ve activation.expired ya da activation.cancelled tetiklenir. Makul sonraki adımlar:

• testiniz izin veriyorsa bir ara verip yeniden deneyin ya da Arnavutluk gibi komşu bir rotayı seçin;
• hedef servisin sanal numaraları kabul edip etmediğini kontrol edin;
• bir döngüyle sipariş vermek yerine otomatik yeniden denemelere geri çekilme ekleyin.

Kosova projeleri için uzun süreli hatlar, cüzdan ve sandbox

OTP Route'un Kosova için kendi kendine hizmet uzun süreli bir numarası yoktur. Aylık $1.95'ten başlayan Dedicated Numbers hattı yalnızca iki ülkeyi kapsar: Amerika Birleşik Devletleri ve Kanada. Kalıcı bir +383 hattı için [email protected] adresine e-posta gönderin; bir tanesinin ayarlanıp ayarlanamayacağı yerel kurallara bağlıdır.

Harcama, kartla ya da USDT/USDC ile yüklenen tek bir ön ödemeli USD cüzdanından kullandıkça öde esasıyla düşer ve her yükleme için e-postayla bir PDF fatura gönderilir. Geliştiriciler, webhook'ları kurarken simüle edilmiş numaralar ve kodlar almak için bir geliştirme hesabında sandbox modu isteyebilir. Fiyatlandırma ayrıntıları.

Sık sorulan sorular

Uygulamamın Arnavutça kayıt akışını gerçek bir Kosova numarasıyla kontrol edebilir miyim?

Evet. OTP Gateway'de test için bir +383 numarası sipariş edin, kaydı Arnavutça başlatın; kod panelde ve webhook'unuzda görünür.

SMS doğrulama API'sinde Kosova hangi kimliği kullanır?

Kosova, ülke alan her uç noktada, GET /api/v1/prices ve POST /api/v1/activations dahil, xk'dir.

Bir Kosova doğrulama numarası ne kadar tutar?

Kod başına $0.20'den; kesin fiyat servise bağlıdır ve siz sipariş vermeden önce gösterilir ya da fiyat uç noktası tarafından döndürülür.

Kosova için neden Almanya'dakinden daha az servis görüyorum?

Kapsam, taşıyıcı ortaklarımızın her ülkeye yönlendirebildiği şeyi izler ve daha küçük pazarlar daha kısa listeler taşır. Bir test çalıştırması planlamadan önce canlı listeye bakın.

Kosova OTP'leri hiç gelmezse param ne olur?

20 dakikalık süre SMS gelmeden bittiğinde tamamı cüzdana döner; iptal ederseniz hemen döner.

Eski +377 ya da +386 numaraları hâlâ Kosovalı kullanıcılara mı ait?

Bazı eski kayıtlar bunları içerebilir, ancak yeni numaralar +383 kullanır. Eski biçimleri körü körüne dönüştürülecek bir şey değil, gözden geçirilecek veri olarak ele alın.

Tekrarlı girişler için bir +383 numarasını elimde tutabilir miyim?

Kendi kendine hizmet olarak hayır. Her gateway numarası tek bir kodu kapsar ve uzun süreli hatlar bir ABD/Kanada ürünüdür; Kosova'yı sormak için [email protected] adresine e-posta gönderin.

OTP Route numaralarını nasıl kullanabileceğime dair kurallar var mı?

Evet. OTP Route'u yalnızca kendi meşru ürünleriniz ve iş hesaplarınız için kullanın, her servisin koşullarına uyun ve Kabul Edilebilir Kullanım Politikası'na saygı gösterin. Başlamak için kaydolun.

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.