Droga programisty do jordańskich (+962) kodów weryfikacyjnych

Jak wygląda sekwencja żądań dla numeru +962?

API weryfikacji SMS to zwykły REST pod adresem https://otproute.com/api/v1, z kluczami Bearer z prefiksem or_live_, które generujesz w konsoli Developer. Oto kolejność, jakiej trzyma się większość integracji dla Jordanii:

1. Odkrywanie: GET /api/v1/services i GET /api/v1/countries zwracają identyfikatory. Jordania to jo; usługa taka jak Telegram to telegram.
2. Sprawdzenie ceny: GET /api/v1/prices?country=jo&service=telegram zwraca, ile ta para kosztuje w tej chwili i czy można ją zamówić.
3. Zamówienie: POST /api/v1/activations z {"service": "telegram", "country": "jo"} rezerwuje numer i zwraca identyfikator aktywacji.
4. Odbiór: odpytuj GET /api/v1/activations/{id} co kilka sekund albo pozwól, by webhook przesłał Ci wynik.
5. Porządki: POST /api/v1/activations/{id}/cancel zwalnia aktywację, której już nie potrzebujesz, i zwraca środki.

GET /api/v1/balance przydaje się jako zabezpieczenie na początku przebiegu testów, aby zadanie kończyło się wcześnie z czytelnym komunikatem, gdy w portfelu brakuje środków. Pełna dokumentacja jest w docs.

Jak potwierdzić, że webhook naprawdę pochodzi z OTP Route?

Każde zdarzenie (na przykład activation.sms_received lub activation.expired) przychodzi z nagłówkiem X-OTPRoute-Signature w postaci t=<unix>,v1=<hex>. Twój serwer oblicza HMAC-SHA256 z "<t>.<raw body>" przy użyciu sekretu danego endpointu i porównuje wynik z v1. Odrzuć żądanie, jeśli wartości się różnią lub jeśli t jest zbyt odległe w przeszłości; to zapobiega powtórzeniom.

Ponieważ ponowienia mogą dostarczyć to samo zdarzenie dwukrotnie, opieraj przetwarzanie na identyfikatorze aktywacji i traktuj drugą kopię jako brak operacji. Odpytywanie nadal jest solidnym rozwiązaniem zapasowym w lokalnym developmencie, gdzie publiczny adres webhooka bywa kłopotliwy. Artykuł o przechwytywaniu OTP przez webhooki opisuje kolejkowanie i ponowienia.

Które aplikacje można zweryfikować na jordańskiej trasie?

Dla Jordanii wymienionych jest ponad 1700 usług. Do popularnych należą WhatsApp, Telegram, Facebook, Instagram, Snapchat, TikTok, X (Twitter), Discord, Claude, Microsoft & Outlook, Amazon, Viber, imo, Signal i LinkedIn.

Lista to migawka, a nie obietnica. Przepustowość operatorów zmienia się w ciągu dnia, więc API zwraca dostępność na żywo, a Twój kod powinien ją odczytać przed zamówieniem.

Formatowanie jordańskich numerów: zero prefiksu, E.164 i tekst arabski

Numer kierunkowy Jordanii to +962, a prefiks krajowy to 0. Lokalnie numer komórkowy zapisuje się, zaczynając od 07; w formie międzynarodowej zero znika, zostaje +962 i dziewięć cyfr zaczynających się od 7. Zapisuj formę E.164, a gdy użytkownicy wklejają numer lokalny, usuń początkowe 0 przed dodaniem numeru kierunkowego kraju. Porównywanie 07… z +9627… jako ciągów znaków to klasyczna przyczyna błędów dublowania kont.

Językiem urzędowym jest arabski i wiele osób ustawia w nim telefony i aplikacje. W zależności od aplikacji i ustawień języka konta kod może przyjść w arabskim lub angielskim tekście. Arabskie wiadomości są wysyłane w Unicode, a cyfry mogą znajdować się wewnątrz tekstu od prawej do lewej, więc wyodrębniaj kod za pomocą wzorca i testuj oba języki.

Zespoły pracują z Jordanią, gdy lokalizują produkt dla arabskojęzycznych użytkowników, prowadzą support z Ammanu dla szerszego regionu lub sprawdzają procesy równolegle z pobliskimi rynkami, takimi jak Arabia Saudyjska i Zjednoczone Emiraty Arabskie.

Zamawianie jordańskiego kodu z panelu

Pracownicy operacyjni mogą zrobić to samo bez pisania kodu. Załóż konto z e-mailem i sześciocyfrowym kodem lub logowaniem przez Google, doładuj środki, wybierz w OTP Gateway Jordanię i usługę, potwierdź wyświetloną cenę i złóż zamówienie. Numer +962 pojawia się od razu, a kod widać obok niego, gdy SMS dotrze.

Aktywacja jest otwarta przez 20 minut. Płacisz tylko wtedy, gdy kod dotrze; jeśli okno zamknie się puste lub anulujesz, kwota wraca automatycznie do portfela.

Kolejność debugowania, gdy kody nie docierają

Zacznij od najprostszego wyjaśnienia i idź coraz dalej:

• Czy okno nadal jest otwarte? Dostarczenie zależy od usługi i trasy. Pozwól, by minęło pełne 20 minut, zanim uznasz próbę za nieudaną.
• Czy usługa akceptuje numery wirtualne? Niektóre nie, i dlatego niewykorzystane aktywacje są zwracane.
• Spróbuj innej trasy. Zamów ponownie później albo użyj innej trasy usługi dla tej samej funkcji, jeśli Twój produkt na to pozwala.
• Ogranicz ponowienia. Pętla, która zamawia ponownie co kilka sekund, głównie marnuje próby; rozstaw je w czasie.

Testuj tylko konta, które posiadasz lub obsługujesz, przestrzegaj zasad każdej usługi i pamiętaj, że Zasady dopuszczalnego użytkowania OTP Route obejmują całe korzystanie.

Linie długoterminowe, portfel i sandbox

OTP Route nie ma samoobsługowego numeru długoterminowego w Jordanii. Numery dedykowane, od $1.95/month, są oferowane natychmiast tylko w USA i Kanadzie. Jeśli Twój zespół potrzebuje trwałej linii +962, napisz na [email protected]; to, czy da się ją zorganizować, zależy od lokalnych przepisów.

Portfel jest przedpłacony w USD, bez opłaty miesięcznej i bez planu do wyboru. Doładowuj kartą lub USDT/USDC i otrzymuj e-mailem fakturę PDF po każdym doładowaniu. Podczas integracji poproś o tryb sandbox na koncie deweloperskim, aby otrzymywać symulowane numery i kody bez wydawania środków. Aktualne stawki znajdziesz w cenniku.

Najczęstsze pytania

Jaki jest kod kraju w API dla Jordanii?

Użyj jo jako wartości country w API OTP Route, na przykład w GET /api/v1/prices?country=jo&service=whatsapp.

Czy usuwać 0 z jordańskiego numeru komórkowego?

Tak, w formacie międzynarodowym. Lokalny numer 07 staje się +962 i dziewięcioma cyframi zaczynającymi się od 7.

Czy jordański kod weryfikacyjny przyjdzie po arabsku?

Może. Język zwykle zależy od aplikacji i ustawień konta, więc wyodrębniaj cyfry wzorcem i testuj wiadomości zarówno po arabsku, jak i po angielsku.

Jak długo numer +962 jest trzymany na mój kod?

Każda aktywacja trwa 20 minut. Jeśli w tym czasie nie dotrze żaden SMS, opłata wraca do portfela.

Czy mogę dostać dedykowany numer jordański, który zachowam?

Nie w modelu samoobsługowym. Numery dedykowane to produkt dla USA i Kanady; w sprawie Jordanii możesz napisać na [email protected].

Czy można odbierać jordańskie SMS-y OTP w testach automatycznych?

Tak. Zamów przez POST /api/v1/activations, a potem odpytuj aktywację lub obsłuż podpisany webhook; konto sandbox pozwala przećwiczyć to na symulowanych kodach.

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.