Katar OTP API: Webhook'lar, Polling ve +974 Test Numaraları

Katar OTP API çağrı sırası nasıl görünür?

Her şey https://otproute.com/api/v1 altında yer alır ve or_live_ ile başlayan bir Bearer anahtarıyla doğrulanır. En fazla 10 anahtar tutabilirsiniz; bu yüzden CI, staging ve operasyon betiğine ayrı anahtarlar verin ve diğerlerine dokunmadan birini iptal edin. Eksiksiz bir +974 aktivasyonu en fazla dört çağrı alır:

1. GET /api/v1/prices?country=qa&service=<id> canlı fiyatı döndürür ve rotanın o servis için şu anda açık olduğunu bildirir.
2. POST /api/v1/activations isteği {"service": "<id>", "country": "qa"} ile bir Katar numarası ayırır ve bir aktivasyon kimliği döndürür.
3. GET /api/v1/activations/{id} polling çağrısıdır: Katar siparişinin durumunu gösterir ve teslimattan sonra kodu içerir.
4. POST /api/v1/activations/{id}/cancel siparişi erken sonlandırır ve tutarı cüzdana iade eder.

İki yardımcı çağrı tabloyu tamamlar: GET /api/v1/services adları servis kimliklerine eşler ve GET /api/v1/balance bir pipeline'ın bakiye bitmeden durmasını sağlar. Trafiği hesap başına dakikada 300 isteğin altında tutun. Geliştirici genel bakışı referans sayfalarını bir araya getirir.

Bir webhook işleyicisi Katar aktivasyon olaylarını nasıl ele almalı?

Polling işe yarar, ancak webhook test çalıştırıcınızın bir şey olduğu anda tepki vermesini sağlar. Beş endpoint'e kadar kaydedin ve activation.sms_received, activation.expired ve activation.cancelled olaylarına abone olun; ilki kodu taşır, diğer ikisi çalıştırıcınıza beklemeyi bırakmasını söyler.

Her istek, t=<unix>,v1=<hex> biçiminde X-OTPRoute-Signature başlığını içerir. İmzalanan dizeyi zaman damgası, bir nokta ve ham istek gövdesi olarak yeniden oluşturun, endpoint'in gizli anahtarıyla HMAC-SHA256 hesaplayın ve sabit zamanlı karşılaştırın. Zaman damgası eskimiş her isteği reddedin. Yeniden denemeler aynı olayı birden fazla kez iletebileceğinden aktivasyon kimliğini saklayın ve tekrarları yok sayın. Referans bir uygulama için webhook tabanlı OTP yakalama yazısını okuyun.

Hangi servisler bir +974 numarasına kod yönlendirebilir?

Katar, son anlık görüntüde 1.600'den fazla servisle daha geniş rotalardan biridir. Popüler olanlar arasında WhatsApp, Google (Gmail & YouTube), Microsoft & Outlook, Telegram, Instagram, Facebook, LinkedIn, Snapchat, TikTok, Uber, Airbnb, ChatGPT (OpenAI), Claude ve Discord bulunur.

Envanter gün içinde değişir; bu yüzden anlık görüntüyü yalnızca yön bulmak için kullanın, doğruyu API'nin yanıtında arayın. Bazı servisler sanal numaraları reddeder; bu durumda sipariş sadece süresi dolarak sona erer ve para geri döner. Yukarıdaki her ad sahibinin ticari markasıdır ve herhangi bir bağlantı ima edilmez.

Test verilerinde Katar numaralarını normalleştirmek

Katar numaraları +974'ten sonra sekiz haneden oluşur ve trunk öneki yoktur; dolayısıyla yerel bir numarayı uluslararası biçime çevirirken atılacak bir şey yoktur. Test verilerini E.164 biçiminde (+974 artı sekiz hane) tutun ve kullanıcıların 00974, boşluklar ya da başka bir ülkenin alışkanlıklarından taşınan başıboş bir baştaki sıfırla yazdığı girdileri temizleyin.

Resmi dil Arapçadır; ancak iş dünyasında ve nüfusun büyük bölümünü oluşturan yabancı işçi ve uzmanlar arasında İngilizce yaygın olarak kullanılır. Doğrulama mesajları bu nedenle gönderen servisin hesap için seçtiği dilde, çoğunlukla İngilizce veya Arapça olarak gelir. Kod çıkarma mantığınızın kodu her iki yazıda da bulduğunu ve Arapça arayüzde OTP girişinin sağdan sola düzende kullanılabilir kaldığını kontrol edin.

Ekipler Katar rotasını GCC'de lansman yaparken, bir tüketici uygulamasını Arapça konuşanlar için yerelleştirirken, Doha'da konaklama veya lojistik operasyonları yürütürken ya da bir çalışanın kişisel numarasını kullanmadan bölgesel bir işletme hesabını doğrularken test eder. CI test rehberi bu kontrolleri otomatik çalıştırmalara nasıl bağlayacağınızı gösterir.

Bunun yerine bir Katar kontrolünü panelden çalıştırmak

Her doğrulama bir betik gerektirmez. Panelde OTP Gateway'i açın, Katar'ı ve servisi seçin, gösterilen fiyatı gözden geçirin ve onaylayın. +974 numarasını uygulamaya kopyalayın, SMS isteyin; kod sipariş üzerinde görünür. 20 dakikalık süre, siparişi verdiğiniz andan itibaren işler ve yalnızca bir kod gelirse ödeme yaparsınız.

Ulaşmayan kodlar: bir hata ayıklama listesi

• Yeterince beklediniz mi? Aktivasyonu başarısız saymadan önce tam süresini işlemesine izin verin.
• Sanal numaralar kabul ediliyor mu? Bazı servisler bunları engeller ve tekrarlanan denemeler bunu değiştirmez.
• Yeniden deneme politikanız makul mü? Bekleyip daha sonra yeniden deneyin ya da aynı servis için başka bir rotaya geçin. Sıkı bir döngüyle yeniden sipariş vermek hız limitinizi boşa harcar ve nadiren işe yarar.
• İşleyiciniz sağlıklı mı? İmza kontrolü başarısız oluyorsa veya endpoint hata döndürüyorsa, webhook'unuz kaçırırken kodun iletilip iletilmediğini görmek için GET /api/v1/activations/{id} ile polling yapın.

Süresi dolarak ya da iptal edilerek SMS'siz biten bir aktivasyon tamamen iade edilir.

Uzun vadeli bir Katar hattı var mı, kullanım nasıl faturalandırılır?

Katar için self-servis uzun vadeli numara yoktur. Dedicated Virtual Numbers (gelen ve giden SMS, webhook yönlendirme ve tarayıcıdan arama özellikli kendi hattınız) yalnızca Amerika Birleşik Devletleri ve Kanada'da, ayda $1.95'ten başlayan fiyatlarla sunulur. Katar'a özgü bir ihtiyaç için [email protected] adresine e-posta gönderin; nelerin mümkün olduğunu yerel kurallar belirler.

Katar kullanımı tek bir ön ödemeli USD cüzdanından karşılanır ve aylık hiçbir şey faturalandırılmaz. Cüzdana kartla veya USDT/USDC ile bakiye yükleyin, her yükleme için bir PDF fatura alın ve entegrasyonu simüle edilmiş numaralarla test etmek istiyorsanız geliştirme hesabı için sandbox modu isteyin. +974 numaralarını yalnızca kendi ürünleriniz ve meşru işletme hesaplarınız için kullanın, her servisin şartlarına saygı gösterin ve OTP Route'un Kabul Edilebilir Kullanım Politikası'na uyun.

Sık sorulan sorular

Otomatik bir testte Katar SMS OTP kodlarını nasıl alırım?

qa ülkesiyle bir aktivasyon oluşturun, dönen numarayı test edilen uygulamaya girin ve activation.sms_received webhook'unu bekleyin. Test çalıştırıcınız gelen istekleri kabul edemiyorsa OTP Route aktivasyonun polling'ini de destekler.

Katar SIM kartı olmadan test için +974 numarası kullanabilir miyim?

Evet. OTP Gateway tek bir kod için bir Katar doğrulama numarası sağlar; böylece herhangi bir yerel SIM kart veya cihaz olmadan kayıt ya da giriş akışlarını test edebilirsiniz.

Sipariş vermeden önce Katar fiyatlarını nasıl kontrol ederim?

GET /api/v1/prices?country=qa&service=<id> çağrısını yapın veya panele bakın. Fiyatlar kod başına $0.20'den başlar ve servise göre değişir.

Başarısız olan Katar aktivasyonları için ücretlendirilir miyim?

Hayır. Yalnızca bir kod geldiğinde faturalandırılırsınız; süresi dolan veya iptal edilen aktivasyonlar otomatik olarak cüzdana iade edilir.

Komşu bir ülkenin numarası yerine neden Katar numarasıyla test yapmalıyım?

Hesabın gerçek pazarıyla eşleşen ülkeyi seçin. Ürününüz Katar'da yayına giriyorsa, bir +974 numarası müşterilerinizin göreceği ülke kodu işleme, dil ve OTP yönlendirmesini tam olarak sınar; bunu OTP için ülke yönlendirmesi yazısında açıklıyoruz.

Bir geliştirme hesabı cüzdan bakiyesi olmadan çalışabilir mi?

Evet. Talep üzerine bir geliştirme hesabı sandbox'a alınabilir; sandbox uçtan uca test için simüle edilmiş numaralar ve kodlar döndürür.

Tekrarlanan girişler için bir Katar numarasını elimde tutabilir miyim?

Self-servis olarak hayır, çünkü özel hatlar ABD ve Kanada ile sınırlıdır. Uzun vadeli bir Katar hattını sormak istiyorsanız [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.