Tunus (+216) SMS Doğrulaması: Geliştiriciler İçin Bir Kontrol Listesi

Bir +216 numarası sipariş etmeden önce uçuş öncesi kontrol listesinde neler olmalı?

Bu listeyi bir kez gözden geçirin; Tunus test çalıştırmalarının çoğu sorunsuz geçer:

• API anahtarı hazır. Developer console'da bir Bearer anahtarı oluşturun; canlı anahtarlar or_live_ ile başlar.
• Cüzdan yüklü. OTP Gateway, ön ödemeli USD bakiyenizden çeker; GET /api/v1/balance bunu bir betikten doğrular.
• Webhook erişilebilir. Bir HTTPS uç noktası kaydedin, sırrını saklayın ve zaman damgası kontrollerinin geçmesi için sunucu saatinizin doğru olduğunu teyit edin.
• Fiyat kontrol edildi. Test etmeyi planladığınız tam servis için GET /api/v1/prices?country=tn&service=<id> çağırın.
• Telefon alanı test edildi. Kendi formunuzun sekiz haneli bir Tunus ulusal numarasını ve yapıştırılmış bir +216 uluslararası numarasını kabul ettiğinden emin olun.
• Ayrıştırıcı toleranslı. Kod çıkarmanın Arapça, Fransızca ve İngilizce mesaj gövdelerinde çalıştığını doğrulayın (aşağıya bakın).
• Şartlar gözden geçirildi. Kendi ürününüzü test ediyor ya da kendi meşru hesabınızı işletiyorsunuz; servisin kurallarına ve OTP Route'un Kabul Edilebilir Kullanım Politikasına uygun.

Tunus numaraları E.164 için nasıl biçimlendirilir?

Tunus kapalı bir numaralandırma planı kullanır: her abone numarası sekiz hanelidir ve trunk öneki yoktur; yani ülke kodunu eklemeden önce çıkarılacak bir şey yoktur. E.164 biçimi basitçe +216 ve ardından o sekiz hanedir. Yerel halk numaraları çoğu zaman xx xxx xxx gibi gruplar halinde yazar; bu yüzden normalize ederken boşlukları, noktaları ve tireleri kaldırın. Baştaki hanelerin sabit bir listesine karşı doğrulama yapmaktan kaçının; elle yazılmış bir aralık tablosundan çok uzunluk kontrolü artı saygın bir telefon kütüphanesi daha güvenlidir.

Tunus doğrulama metinleri hangi dillerde gelir?

Resmî dil Arapçadır, günlük hayatta konuşulan Tunus Arapçasıdır ve Fransızca iş dünyasında, idarede ve birçok uygulamada yaygındır. Sonuç olarak tek bir test çalıştırması, göndericiye ve cihaz yerel ayarına bağlı olarak Fransızca, İngilizce ya da Arapça kodlar görebilir.

Arapça mesajlar Unicode SMS olarak gider ve rakamların çevresinde sağdan sola yön işaretleri içerebilir. Görünmez işaretleri temizledikten sonra dört ila sekiz ASCII rakamlık ilk diziyi yakalayan bir regex, üç dilde de çalışır. Ekipler Tunus'u genellikle Fas ve Cezayir ile birlikte Fransızca konuşulan Kuzey Afrika lansmanları için, sağdan sola yerleşimlerin yerelleştirme QA'sı için ya da Avrupa'da yaşayan Tunuslu müşterilere hizmet ettikleri için test matrisine ekler; test için bir +216 numarası bunların her birini karşılar.

Adım adım: API ile bir Tunus OTP'si almak

Canlı görüntü, Tunus için Facebook, WhatsApp, Instagram, Telegram, TikTok, Google (Gmail & YouTube), Snapchat, Signal, LinkedIn, Discord, ChatGPT (OpenAI), Microsoft & Outlook, Amazon ve Uber dahil 1.700'den fazla servis listeler. Uygunluk gün içinde değişir; bu yüzden bir çalıştırma başladığında OTP yönlendirme mantığınızın bunu GET /api/v1/services ve GET /api/v1/countries üzerinden okumasına izin verin.

1. {"service": "facebook", "country": "tn"} ile POST /api/v1/activations gönderin ve aktivasyon id'sini kaydedin.
2. Dönen numarayı test ettiğiniz uygulamaya yazın ve kodu tetikleyin.
3. Webhook'unuzda activation.sms_received olayını işleyin: X-OTPRoute-Signature değerini doğrulayın (zaman damgasının, bir noktanın ve ham gövdenin HMAC-SHA256'sı), eski zaman damgalarını reddedin ve zaten işlediğiniz bir aktivasyon id'si için kopyaları yok sayın.
4. Webhook yoksa, dakikada 300 istek sınırının oldukça altında kalarak GET /api/v1/activations/{id} adresini yoklayın.
5. Test yarıda kesilirse POST /api/v1/activations/{id}/cancel çağırın.

API dokümanları her alanı listeler ve CI test kılavuzu bunu bir işlem hattına nasıl bağlayacağınızı gösterir.

Adım adım panelden

1. E-postanız ve altı haneli bir kodla ya da Google ile girişle bir hesap oluşturun ve TOTP iki faktörlü doğrulamayı açın.
2. Kartla ya da USDT/USDC ile bakiye ekleyin.
3. Tunus'u, ardından servisi seçin ve gösterilen fiyatı kontrol edin.
4. Sipariş verin, +216 numarasını kopyalayın ve hedef uygulamada kodu isteyin.
5. Tunus kodunu panelde göründüğü anda kopyalayın ve test ettiğiniz kaydı tamamlayın.

Sorun giderme: +216 kodu hiç gelmezse?

Her aktivasyon 20 dakika sürer ve yalnızca bir kod geldiğinde ödersiniz. Pencere dolarsa ya da iptal ederseniz, tutarın tamamı cüzdana döner.

• Hiçbir şey gelmedi: pencerenin dolmasına izin verin, ardından test izin veriyorsa daha sonra ya da başka bir servis rotasıyla yeniden deneyin.
• Servis numarayı reddetti: bazı servisler sanal numaraları reddeder; iade bu durumu karşılar.
• Webhook sessiz ama panel kodu gösteriyor: imza kontrolünüz büyük olasılıkla başarısız oluyor; yeniden serileştirilmiş JSON'a değil ham gövdeye karşı karşılaştırın ve saat kaymasını kontrol edin.
• Arka arkaya birkaç başarısızlık: bir geri çekilme (back-off) ekleyin; sıkı bir döngüde yeniden sipariş vermek nadiren işe yarar.

Tunus için uzun süreli hatlar, faturalama ve sandbox

Kendi kendine alınabilen uzun süreli bir Tunus numarası yoktur. Dedicated Number'lar, $1.95/ay'dan başlayan bir ABD ve Kanada ürünüdür; kalıcı bir +216 hattına ihtiyacınız varsa [email protected] adresine yazın, uygunluğun yerel kurallara bağlı olduğunu aklınızda tutun.

Cüzdan kullandıkça öde esaslıdır, aylık ücreti yoktur ve her yükleme için e-postayla bir PDF fatura gelir. Geliştirme hesapları sandbox modu isteyebilir; simüle edilmiş numara ve kodlar, bakiye harcamadan entegrasyonu kanıtlamanızı sağlar.

Sık sorulan sorular

Tunuslu bir SIM kart olmadan bir Tunus kayıt akışını test edebilir miyim?

Evet. OTP Gateway'den bir +216 numarası kullanın ve kodu panelde ya da SMS doğrulama API'si ve webhook'lar üzerinden toplayın.

Tunus numaralarında kaldırılacak bir trunk öneki var mı?

Hayır. Tunus numaraları trunk öneki olmayan sekiz hanelidir; bu yüzden E.164 biçimi yalnızca +216 artı o hanelerdir.

Tunus OTP API'sinin ülke id'si nedir?

Fiyat sorgusunda ve POST /api/v1/activations istek gövdesinde tn kullanın.

Bir Tunus doğrulama numarası ne kadar tutar?

Kod başına $0.20'dan; kesin tutar servise bağlıdır ve sipariş vermeden önce panelde ve fiyat uç noktasında görünür. Fiyatlandırma sayfasına bakın.

Ayrıştırıcım Arapça OTP mesajlarında başarısız oluyor. Neyi değiştirmeliyim?

Unicode yön işaretlerini temizleyin ve çevresindeki kelimeler yerine rakam dizisini eşleştirin; böylece aynı kural Arapça, Fransızca ve İngilizce gövdelerde çalışır.

Sonraki girişler için bir +216 numarasını elimde tutabilir miyim?

Kendi kendine alınabilen bir yolla hayır. Bir gateway numarası tek bir kodu karşılar ve anında alınabilen uzun süreli hatlar yalnızca ABD ve Kanada'da vardır.

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.