Suudi Lansmanları İçin +966 Doğrulama Kodlarını Programatik Olarak Almak

API üzerinden tek bir +966 aktivasyonu neye benzer?

Çağrılardan başlayalım; çünkü bu sayfayı okuyanların çoğu bir SMS doğrulama API'sini test paketine veya dahili bir araca bağlıyor. Tüm uç noktalar https://otproute.com/api/v1 altındadır ve Developer console'da oluşturulan, or_live_ önekli bir Bearer anahtarı bekler.

1. GET /api/v1/countries ve GET /api/v1/services size kimlikleri verir. Suudi Arabistan sa'dır.
2. GET /api/v1/prices?country=sa&service=<id> o eşleşme için canlı fiyatı döndürür; test çalıştırmasının yanına kaydedin.
3. POST /api/v1/activations ile {"service": "<id>", "country": "sa"} bir aktivasyon kimliği ve bir +966 numarası döndürür.
4. Testiniz numarayı uygulamaya girer; kod bir olay olarak ya da GET /api/v1/activations/{id} ile gelir.
5. Test yarıda bırakılırsa POST /api/v1/activations/{id}/cancel numarayı serbest bırakır ve cüzdana iade eder.

GET /api/v1/balance, uçuş öncesi kontrol olarak işe yarar; böylece gece çalışan bir iş, çalışmanın ortasında değil, başında net bir mesajla başarısız olur. Planlamanız gereken sınırlar: hesap başına 10 anahtar, 5 webhook uç noktası ve dakikada 300 istek.

Webhook alıcımız Suudi OTP olaylarını nasıl ele almalı?

Bir uç nokta kaydedin ve activation.sms_received, activation.expired ve activation.cancelled olaylarına abone olun. Her istek, t=<unix>,v1=<hex> biçiminde X-OTPRoute-Signature içerir.

• İmzalanan dizeyi <t>.<raw body> olarak yeniden oluşturun ve o uç noktanın gizli anahtarıyla HMAC-SHA256 hesaplayın.
• Sonucu v1 ile sabit zamanlı bir fonksiyonla karşılaştırın ve zaman damgası çok eski olan her şeyi reddedin.
• Her olayı aktivasyon kimliğine bağlı sayın; böylece yeniden teslimat hiçbir şeyi iki kez güncellemez.
• Hızlıca 2xx yanıtı verin ve yavaş işleri arka plan görevinde yapın.

Gelen bağlantı kabul edemeyen çalıştırıcılar için yoklama geçerli bir yedek olmaya devam eder. Webhook tabanlı OTP yakalama ve HMAC ile OTP webhook'larını güvenceye alma yazılarımız konuyu daha da derinleştirir.

Ürün ekipleri neden +966 numarasıyla test yapıyor?

Suudi Arabistan, Körfez'in daha büyük dijital pazarlarından biridir ve ekipler bu sayfaya pratik nedenlerle gelir: Suudi sakinler için işe alım süreci hazırlayan bir fintech, Körfez'den satıcılar ekleyen bir pazar yeri, müşterisi bölgesel bir oturum açma kontrolü isteyen bir SaaS firması ya da Riyad veya Cidde'deki bir ofisin işletme hesaplarını yöneten bir operasyon ekibi. Her durumda birinin akışın gerçek bir Suudi doğrulama numarasıyla çalıştığını kanıtlaması gerekir ve ağ geçidi üzerinden OTP yönlendirme, bölgeye SIM kart göndermeyi gereksiz kılar. Fintech işe alım sayfası bu senaryoyu daha ayrıntılı anlatır.

Suudi hatlarında hangi servisler kod alabilir?

Suudi Arabistan için canlı görüntü 1.000'den fazla servisi kapsıyor. Sık kullanılanlar arasında Snapchat, WhatsApp, X (Twitter), Uber, TikTok, Instagram, Google (Gmail & YouTube), Telegram, Amazon, Microsoft & Outlook, LinkedIn, Discord ve Netflix var. Snapchat ve X'in Krallık'ta özellikle geniş kitleleri vardır; bu da onları yerelleştirme kontrol listelerinde sık görülen maddeler yapar. Envanter gün içinde değiştiğinden API'yi çalışma anında sorgulayın.

+966 numaralarını nasıl biçimlendirir, Arapça mesajları nasıl ayrıştırırım?

Yerel olarak Suudi cep numaraları başa 0 konarak, genellikle 05 ve ardından sekiz hane şeklinde yazılır. Uluslararası biçimde bu sıfır düşer: +966 5 ve kalan sekiz hane. Her şeyi girişte E.164'e normalleştirin ve kullanıcı ülke kodundan sonra sıfırı yazarsa silin.

Arapça resmî dildir; bu yüzden doğrulama mesajları Arapça, İngilizce ya da her ikisiyle gelebilir. Arapça sağdan sola yazılır ve bazı şablonlar Batı rakamları yerine Arap-Hint rakamları kullanabilir. Eşleştirmeden önce bu rakamları ASCII'ye çeviren ve ham UTF-8'i kaydeden bir ayrıştırıcı, sinir bozucu bir yanlış başarısızlık sınıfını önler.

Kod yazmayanlar için panel yolu var mı?

Evet. OTP Route'ta oturum açın, OTP Gateway'i açın, Suudi Arabistan'ı ve servisi seçin, fiyatı inceleyip onaylayın. Numara hemen görünür ve kod geldiğinde yanında gösterilir. Bir destek temsilcisi bunu birkaç dakika içinde müşterinin kayıt sorununu yeniden üretmek için kullanabilir.

Kod hiç gelmezse, uzun süreli hatlar ve faturalama ne olacak?

20 dakika içinde SMS gelmezse ya da iptal ederseniz tutarın tamamı otomatik olarak cüzdana döner. Sürenin dolmasını bekleyin, daha sonra ya da başka bir servis hattıyla yeniden deneyin, servisin sanal numaraları kabul ettiğini doğrulayın ve sıkı bir döngüde yeniden sipariş vermekten kaçının.

Self-servis uzun süreli bir Suudi numarası yoktur. Dedicated Virtual Number'lar yalnızca Amerika Birleşik Devletleri ve Kanada'da, ayda $1.95'ten sunulur; uzun süreli bir +966 hattı için [email protected] adresine yazın, ancak mümkün olup olmadığını yerel kuralların belirlediğini aklınızda tutun.

Ödeme, kullandıkça öde esasıyla çalışan ve aylık ücreti olmayan tek bir ön ödemeli USD cüzdanla yapılır. Yüklemelerde kart ödemeleri ve USDT/USDC birlikte çalışır ve her biri e-postayla PDF fatura üretir. Bir geliştirme hesabı, talep üzerine simüle edilmiş numaralar ve kodlar için sandbox'a alınabilir. Güncel fiyatlar için fiyatlandırma sayfasına bakın.

Sık sorulan sorular

API ile Suudi SMS OTP'yi nasıl alırım?

sa ülkesi ve servis kimliğinizle bir aktivasyon oluşturun, ardından kodu activation.sms_received webhook'undan ya da aktivasyonu yoklayarak alın.

Kod başarısız olursa test için +966 numarası faturalandırılır mı?

Hayır. Kod gelmezse 20 dakikalık süre dolduğunda veya iptal ettiğinizde tutarın tamamı cüzdana iade edilir.

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

Evet. OTP Gateway tek kod için bir +966 numarası verir; bunu uygulamanıza girer, panelden veya API'den geri okursunuz.

05XXXXXXXX olarak girilen bir Suudi cep numarasını nasıl saklamalıyım?

Baştaki sıfırı atın ve E.164'te +966 5 artı kalan sekiz hane olarak saklayın.

Sonraki girişler için aynı Suudi numarasını tutabilir miyiz?

Self-servis bir ürünle değil; çünkü uzun süreli Dedicated Number'lar yalnızca ABD ve Kanada'yı kapsar. Suudi hattına ihtiyacınız varsa ekibe e-posta gönderin, sağlanabileceğine dair güvence yoktur.

Gerçek para devreye girmeden Suudi akışını prova etmenin bir yolu var mı?

Evet. Geliştirme hesabında sandbox modunu isteyin; webhook'lar dahil simüle edilmiş numaralar ve kodlar alırsınız.

OTP Route hangi kullanıma izin verir?

Kendi meşru ürünlerinizi ve hesaplarınızı test etmek ve işletmek. Her servisin şartlarına uyun; OTP Route Kabul Edilebilir Kullanım Politikası geçerlidir.

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.