Arjantin (+54) doğrulama kodlarını entegrasyonunuza çekmek

+54 aktivasyonunun arkasındaki dört API çağrısı nedir?

Her şey https://otproute.com/api/v1 altında yer alır ve or_live_ ile başlayan bir Bearer anahtarıyla kimlik doğrular. Anahtarlar Developer console'da verilir; bir hesap bunlardan 10 tanesini tutabilir, 5 webhook uç noktası kaydedebilir ve üst sınır dakikada 300 istektir.

1. Fiyatı sorun. Kodunuzun cüzdan bakiyesini kullanmadan önce canlı maliyeti bilmesi için GET /api/v1/prices?country=ar&service=<id> çağrısını yapın. Arjantin ülke kimliği ar'dır.
2. Sipariş verin. POST /api/v1/activations ile JSON gövdesi {"service": "whatsapp", "country": "ar"} gönderin; testinizin ihtiyaç duyduğu servis kimliğini yazın. Yanıt, bir aktivasyon kimliği ve test edilen uygulamaya yazılacak +54 numarasını içerir.
3. Bekleyin. Makul bir aralıkla GET /api/v1/activations/{id} okuyun veya kodun geldiğini activation.sms_received webhook'unun bildirmesine izin verin.
4. Gerekirse erkenden bırakın. POST /api/v1/activations/{id}/cancel, artık istemediğiniz bir aktivasyonu sonlandırır ve parayı cüzdana iade eder.

Kimlikleri sabit yazmadan önce görmek isterseniz GET /api/v1/services ve GET /api/v1/countries platformun şu anda sunduklarını listeler. Tüm referans materyali dokümanlarda bulunur.

Webhook alıcısını Arjantin kodları için nasıl güvenilir kılarım?

Her teslimat, t=<unix>,v1=<hex> biçiminde bir X-OTPRoute-Signature başlığı içerir. "<t>.<raw body>" dizesini yeniden oluşturun, o uç noktanın gizli anahtarıyla bu dize üzerinden HMAC-SHA256 hesaplayın ve sonucu sabit zamanlı bir fonksiyonla v1 ile karşılaştırın. Zaman damgası eski olan istekleri atın; çünkü eski ama geçerli bir imza, tekrar saldırısının tam olarak nasıl göründüğüdür.

activation.sms_received dışında activation.expired ve activation.cancelled olaylarına da abone olun; böylece bir test koşucusu zaten kapanmış bir numarayı beklerken takılıp kalmaz. Her olayı aktivasyon kimliğine göre ele alın ve işleyicinizi, aynı olayın ikinci kez teslim edilmesi hiçbir şeyi değiştirmeyecek şekilde yazın. OTP webhook'larını imzalama ve doğrulama yazısı karşılaştırma mantığını daha ayrıntılı anlatır.

Bir Arjantin numarasıyla hangi uygulamaları doğrulayabilirim?

Arjantin için canlı görüntü 2.000'den fazla servis listeliyor. Arjantinli ürün ve QA ekiplerinin sık başvurdukları şunlardır:

• Mesajlaşma: WhatsApp, Telegram, Signal, Discord
• Hesaplar ve üretkenlik: Google (Gmail & YouTube), Microsoft & Outlook, LinkedIn, ChatGPT (OpenAI)
• Sosyal ve video: Instagram, TikTok
• Ticaret ve ulaşım: Amazon, Uber, Airbnb, Netflix

Bu liste gün içinde değişir; API'nin uygunluğu statik bir tablo yerine canlı bildirmesinin nedeni budur. Zamanlanmış bir CI işi başlamadan önce ar ülkesini göz önünde bulundurarak GET /api/v1/services sorgulayın ve hedef servisiniz geçici olarak yoksa net bir mesajla hızlıca başarısız olun.

Arjantin cep numaraları telefon doğrulayıcılarını neden şaşırtır?

Arjantin, bölgedeki en alışılmadık numaralandırma planlarından birine sahiptir. Yurt içinde insanlar alan kodunun önüne bir 0, cep telefonlarında ise abone hanelerinin önüne bir 15 yazar; yani Buenos Aires'teki bir cep numarası 011 15 ve ardından sekiz hane olarak görünebilir. Uluslararası E.164 biçiminde bunların ikisi de kaybolur ve ülke kodunun hemen ardına bir 9 eklenir: +54 9 11 ve ardından sekiz haneli abone numarası.

Bu fark, telefon numarası saklayan herkes için önemlidir. Kaydetmeden önce her şeyi E.164'e normalleştirin, girişte 0 ve 15'i silin ve cep numaraları için 9'u ekleyin. Yalnızca uzunluğu kontrol eden bir doğrulayıcı, SMS alamayan sabit hat tarzı bir +54 11 değerini memnuniyetle kabul eder. API'nin döndürdüğü numarayı kendiniz yeniden biçimlendirmeden olduğu gibi kullanın.

Arjantin numaralarına gönderilen kodlar genellikle İspanyolca gelir; çoğu zaman rakamların çevresinde "Tu código es" gibi bir ifade bulunur. Şablonlar değiştiği için kelimelerle eşleşmek yerine sayısal kodu bir desenle ayrıştırın. Ekipler burada Latin Amerika'da lansman yaparken, Río de la Plata İspanyolcası metinlerini kontrol ederken (yerel vos biçimleri ders kitabı İspanyolcasından farklıdır), bölgesel operasyon yürütürken veya yurt dışında yaşayıp hâlâ +54 SIM ile kayıt olan Arjantinlilere hizmet verirken test yapar.

Kod yazmayan biri +54 numarası sipariş edebilir mi?

Evet. Destek, büyüme ve ajans ekibi çalışanları işin tamamını tarayıcıdan yapabilir:

1. Kayıt sayfasında bir e-posta ve 6 haneli kodla ya da Google ile giriş yaparak hesap oluşturun.
2. Cüzdana bakiye ekleyin.
3. OTP Gateway'i açın, Arjantin'i seçin, ardından test ettiğiniz servisi seçin.
4. Gösterilen fiyatı kontrol edin, onaylayın ve +54 numarasını uygulamanın doğrulama ekranına kopyalayın.
5. Aktivasyonu izleyin; kod alındığı anda orada belirir.

Panel ve API aynı cüzdanı ve aynı aktivasyonları kullanır; bu yüzden bir geliştirici, bir ekip arkadaşının sipariş ettiği numarayı aktivasyon kimliğiyle devralabilir.

Arjantin kodu gelmedi. Sırada ne var?

Her aktivasyon 20 dakika açık kalır. Hiçbir şey gelmezse ya da önce iptal ederseniz tutarın tamamı cüzdana otomatik olarak döner; yani sessiz bir rota size para değil zaman kaybettirir. Teslimat hızı servise ve rotaya bağlıdır; bu yüzden başarısız saymadan önce süreye adil bir şans verin.

Ardından şu kısa listeyi izleyin:

• Uygulamanın içinden kodu bir kez daha isteyin, sonra sürenin dolmasına izin verin.
• Günün ilerleyen saatlerinde deneyin veya aynı servis için başka bir rota üzerinden sipariş verin.
• Servisin sanal numaraları hiç kabul edip etmediğini doğrulayın; bazıları reddeder, otomatik iadenin nedeni budur.
• CI'dan sıkı döngüyle yeniden sipariş vermeyin. Bir geri çekilme (back-off) ve yeniden deneme üst sınırı ekleyin.

Başarısız OTP teslimatlarını azaltma yazımız Arjantin rotaları için daha fazla örüntüyü kapsar. Her testi servislerin şartları içinde tutun; OTP Route Kabul Edilebilir Kullanım Politikası da geçerlidir.

Bir Arjantin hattını saklayabilir miyiz ve nasıl ödeme yaparız?

Bugün Arjantin için kendi kendine alınabilen uzun vadeli bir numara yok. Ekibinizin kalıcı bir +54 hattına ihtiyacı varsa [email protected] adresine e-posta gönderip kullanım amacını anlatın; bunun ayarlanıp ayarlanamayacağı yerel kurallara bağlıdır ve garanti edilmez. Yenilendikleri sürece sizde kalan ve gelen SMS'leri webhook'unuza ileten Dedicated Virtual Numbers ise $1.95/ay'dan başlayan bir Amerika Birleşik Devletleri ve Kanada ürünüdür.

Faturalandırma, aylık ücreti olmayan ve seçilecek bir plan bulunmayan tek bir ön ödemeli USD cüzdanı üzerinden yürür. Kartla veya USDT/USDC ile bakiye yükleyin; her yükleme için e-postayla bir PDF fatura oluşur. Ayrıntılar fiyatlandırma sayfasındadır. Gerçek bakiye harcamadan önce geliştirme hesabınızın sandbox'a alınmasını isteyin; sandbox, Arjantin akışının tamamını baştan sona prova edebilmeniz için simüle edilmiş numaralar ve kodlar döndürür.

Sık sorulan sorular

OTP Route API'sinde Arjantin'in ülke kimliği nedir?

ar'dır. Bunu POST /api/v1/activations içindeki country alanında ve GET /api/v1/prices sorgu dizesinde kullanın.

+54 numarasını bir uygulamaya yazarken 9'u eklemem gerekir mi?

Numarayı OTP Route'un döndürdüğü şekliyle kullanın. Kendi veritabanınızda Arjantin cep numaralarını +54'ten sonra 9'u içeren ve iç hat 0'ı ile 15'i atan E.164 biçiminde saklayın.

Arjantin SMS OTP'si almak ne kadar tutar?

Servise göre değişen kod başına $0.20'den. Kesin tutar GET /api/v1/prices ile döndürülür ve siz siparişi onaylamadan önce gösterilir.

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

Evet. Kendi uygulamanız ya da testinizdeki üçüncü taraf servis için bir Arjantin aktivasyonu sipariş edin, +54 numarasını girin ve kodu panelden ya da webhook'unuzdan okuyun.

Aynı +54 numarası gelecek ay bir giriş için yine çalışır mı?

Hayır. Bir gateway numarası 20 dakika içinde tek bir kodu kapsar. Kod almaya devam etmesi gereken hesaplar için ABD veya Kanada'daki bir Dedicated Number uygun seçenektir.

Arjantin doğrulama metni hangi dilde olacak?

Genellikle İspanyolca; ancak gönderene ve hesabın dil ayarlarına bağlıdır. Çevredeki kelimelere güvenmek yerine rakamları çıkarın.

Webhook yerine sorgulama (polling) kabul edilebilir mi?

Evet. GET /api/v1/activations/{id} adresini ılımlı bir aralıkla sorgulayın ve hesap başına dakikada 300 istek sınırının epey altında kalı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.