Podłączenie egipskiego (+20) przepływu weryfikacji SMS do API OTP Route

Jakich żądań faktycznie potrzebuje integracja z Egypt OTP API?

Wszystko obsługuje siedem endpointów, wszystkie pod https://otproute.com/api/v1 i wszystkie uwierzytelniane kluczem Bearer z prefiksem or_live_. Wygeneruj po jednym kluczu na środowisko w konsoli deweloperskiej; konto może mieć ich do 10.

1. Wczytaj katalog przez GET /api/v1/services i GET /api/v1/countries. Identyfikator kraju dla Egiptu to eg i rzadko się zmienia, więc buforowanie go jest w porządku.
2. Przed każdym zamówieniem zapytaj GET /api/v1/prices?country=eg&service=<id> o aktualną cenę i dostępność. Zasoby zmieniają się w ciągu dnia, więc traktuj tę odpowiedź jako świeże dane, a nie konfigurację.
3. Utwórz aktywację przez POST /api/v1/activations z treścią w rodzaju {"service": "whatsapp", "country": "eg"}. W odpowiedzi dostajesz identyfikator aktywacji i numer +20 do wpisania na testowanym ekranie.
4. Odbierz kod z webhooka albo wywołując GET /api/v1/activations/{id}.
5. Jeśli test zostanie przerwany, zwolnij zamówienie przez POST /api/v1/activations/{id}/cancel, aby środki wróciły od razu.

Krótkie GET /api/v1/balance na początku każdego zestawu testów pozwala zadaniu CI zatrzymać się wcześnie, zamiast zawieść w połowie. Limit to 300 żądań na minutę na konto, co zostawia miejsce na równoległe odpytywanie kilku aktywacji. Pełne przykłady żądań są w dokumentacji dla deweloperów.

Jak odbierać kody +20 z podpisanego webhooka zamiast odpytywać?

Odpytywanie sprawdza się przy pojedynczym teście lokalnym; webhook lepiej pasuje, gdy pipeline uruchamia naraz wiele egipskich aktywacji. Dodaj endpoint w konsoli deweloperskiej (pięć na konto) i zasubskrybuj activation.sms_received, a także activation.expired i activation.cancelled, aby zadanie wiedziało, kiedy przestać czekać.

Każde żądanie niesie X-OTPRoute-Signature: t=<unix>,v1=<hex>. Odtwórz ciąg <t>.<raw body>, oblicz HMAC-SHA256 z sekretem endpointu i porównaj z v1 kontrolą w stałym czasie. Odrzuć wszystko ze starym znacznikiem czasu i hashuj bajty dokładnie tak, jak je odebrano, a nie sparsowany i ponownie zakodowany obiekt.

Traktuj identyfikator aktywacji jako klucz idempotencji: zapisz zdarzenie raz, ignoruj powtórzenia i szybko zwracaj 2xx. Przewodnik o przechwytywaniu OTP przez webhook omawia wersję tego handlera opartą na kolejce.

Jakie usługi mogą dostarczać kody na egipski numer weryfikacyjny?

Aktualne zestawienie dla Egiptu wymienia łącznie ponad 1 600 usług. Popularne, które zespoły testują na numerach +20, to WhatsApp, Facebook, Instagram, TikTok, Telegram, Google (Gmail & YouTube), Microsoft & Outlook, Uber, Snapchat, Viber, imo, ChatGPT (OpenAI), Amazon i LinkedIn.

Ta lista to widok z konkretnej chwili, a nie obietnica. Usługa, która rano ma numery, po południu może ich mieć niewiele, dlatego endpoint cen zwraca dostępność obok kosztu. Niektóre usługi w ogóle odrzucają numery wirtualne; wtedy chroni Cię opisana niżej reguła zwrotu.

Jak aplikacja ma przechowywać i walidować egipskie numery komórkowe?

Egipt używa kodu kraju +20 i krajowego prefiksu międzymiastowego 0. Lokalnie numer komórkowy zapisuje się jedenastoma cyframi zaczynającymi się od 01, natomiast w formie międzynarodowej zero znika i po +20 następuje dziesięć cyfr. Kilka nawyków pozwala uniknąć większości błędów:

• Zapisuj wyłącznie E.164, np. +201XXXXXXXXX, a formatuj do wyświetlania dopiero przy renderowaniu.
• Usuwaj krajowe zero, gdy użytkownik wpisuje 01…, a kraj jest już ustawiony na Egipt; w przeciwnym razie powstanie niepoprawna wartość +2001….
• Normalizuj cyfry. Osoby na arabskich klawiaturach mogą wpisywać cyfry arabsko-indyjskie, więc zamień je na cyfry ASCII przed walidacją i przed porównaniem wpisanego OTP.

Arabski jest językiem urzędowym, więc wiele usług wysyła egipskim użytkownikom kody po arabsku, a inne domyślnie po angielsku. Jeśli parser wyciąga kod wyrażeniem regularnym, przetestuj go zarówno na treściach pisanych od prawej do lewej, jak i angielskich.

Czy zespół operacyjny może zamówić egipski numer bez pisania kodu?

Tak. Nie każda kontrola wymaga skryptu, a koledzy ze wsparcia czy wzrostu mogą używać tego samego OTP Gateway z przeglądarki:

1. Zarejestruj się przez e-mail i 6-cyfrowy kod albo przez Google.
2. Doładuj portfel i otwórz OTP Gateway.
3. Wybierz Egipt i usługę; cena pokazuje się przed potwierdzeniem.
4. Skopiuj numer +20 do aplikacji i poczekaj, aż kod pojawi się na ekranie.

Aktywacja jest identyczna jak zamówienie przez API, więc kontrola ręczna i automatyczna zachowują się tak samo.

Co zrobić, jeśli kod +20 się nie pojawi?

Każda aktywacja pozostaje otwarta przez 20 minut. Jeśli w tym czasie nie dotrze żaden SMS albo wcześniej anulujesz, cała kwota wraca automatycznie do portfela, więc cichy numer nigdy nic Cię nie kosztuje.

Gdy kody wciąż zawodzą:

• Poczekaj do końca okna, zanim uznasz próbę za nieudaną; czas dostarczenia zależy od usługi i trasy.
• Sprawdź, czy usługa w ogóle akceptuje numery wirtualne. Niektóre ich nie przyjmują i żaden wybór routingu tego nie zmieni.
• Spróbuj nieco później albo przez sąsiednią trasę, jeśli test nie zależy od egipskiego numeru.
• Unikaj ponownego zamawiania w ciasnej pętli. Zostawiaj rosnący odstęp między zamówieniami i zapisuj w logach każdy identyfikator aktywacji.

Nasze uwagi o ograniczaniu nieudanych dostaw OTP szerzej omawiają politykę ponowień.

Dlaczego zespoły produktowe testują na egipskich numerach?

Egipt to jeden z największych rynków arabskojęzycznych, więc naturalnie jest pierwszym przystankiem dla zespołów lokalizujących produkt na arabski. Prawdziwy numer +20 sprawdza to, co pomijają emulatory: selektor kraju, obsługę krajowego zera, arabskie szablony SMS i układ od prawej do lewej na ekranie wpisywania kodu.

Regionalne zespoły operacyjne używają też routingu OTP, by upewnić się, że po wydaniu nowej wersji rejestracja nadal działa dla egipskich klientów, a firmy obsługujące Egipcjan mieszkających za granicą sprawdzają, czy numer +20 jest akceptowany także poza krajem.

Czy istnieje długoterminowa linia egipska i jak działa rozliczanie?

Dla Egiptu nie ma numeru długoterminowego w samoobsłudze. Linie dedykowane to produkt wyłącznie dla Stanów Zjednoczonych i Kanady, od $1.95/month; jeśli potrzebujesz stałej linii egipskiej, napisz na [email protected], a zespół powie, czy jest to możliwe w świetle lokalnych przepisów, bez obietnicy, że tak.

Rozliczenia opierają się na przedpłaconym portfelu w USD, bez opłaty miesięcznej i bez wyboru planu. Środki wpłacisz kartą lub jako USDT/USDC, a po każdym doładowaniu przychodzi faktura PDF e-mailem. Podczas budowania integracji możesz poprosić o tryb sandbox dla konta deweloperskiego, który zwraca symulowane numery i kody bez ruszania środków w portfelu. Aktualne stawki są na stronie cennika.

Najczęstsze pytania

Czy mogę sprawdzić OTP rejestracji w mojej aplikacji dla Egiptu bez egipskiej karty SIM?

Tak. Zamów numer +20 w OTP Gateway, wpisz go w formularzu rejestracji i odczytaj kod w panelu lub przez API — wszystko bez lokalnej karty SIM.

Jakiego identyfikatora kraju używa API OTP Route dla Egiptu?

Egipt to eg. Przekaż go do endpointu cen oraz w treści POST /api/v1/activations.

Czy płacę za numer +20, jeśli SMS nie dotrze?

Nie. Jeśli w ciągu 20 minut nie nadejdzie kod albo anulujesz aktywację, cała kwota wraca automatycznie do portfela.

Czy zapisując egipski numer komórkowy, zachować początkowe zero?

Nie. 0 to krajowy prefiks międzymiastowy; pomiń go i zapisz numer w E.164, zaczynając od +20.

Czy za miesiąc mogę zalogować się ponownie tym samym egipskim numerem testowym?

Niezawodnie nie. Każdy numer OTP Gateway obsługuje jeden kod weryfikacyjny, a samoobsługowe linie dedykowane istnieją tylko dla USA i Kanady, więc konta wymagające powtarzanych logowań zaplanuj z tym na uwadze.

Czy mogę używać egipskich numerów do zakładania wielu kont na platformie?

Nie. OTP Route służy do testowania i prowadzenia własnych, legalnych kont i produktów; przestrzegaj regulaminu każdej usługi i Acceptable Use Policy.

Nazwy usług są znakami towarowymi ich właścicieli. OTP Route nie jest z nimi powiązany. Korzystaj z numerów zgodnie z prawem oraz przestrzegaj regulaminów poszczególnych usług i naszej Polityki akceptowalnego użytkowania.