Webhook ve sorgulama (polling) etrafında bir +592 doğrulama testi kurmak

Webhook öncelikli bir Guyana OTP API akışını nasıl tasarlarım?

Tek seferlik bir kontrolün ötesindeki her iş için, platformdan tekrar tekrar sormak yerine kodları size göndermesini sağlayın. Developer console'da bir HTTPS uç noktası ekleyin (bir hesapta 5 tane olabilir) ve activation.sms_received ile birlikte activation.expired ve activation.cancelled olaylarına abone edin; böylece test çalıştırıcınız çıkmazları da başarıları duyduğu kadar hızlı duyar.

Gelen her isteği doğrulamadan geçene kadar güvenilmez kabul edin:

• t=<unix>,v1=<hex> biçimindeki X-OTPRoute-Signature başlığını okuyun.
• Zaman damgasını, bir noktayı ve değiştirilmemiş istek gövdesini birleştirin, ardından bu dize üzerinde uç noktanın gizli anahtarıyla HMAC-SHA256 hesaplayın.
• Özetinizi v1 ile sabit zamanlı karşılaştırın ve zaman damgası eskiyse isteği atın.
• Olaydaki aktivasyon kimliğini bulun; onu zaten işlediyseniz başarı döndürün ve başka bir şey yapmayın.

Bu son kural işleyiciyi idempotent tutar; böylece ağ aksaması sonrası yeniden teslimat testi asla karıştırmaz. Daha uzun bir anlatım webhook tabanlı OTP yakalama yazısında var.

Bir +592 siparişi hangi uç noktaları ve kimlikleri kullanır?

Developer console'dan aldığınız Bearer anahtarıyla kimlik doğrulayın; canlı anahtarlar or_live_ ile başlar ve her hesap en fazla 10 tane tutabilir. Temel URL https://otproute.com/api/v1, Guyana'nın ülke kimliği ise gy'dir.

Tipik bir çalıştırma önce GET /api/v1/prices?country=gy&service=<id> çağrısını okur, çünkü bu rotada fiyat ve erişilebilirlik sabit değil, canlı değerlerdir. Ardından POST /api/v1/activations isteğini {"service": "<id>", "country": "gy"} gövdesiyle gönderir ve bir +592 numarası ile bir aktivasyon kimliği alır. Webhook yoksa çalıştırıcı, dakikada 300 istek sınırının çok altında, birkaç saniyede bir GET /api/v1/activations/{id} sorgular. Test iptal edilirse bir temizlik adımı POST /api/v1/activations/{id}/cancel çağırır; GET /api/v1/balance ile yapılan ön kontrol ise cüzdan azsa paketi erkenden durdurur. Servis kimlikleri GET /api/v1/services ucundan gelir; geliştirici merkezinde bu SMS doğrulama API'si için istemci örnekleri bulunur.

+592 numaraları saklamak için nasıl biçimlendirilir?

Guyana, 592 ülke kodunu ve kaldırılacak bir ulusal arama öneki olmayan yedi haneli ulusal numaraları kullanır; dolayısıyla E.164 biçimi basitçe +592 ve ardından bu yedi hanedir. İnsanlar rakamları genellikle üçlü ve dörtlü iki grup halinde yazar.

Kaldırılacak baştaki sıfır olmadığı için normalizasyon, boşluk ve tireleri silmeye ve kullanıcı yalnızca yerel rakamları girdiğinde ülke kodunu eklemeye iner. Sık görülen bir hata, her Güney Amerika numarasının alan kodu olduğunu varsayan ya da asgari uzunluğu yedi hanenin üzerine koyan ve bu yüzden geçerli Guyana girişlerini reddeden formdur. Test için bir +592 numarası bunu hızla ortaya çıkarır. E.164 dizesini kaydedin ve yerel biçimlendirmeyi yalnızca görüntüleme anında uygulayın.

Hangi servisler Guyana SMS OTP kodlarını alabilir ve elle sipariş verebilir miyim?

Guyana rotası 900'den fazla servis listeler. Sık talep edilenler arasında WhatsApp, Facebook, Instagram, Google (Gmail & YouTube), TikTok, Telegram, imo, Viber, Snapchat, Amazon, Microsoft & Outlook, Discord, Netflix ve Claude var. Bu liste canlı kataloğun anlık görüntüsüdür; bu yüzden bir testi tek bir göndericiye göre planlamadan önce API veya panel üzerinden teyit edin.

Kod yazmayan çalışma arkadaşları için panel aynı işi görür. Giriş yapın, OTP Gateway'i açın, Guyana'yı ve bir servisi seçin, fiyatı inceleyin ve sipariş verin. Guyana doğrulama numarası 20 dakikalık bir geri sayımla birlikte görünür; kod geldiğinde yanında gösterilir.

+592 kodu geç gelirse veya hiç gelmezse bir test ne yapmalı?

Bir aktivasyon 20 dakika açık kalır. Yalnızca kod bu süre içinde gelirse ödeme yaparsınız; süre dolarsa ya da iptal ederseniz tutarın tamamı hiçbir destek talebi olmadan cüzdana döner.

Otomatik bir çalıştırmada makul yaklaşım:

1. Başarısızlık ilan etmeden önce süreyi bekleyin; testinizin kesin bir zaman sınırı varsa açıkça iptal edin.
2. Daha sonra yeniden deneyin ya da API sunuyorsa farklı bir servis rotasına geçin.
3. Hedef servisin sanal numaraları kabul edip etmediğini kontrol edin; bazıları reddeder ve iade tam olarak bu durumu karşılar.
4. Yeniden denemeleri sıkı bir döngüde yeniden sipariş vermek yerine geri çekilmeyle (backoff) aralıklandırın.

OTP için ülke yönlendirme rehberi, yedek rotaların nasıl seçileceğini açıklar.

Ekipler neden Guyana kayıt akışlarını test eder?

Guyana, resmî dili İngilizce olan tek Güney Amerika ülkesidir ve Georgetown, CARICOM Sekretaryası'na ev sahipliği yapar; bu yüzden Karayip Topluluğu'nu tek pazar sayan lansmanlarda sık sık yer alır. Hızla büyüyen açık deniz enerji sektörü uluslararası yüklenici ve tedarikçileri çekti; ABD, Kanada ve Birleşik Krallık'taki geniş diaspora ise para transferi, mesajlaşma ve seyahat uygulamalarını +592 numaralarıyla meşgul tutuyor. Guyana Kreolü günlük hayatta yaygın konuşulur, ancak doğrulama mesajları genellikle İngilizce gelir. Kalite güvence açısından bu, çabayı çevrilmiş metne değil numara girişine, ülke seçicilere ve SMS onay ifadelerine yöneltir. Tüm kontrolleri kuruluşunuzun sahip olduğu hesaplarda tutun, her servisin şartlarına uyun ve OTP Route'un Kabul Edilebilir Kullanım Politikasının tüm siparişleri kapsadığını unutmayın.

Guyana hattını uzun süre tutabilir miyim ve kullanım nasıl faturalandırılır?

Guyana için self-servis uzun süreli numara sunulmaz. OTP Route'un Dedicated Numbers ürünü yalnızca Amerika Birleşik Devletleri ve Kanada'yı kapsar ve aylık $1.95'ten başlar. Bir +592 hattı için [email protected] adresine e-posta gönderin; ekip yerel kuralların neye izin verdiğini kontrol eder, ancak söz verilmez.

Ödeme tek bir ön ödemeli USD cüzdanı üzerinden yürür: aylık ücret yok, plan yok, kartla veya USDT/USDC ile yükleme ve her yükleme için e-postayla PDF fatura. Talep üzerine bir geliştirme hesabı sandbox'a alınabilir; böylece entegrasyon testleri simüle edilmiş numara ve kodlarla çalışır ve bakiyeye dokunmaz. Servis başına fiyatlar fiyatlandırma sayfasında görünür.

Sık sorulan sorular

Guyanalı bir operatörün SIM kartı olmadan uygulamamın Guyana kayıt akışını kontrol edebilir miyim?

Evet. Servisiniz için OTP Gateway'den bir +592 numarası sipariş edin, akışınızda girin; kod panelde görünür ya da webhook'unuza ulaşır. Fiyatlar kod başına $0.20'den başlar.

API, Guyana için hangi ülke kimliğini kullanır?

gy'dir; hem fiyat sorgusunda hem de aktivasyon isteği gövdesinde kullanılır.

Guyana numaralarındaki baştaki sıfırı silmem gerekir mi?

Hayır. Guyana'da ulusal arama öneki yoktur; E.164 biçimi +592 ve ardından yedi haneli numaradır.

+592 doğrulama mesajları hangi dilde gelir?

Genellikle resmî dil olan İngilizce. Yine de metni gönderen belirler ve uygulamanın dil ayarını izleyebilir.

Servis SMS'i hiç göndermezse iade var mı?

Evet, ve otomatiktir. 20 dakika kod gelmeden geçerse ya da iptal ederseniz tutarın tamamı cüzdanınıza döner.

Entegrasyonun tamamını para harcamadan test edebilir miyim?

Destekten geliştirme hesabınızı sandbox'a almasını isteyin. Simüle edilmiş numaralar ve kodlar döndürür; böylece API çağrıları ve webhook'lar uçtan uca denenebilir.

Uzun süreli bir +592 numarası var mı?

Self-servis ürün olarak yok. Dedicated Numbers yalnızca Amerika Birleşik Devletleri ve Kanada'da satılır; Guyana hakkında sormak için [email protected] adresine e-posta gönderin.

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.