Arnavutluk (+355) OTP'lerini test hattınıza yönlendirmek

Hangi REST çağrıları bir Arnavut numarasını ve kodunu döndürür?

Arnavutluk OTP API'si, her pazar için kullanılan aynı SMS doğrulama API'sidir; yalnızca ülke kimliği değişir. İstekler, Developer console'da üretilen ve öneki or_live_ olan bir Bearer anahtarıyla https://otproute.com/api/v1 adresine gider. Arnavutluk'un kimliği al'dir; tipik bir çalıştırma şöyle görünür:

1. GET /api/v1/services, ihtiyaç duyduğunuz hizmet kimliğini, örneğin telegram veya google değerini çözer. Listeyi çalıştırmalar arasında önbelleğe alın.
2. GET /api/v1/prices?country=al&service=<id> güncel fiyatı okur ve rotanın şu an açık olduğunu doğrular.
3. {"service": "telegram", "country": "al"} gövdesiyle POST /api/v1/activations bir aktivasyon kimliği ve +355 numarası döndürür.
4. Testiniz bu numarayı test edilen uygulamanın kayıt veya giriş ekranına gönderir.
5. Kod webhook ile ya da GET /api/v1/activations/{id} polling'iyle gelir; test yarıda kalırsa POST /api/v1/activations/{id}/cancel çağırın.

Bir hesap en fazla 10 anahtar tutabilir; böylece staging, CI ve bir meslektaşın dizüstü bilgisayarı her biri kendi anahtarını alıp ayrı ayrı iptal edilebilir. Dakikada 300 istek sınırı birkaç paralel test paketine yer bırakır. Alan düzeyindeki ayrıntılar API referansında yer alır.

Arnavutluk testlerim polling mi yapmalı, webhook mu dinlemeli?

Polling bağlaması en hızlı yöntemdir: durumu değişene kadar aktivasyon uç noktasına birkaç saniyede bir istek atın. Test paketleri paralel çalışmaya başladığında webhook daha derli toplu olur. En fazla 5 uç nokta kaydedin ve activation.sms_received, activation.expired ile activation.cancelled olaylarına abone olun.

Her teslimat imzalıdır. X-OTPRoute-Signature başlığı t=<unix>,v1=<hex> biçimindedir; burada v1, uç nokta sırrıyla hesaplanan "<t>.<raw body>" değerinin HMAC-SHA256'sıdır. Bunu dokunulmamış istek baytları üzerinden yeniden hesaplayın, sabit zamanlı karşılaştırın ve eski zaman damgası taşıyan her şeyi atın. Olayları aktivasyon kimliğine göre anahtarlanmış sayın; böylece yeniden denenen bir teslimat iki kez yazmaz. Webhook tabanlı OTP yakalama yazımız eksiksiz bir işleyiciyi adım adım gösterir.

+355 numaraları veritabanıma ulaşmadan önce nasıl normalleştirilmeli?

Arnavutluk, +355 ülke kodunu ve 0 olan bir yurt içi gövde (trunk) önekini kullanır. Yerelde bir cep numarası genellikle başında bu 0 ile yazılır, yani 06X XXX XXXX; uluslararası biçimde ise 0 düşer: +355 6X XXX XXXX. E.164 sürümünü (+3556…, boşluksuz) saklayın ve yerel biçimlendirmeyi yalnızca gösterim anında uygulayın.

Test amacıyla bir +355 numarasını doğrularken eklemeye değer kontroller:

• Kullanıcı +355'i zaten seçmişken ulusal biçimi yazarsa baştaki 0'ı silin.
• Bir form ülke kodunu yerel numaraya körlemesine yapıştırdığında ortaya çıkan +355 0 6X gibi çift öneki reddedin.
• Saklanan değerde boşluk, tire ve parantez bulundurmayın.

Kodun çevresindeki ifade, gönderen hizmete ve hesabın dil ayarına bağlıdır; Arnavutça ve İngilizce ikisi de yaygındır. Sabit bir cümle yerine ayrıştırıcınızda rakamları hedefleyin. Ekipler bu pazarı Arnavutluk'ta ürün çıkarırken, bir uygulamayı bölgedeki ve yurt dışındaki Arnavutça konuşanlar için yerelleştirirken ya da bölgesel bir operasyon hesabının hâlâ doğrulanabildiğini teyit ederken test eder.

Arnavutluk rotasında neleri doğrulayabilirim?

Arnavutluk rotası şu anda 1.500'den fazla hizmet listeliyor. Güncel anlık görüntüdeki popüler girişler arasında WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, Viber, Signal, Microsoft & Outlook, ChatGPT (OpenAI), Uber, LinkedIn ve Discord yer alıyor.

Stok gün içinde değişir; kullanılabilirliğin statik bir listeden değil API'den gelmesinin nedeni budur. Her testi al için bir fiyat sorgusuna bağlayın ve rota o sırada kapalıysa testi başarısız değil, atlanmış olarak işaretleyin. Bu, OTP yönlendirme gürültüsünü gerçek regresyon sonuçlarınızın dışında tutar.

Teknik olmayan bir ekip arkadaşı +355 numarası sipariş edebilir mi?

Evet. Panel, aynı akışı kod yazmadan karşılar:

1. E-postanız ve 6 haneli e-posta koduyla ya da Google ile oturum açarak kaydolun, ardından TOTP iki adımlı doğrulamayı açın.
2. Cüzdana kartla veya USDT/USDC ile bakiye ekleyin.
3. Arnavutluk'u ve hizmeti seçin, gösterilen fiyatı kontrol edin ve siparişi onaylayın.
4. Arnavutluk doğrulama numarasını uygulamaya yazın; SMS geldiğinde kod aktivasyon sayfasında belirir.

Müşteri profillerini yöneten ajanslar ve bölgesel iş hesapları kuran operasyon çalışanları genellikle bu yolu kullanır. Burada ve API üzerinden verilen siparişler tek bir cüzdanı ve aynı iade kuralını paylaşır.

Arnavutluk SMS'i hiç gelmezse ne olur?

Bir aktivasyon 20 dakika açık kalır. Yalnızca kod gelirse ödersiniz; pencere boş kapanırsa ya da erken iptal ederseniz tüm tutar kendiliğinden cüzdanınıza döner ve webhook activation.expired veya activation.cancelled olayını tetikler.

Bir kod eksik olduğunda:

• Bazı hizmetler yavaş gönderdiği için tepki vermeden önce pencereye zaman tanıyın.
• Hizmetin sanal numaraları hiç kabul edip etmediğini kontrol edin; bazıları politika gereği reddeder.
• Daha sonra yeniden deneyin ya da testiniz izin veriyorsa farklı bir hizmet rotasıyla deneyin.
• Sıkı bir döngüde yeniden sipariş vermekten kaçının. Bir betik rotayı yormasın diye denemeler arasında geri çekilin.

Başarısız OTP teslimatlarını azaltma yazımız Balkan rotaları ve ötesi için daha fazla yeniden deneme kalıbı listeler. Bu numaraları yalnızca kendi ürünleriniz ve hesaplarınız için kullanın, her hizmetin şartlarına uyun ve OTP Route'un Acceptable Use Policy'sinin geçerli olduğunu unutmayın.

Uzun vadeli bir Arnavut hattı var mı, faturalama nasıl işliyor?

Arnavutluk için kendi kendine alınabilen uzun vadeli bir numara yoktur. Dedicated Virtual Numbers yalnızca Amerika Birleşik Devletleri ve Kanada'da anında satılır; fiyat $1.95/ay'dan başlar ve gelen SMS, webhook yönlendirme, giden SMS ile tarayıcıdan arama içerir. Kalıcı bir Arnavut hattına ihtiyacınız varsa [email protected] adresine e-posta gönderin; bunun ayarlanıp ayarlanamayacağı yerel kurallara bağlıdır ve garanti edilmez.

Faturalama, aylık ücreti ve seçilecek bir planı olmayan tek bir ön ödemeli USD cüzdanı üzerinden yürür. Kartla ya da USDT/USDC ile yükleme yapın; her yükleme e-postayla bir PDF fatura ile gelir. Güncel fiyatlar fiyatlandırma sayfasındadır. Entegrasyon çalışmaları için bir geliştirme hesabının sandbox'a alınmasını isteyin; bu, cüzdan bakiyesi harcamadan hattı denemek için simüle numaralar ve kodlar döndürür.

Sık sorulan sorular

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

Evet. al ülkesiyle bir OTP Gateway numarası sipariş edin, kayıt ekranınıza girin ve kodu panelden ya da webhook'unuzdan okuyun. Hiçbir SIM ya da yerel operatör sözleşmesi gerekmez.

Arnavutluk doğrulama kodu ne kadar tutar?

Kodlar $0.20'den başlar; belirli bir hizmetin kesin fiyatı siparişten önce GET /api/v1/prices ile döndürülür. 20 dakikalık pencerede hiçbir şey gelmezse ücret cüzdanınıza geri döner.

Arnavut numaralarını baştaki 0 ile mi saklamalıyım?

Hayır. Onları E.164 biçiminde, yani +355 ve ardından gövde 0'ı olmayan ulusal numara şeklinde kaydedin; 0'ı yalnızca yerel gösterimde geri ekleyin.

Aynı +355 numarası sonraki bir giriş için yeniden kullanılabilir mi?

Bir OTP Gateway numarası tek bir doğrulama koduna hizmet eder. Oturum açmaya devam etmesi gereken hesaplar için ABD veya Kanada'daki bir Dedicated Number'ı kullanın ya da Arnavutluk için destekle iletişime geçin.

OTP Route'un Arnavutluk entegrasyon testleri için sandbox'ı var mı?

Sandbox modu, talep üzerine bir geliştirme hesabı için açılabilir. Simüle numaralar ve kodlar döndürür; böylece CI çalıştırmaları cüzdan bakiyesine dokunmadan tüm akışı dener.

Arnavut numaram uygulama tarafından neden reddedildi?

Bazı hizmetler sanal numaraları reddeder. Otomatik iade için aktivasyonu iptal edin ya da süresinin dolmasını bekleyin, ardından farklı bir zamanda veya başka bir rotadan deneyin.

Arnavutluk için hangi API kimliğini kullanmalıyım?

Fiyat sorgularında ve aktivasyon isteklerinde country değeri olarak al kullanın, hizmet kimliğini ise GET /api/v1/services yanıtından alın.

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.