Mısır (+20) SMS doğrulama akışını OTP Route API'sine bağlamak

Bir Mısır OTP API entegrasyonu gerçekte hangi isteklere ihtiyaç duyar?

Yedi endpoint her şeyi kapsar; hepsi https://otproute.com/api/v1 altındadır ve hepsi or_live_ ile başlayan bir Bearer anahtarıyla doğrulanır. Developer console'da her ortam için bir anahtar oluşturun; bir hesap en fazla 10 anahtar tutabilir.

1. Kataloğu GET /api/v1/services ve GET /api/v1/countries ile yükleyin. Mısır'ın ülke kimliği eg'dir ve nadiren değişir, bu yüzden önbelleğe almak sorun değildir.
2. Her siparişten önce güncel fiyat ve erişilebilirlik için GET /api/v1/prices?country=eg&service=<id> çağrısını yapın. Stok gün içinde hareket eder; bu yanıtı yapılandırma değil, taze veri olarak ele alın.
3. Aktivasyonu POST /api/v1/activations ve {"service": "whatsapp", "country": "eg"} gibi bir gövdeyle oluşturun. Bir aktivasyon kimliği ve test edilen ekrana yazılacak +20 numarası alırsınız.
4. Kodu bir webhook'tan ya da GET /api/v1/activations/{id} çağırarak alın.
5. Bir test yarıda kalırsa, tutar hemen dönsün diye siparişi POST /api/v1/activations/{id}/cancel ile serbest bırakın.

Her paketin başında yapılan hızlı bir GET /api/v1/balance, bir CI işinin yarı yolda hata vermek yerine erken durmasını sağlar. Sınır hesap başına dakikada 300 istektir; bu, birkaç aktivasyonu paralel olarak yoklamaya yer bırakır. Tam istek örnekleri geliştirici dokümanlarında yer alır.

+20 kodlarını polling yerine imzalı bir webhook'tan nasıl alırım?

Polling tek bir yerel test için işe yarar; bir hat aynı anda çok sayıda Mısır aktivasyonu çalıştırmaya başladığında ise webhook daha uygundur. Developer console'da bir uç nokta ekleyin (hesap başına beş) ve activation.sms_received olayına, ayrıca işinizin ne zaman beklemeyi bırakacağını bilmesi için activation.expired ve activation.cancelled olaylarına abone olun.

Her istek X-OTPRoute-Signature: t=<unix>,v1=<hex> taşır. <t>.<raw body> dizesini yeniden oluşturun, uç noktanın gizli anahtarıyla HMAC-SHA256 hesaplayın ve sonucu v1 ile sabit zamanlı bir kontrolle karşılaştırın. Zaman damgası eski olan her şeyi reddedin ve ayrıştırılıp yeniden kodlanmış bir nesneyi değil, baytları aldığınız haliyle özetleyin.

Aktivasyon kimliğini idempotency anahtarı olarak kullanın: olayı bir kez saklayın, tekrarları yok sayın ve hızlıca bir 2xx döndürün. Webhook ile OTP yakalama rehberi, bu işleyicinin kuyruk destekli bir sürümünü adım adım anlatır.

Hangi servisler bir Mısır doğrulama numarasına kod gönderebilir?

Mısır için canlı anlık görüntü toplamda 1.600'den fazla servis listeler. Ekiplerin +20 numaralarında test ettiği popüler servisler arasında WhatsApp, Facebook, Instagram, TikTok, Telegram, Google (Gmail & YouTube), Microsoft & Outlook, Uber, Snapchat, Viber, imo, ChatGPT (OpenAI), Amazon ve LinkedIn bulunur.

Bu liste belirli bir andaki görünümdür, bir söz değildir. Bu sabah numarası olan bir servisin öğleden sonra az numarası olabilir; fiyat uç noktasının maliyetin yanında erişilebilirliği de bildirmesinin nedeni tam olarak budur. Bazı servisler ayrıca sanal numaraları tümden geri çevirir; bu olduğunda aşağıda anlatılan iade kuralı sizi korur.

Bir uygulama Mısır cep numaralarını nasıl saklamalı ve doğrulamalı?

Mısır, +20 ülke kodunu ve 0 olan bir yurt içi trunk önekini kullanır. Yerel olarak bir cep numarası 01 ile başlayan on bir haneyle yazılır; uluslararası biçimde ise sıfır kaybolur ve +20'den sonra on hane gelir. Birkaç alışkanlık hataların çoğunu önler:

• Yalnızca E.164 biçimini kaydedin, örneğin +201XXXXXXXXX, ve görüntüleme için gösterim anında biçimlendirin.
• Bir kullanıcı ülke zaten Mısır seçiliyken 01… girerse trunk sıfırını silin; aksi halde geçersiz bir +2001… değeri elde edersiniz.
• Rakamları normalleştirin. Arapça klavye kullananlar Arap-Hint rakamları yazabilir; bunları doğrulamadan önce ve girilen OTP'yi karşılaştırmadan önce ASCII rakamlara çevirin.

Resmî dil Arapça olduğundan birçok servis Mısırlı kullanıcılara kodları Arapça gönderir, diğerleri ise varsayılan olarak İngilizce kullanır. Kodu bir regex ile ayıklıyorsanız, onu İngilizce gövdelerin yanı sıra sağdan sola yazılan mesaj gövdelerine karşı da test edin.

Operasyon ekibi kod yazmadan bir Mısır numarası sipariş edebilir mi?

Evet. Her kontrol bir betik gerektirmez ve destek ya da büyüme ekibindeki iş arkadaşlarınız aynı OTP Gateway'i tarayıcıdan kullanabilir:

1. E-postanız ve 6 haneli kodla ya da Google ile kaydolun.
2. Cüzdana bakiye yükleyin ve OTP Gateway'i açın.
3. Mısır'ı ve servisi seçin; fiyat onaylamadan önce görünür.
4. +20 numarasını uygulamaya kopyalayın ve kodun ekranda belirmesini bekleyin.

Aktivasyon bir API siparişiyle aynıdır; dolayısıyla elle yapılan kontrol ile otomatik kontrol aynı şekilde davranır.

+20 kodu hiç görünmezse ne olur?

Her aktivasyon 20 dakika açık kalır. Bu sürede SMS gelmezse ya da siz önce iptal ederseniz tutarın tamamı otomatik olarak cüzdanınıza döner; yani sessiz kalan bir numara size hiçbir şeye mal olmaz.

Kodlar sürekli başarısız olduğunda:

• Başarısız saymadan önce pencerenin dolmasını bekleyin; teslim süresi servise ve hatta bağlıdır.
• Servisin sanal numaraları hiç kabul edip etmediğini doğrulayın. Bazıları reddeder ve hiçbir yönlendirme tercihi bunu değiştirmez.
• Biraz sonra yeniden deneyin ya da testiniz bir Mısır numarasına bağlı değilse komşu bir hattı deneyin.
• Sıkı bir döngüyle yeniden sipariş vermekten kaçının. Siparişler arasında giderek büyüyen bir aralık bırakın ve her aktivasyon kimliğini günlüklerinizde tutun.

Başarısız OTP tesliminin azaltılması notlarımız yeniden deneme politikasını daha derinlemesine ele alır.

Ürün ekipleri neden Mısır numaralarıyla test yapar?

Mısır, Arapça konuşulan en büyük pazarlardan biridir; bu yüzden bir ürünü Arapçaya yerelleştiren ekipler için doğal bir ilk duraktır. Gerçek bir +20 numarası, emülatörlerin atladığı kısımları sınar: ülke seçiciyi, trunk sıfırının ele alınışını, Arapça SMS şablonlarını ve kod giriş ekranındaki sağdan sola yerleşimi.

Bölgesel operasyon ekipleri de bir sürümden sonra kayıt akışının Mısırlı müşteriler için hâlâ çalıştığını doğrulamak amacıyla OTP yönlendirmesini kullanır; yurt dışında yaşayan Mısırlılara hizmet eden şirketler ise bir +20 numarasının ülke dışında da kabul edildiğini kontrol eder.

Uzun vadeli bir Mısır hattı var mı, faturalama nasıl işler?

Mısır için kendi kendine alınabilen uzun vadeli bir numara yoktur. Dedicated hatlar yalnızca ABD ve Kanada ürünüdür ve $1.95/month'ten başlar; sürekli bir Mısır hattına ihtiyacınız varsa [email protected] adresine e-posta gönderin; ekip bunun yerel kurallar altında mümkün olup olmadığını söyleyebilir, ancak mümkün olacağına dair bir söz verilmez.

Faturalama, aylık ücreti ve seçilecek bir planı olmayan ön ödemeli bir USD cüzdanıdır. Bakiye kartla ya da USDT/USDC olarak yüklenir ve her yüklemeyi e-postayla bir PDF fatura izler. Entegrasyonu kurarken bir geliştirme hesabı için sandbox modunu isteyebilirsiniz; bu mod cüzdan bakiyesine dokunmadan simüle numaralar ve kodlar döndürür. Güncel fiyatlar fiyatlandırma sayfasındadır.

Sık sorulan sorular

Mısır SIM kartı olmadan uygulamamın Mısır kayıt OTP'sini kontrol edebilir miyim?

Evet. OTP Gateway'den bir +20 numarası sipariş edin, kayıt formunuza girin ve kodu panelde ya da API'den okuyun; yerel SIM gerekmez.

OTP Route API Mısır için hangi ülke kimliğini kullanır?

Mısır eg'dir. Bunu fiyat uç noktasına ve POST /api/v1/activations gövdesinde geçin.

SMS hiç gelmezse bir +20 numarası için ödeme yapar mıyım?

Hayır. 20 dakika içinde kod gelmezse ya da aktivasyonu iptal ederseniz tutarın tamamı otomatik olarak cüzdanınıza iade edilir.

Bir Mısır cep numarasını kaydederken baştaki sıfırı korumalı mıyım?

Hayır. 0 yurt içi bir trunk önekidir; onu atın ve numarayı +20 ile başlayan E.164 biçiminde saklayın.

Gelecek ay aynı Mısır test numarasıyla yeniden giriş yapabilir miyim?

Güvenilir biçimde hayır. Her OTP Gateway numarası tek bir doğrulama koduna hizmet eder ve kendi kendine alınan dedicated hatlar yalnızca ABD ve Kanada için vardır; tekrar giriş gerektiren hesapları buna göre planlayın.

Bir platformda çok sayıda hesap açmak için Mısır numaralarını kullanabilir miyim?

Hayır. OTP Route, kendi meşru hesaplarınızı ve ürünlerinizi test etmek ve işletmek içindir; her servisin şartlarına ve Kabul Edilebilir Kullanım Politikası'na uyun.

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.