Numery weryfikacyjne z Aruby: jak wprowadzić kody +297 do swoich testów

Co inżynierowie powinni wiedzieć o numeracji +297 na Arubie?

Aruba jest krajem wchodzącym w skład Królestwa Niderlandów i ma własny numer kierunkowy +297, odrębny od holenderskiego zakresu +31. Numery abonenckie mają siedem cyfr i nie ma prefiksu krajowego, więc to, co miejscowa osoba wpisuje w formularzu, jest już pełnym numerem krajowym.

Ta prostota kryje klasyczny błąd walidacji. Wiele formularzy rejestracji wymaga minimum ośmiu lub dziesięciu cyfr, bo zespół testował tylko większe rynki, i użytkownik z Aruby trafia na błąd, zanim zostanie wysłany jakikolwiek kod. Kilka zasad utrzymuje porządek:

• Zapisuj każdy numer w E.164, na przykład +2975XXXXXX, bez spacji i znaków interpunkcyjnych.
• Na wejściu usuwaj spacje, myślniki i początkowe 00, a potem dopisz +297, jeśli użytkownik wybrał Arubę z menu krajów.
• Nigdy nie dodawaj 0; Aruba nie ma cyfry krajowej do przywrócenia.
• Pozwól ocenić poprawność utrzymywanej bibliotece numerów telefonów, zamiast pisać własne sprawdzanie długości.

Prawdziwy numer +297 do testów to najszybszy sposób, by udowodnić, że formularz, kolumna w bazie i nadawca SMS-ów zgadzają się co do tego siedmiocyfrowego kształtu.

Dlaczego zespół miałby w ogóle prowadzić QA na numerze z Aruby?

Wyspa żyje z turystyki, więc produkty, którym najbardziej zależy, to silniki rezerwacji, aplikacje do wynajmu i przejazdów, oprogramowanie dla hotelarstwa, fintech podróżniczy i programy lojalnościowe. Zespoły rozwijające się na holenderskich Karaibach często uruchamiają jednocześnie Arubę, Curaçao i Sint Maarten i chcą jednego zestawu testów regresji obejmującego wszystkie trzy kody kierunkowe.

Znaczenie ma też język. Językami urzędowymi są niderlandzki i papiamento, a angielski i hiszpański słychać wszędzie w sklepach i hotelach. Globalne usługi zwykle wysyłają kody po angielsku lub w języku konta, więc Twój parser powinien wyciągać cyfry wzorcem, a nie dopasowywać stałe zdanie. Jeśli Twój interfejs oferuje teksty po niderlandzku lub w papiamento, numer weryfikacyjny z Aruby pozwala QA sprawdzić całą zlokalizowaną ścieżkę, od etykiety pola telefonu po ekran wpisywania kodu.

Które usługi mogą dostarczyć kod na numer +297?

Bieżący zrzut dla Aruby wymienia popularne trasy, takie jak WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, ChatGPT (OpenAI), Microsoft & Outlook, Amazon, Discord, Uber, Airbnb, Signal i LinkedIn. W sumie OTP Gateway obsługuje dla tego kraju ponad 600 usług.

Dostępność zmienia się w ciągu dnia, gdy nasi partnerzy operatorscy rotują zasoby, dlatego OTP Route udostępnia ją na żywo, a nie w statycznej tabeli. Odpytuj katalog przed każdym uruchomieniem zamiast na sztywno wpisywać listę usług w fixture'ach.

Jak wygląda żądanie API OTP dla Aruby od początku do końca?

Uwierzytelniaj się kluczem Bearer zaczynającym się od or_live_; konsola deweloperska pozwala mieć do 10 kluczy i 5 endpointów webhooków, przy pułapie 300 żądań na minutę. Bazowy adres URL to https://otproute.com/api/v1.

1. Wywołaj raz GET /api/v1/countries i GET /api/v1/services, aby zapisać identyfikatory. Aruba to aw.
2. Odczytaj aktualną cenę przez GET /api/v1/prices?country=aw&service=airbnb, aby zadanie mogło zapisać koszt przed zatwierdzeniem.
3. Utwórz zamówienie przez POST /api/v1/activations z treścią JSON {"service": "airbnb", "country": "aw"}. Odpowiedź zawiera identyfikator aktywacji i numer +297 do wpisania w testowanej aplikacji.
4. Pozwól nasłuchiwaczowi webhooka przechwycić activation.sms_received dla tego zamówienia; zadanie bez publicznego endpointu może zamiast tego sprawdzać GET /api/v1/activations/{id} co kilka sekund.
5. Jeśli test zostanie przerwany, zwolnij zamówienie przez POST /api/v1/activations/{id}/cancel.

Każdy webhook niesie X-OTPRoute-Signature: t=<unix>,v1=<hex>. Oblicz ponownie HMAC-SHA256 z <t>.<raw body> sekretem endpointu, porównaj w stałym czasie i odrzucaj żądania z nieaktualnym znacznikiem czasu. Przewodnik po przechwytywaniu przez webhooki omawia pełny handler, a dokumentacja API wymienia każde pole tego API weryfikacji SMS.

Czy ktoś bez kodu może zamówić numer z Aruby?

Tak. Pracownicy supportu i product managerowie mogą zrobić to samo z poziomu przeglądarki:

1. Zaloguj się i otwórz stronę OTP Gateway w panelu.
2. Wybierz Arubę jako kraj i usługę, którą sprawdzasz.
3. Potwierdź wyświetloną cenę, a potem skopiuj pojawiający się numer +297.
4. Wpisz go w aplikacji i poproś o kod; SMS pojawi się na karcie zamówienia, gdy dotrze.

Każdy numer obsługuje jeden kod weryfikacyjny dla jednej usługi, więc przy każdym oddzielnym sprawdzeniu rozpoczynaj nowe zamówienie.

Co zrobić, jeśli kod nie dotrze na numer z Aruby?

Każde zamówienie pozostaje otwarte przez 20 minut. Gdy w tym czasie nie nadejdzie żaden SMS albo wcześniej anulujesz, cała kwota sama wraca do portfela; płacisz tylko wtedy, gdy kod naprawdę dotrze. Szybkość dostarczania zależy od usługi i trasy, więc zostaw okno otwarte zamiast rezygnować po minucie.

Jeśli trasa wciąż wraca pusta:

• Spróbuj później, gdy zasoby się zrotują, albo wybierz inną trasę usługi dla tego samego przepływu.
• Sprawdź, czy usługa odrzuca numery wirtualne; niektóre tak robią i właśnie dlatego istnieje zwrot.
• Rozłóż ponowienia w czasie zamiast ponownie zamawiać w ciasnej pętli z CI.

Więcej pomysłów znajdziesz w naszej notatce o ograniczaniu nieudanych dostaw OTP.

Czy istnieje długoterminowa linia +297 i jak wygląda rozliczanie?

Dla Aruby nie ma samoobsługowego numeru długoterminowego. Numery dedykowane to produkt dla Stanów Zjednoczonych i Kanady, od $1.95/month; jeśli Twoje operacje naprawdę potrzebują linii z Aruby, napisz na [email protected], a zespół sprawdzi, na co pozwalają lokalne przepisy, bez obietnicy, że uda się to załatwić.

Cała reszta działa na jednym przedpłaconym portfelu w USD, bez opłaty miesięcznej i bez wyboru planu. Finansowanie odbywa się kartą lub stablecoinami USDT/USDC, a po każdym doładowaniu przychodzi e-mailem faktura PDF. W trakcie budowania konto deweloperskie można na prośbę przełączyć w tryb sandbox, aby symulowane numery i kody przećwiczyły Twoją logikę routingu OTP bez ruszania środków z portfela. Aktualne stawki są na stronie z cennikiem. Używaj usługi tylko do własnych produktów i kont, przestrzegaj regulaminu każdej aplikacji i pamiętaj, że obowiązuje Regulamin dopuszczalnego użytkowania OTP Route.

Najczęstsze pytania

Czy mogę przetestować rejestrację w mojej aplikacji hotelowej na numer z Aruby bez karty SIM z wyspy?

Tak. Zamów numer z Aruby w OTP Gateway, wpisz go w aplikacji i odczytaj kod w panelu lub z webhooka.

Jaki jest identyfikator Aruby w API OTP Route?

Użyj aw w każdym żądaniu, na przykład GET /api/v1/prices?country=aw&service=whatsapp.

Czy do numerów z Aruby dodawać początkowe zero?

Nie. Aruba nie ma prefiksu krajowego, więc zapisana postać to po prostu +297 i siedem cyfr.

Ile kosztuje odebranie SMS-a OTP z Aruby?

Trasy z Aruby są wyceniane od $0.20 za kod, a stawka dla każdej usługi jest ustalana na żywo. Dokładną kwotę zwraca GET /api/v1/prices i pokazuje panel przed potwierdzeniem.

Czy jeden numer +297 może odebrać drugi kod logowania w przyszłym tygodniu?

Nie. Numer z bramki obsługuje jeden kod weryfikacyjny. Konta, które muszą zalogować się ponownie później, lepiej pasują do numeru dedykowanego z USA lub Kanady.

Czy OTP Route pomoże nam otworzyć dużo kont na platformie?

Nie. Służy do testowania własnych przepływów weryfikacji i prowadzenia własnych, legalnych kont, a obowiązują regulaminy platform oraz nasz Regulamin dopuszczalnego użytkowania.

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.