Samoa OTP API: testowanie rejestracji na +685 na Pacyfiku

Samoa w pigułce dla zespołów produktowych i QA

Samoa to niepodległe państwo na Pacyfiku, w którym urzędowymi językami są samoański i angielski. Duża społeczność samoańska mieszka w Nowej Zelandii, Australii i Stanach Zjednoczonych, dlatego aplikacje do przelewów, komunikatory i aplikacje podróżnicze muszą często działać dla użytkowników przemieszczających się między tymi krajami a domem.

Warto znać dwie osobliwości. Po pierwsze, Samoa (+685) to inny kraj niż Samoa Amerykańskie, które należy do północnoamerykańskiego planu numeracyjnego pod prefiksem +1 684; pomylenie ich w selektorze kraju sprawia, że kody trafiają w niewłaściwe miejsce. Po drugie, w 2011 roku Samoa przeniosło się na zachodnią stronę międzynarodowej linii zmiany daty i ma zegar daleko przed UTC, co czyni je wygodnym przypadkiem do testowania granic dat w logice wygasania kodów.

Dla zespołu produktowego Samoa rzadko bywa samodzielnym rynkiem startowym. Pojawia się zwykle w ramach wdrożenia na Pacyfiku, jako wymóg aplikacji skierowanej do diaspory albo dlatego, że organizacja partnerska w Apii potrzebuje potwierdzenia konta firmowego. W każdym przypadku zadanie jest to samo: udowodnić, że użytkownik z numerem +685 może ukończyć Twój proces rejestracji.

Jak obsługiwać numer +685 w kodzie?

Samoańskie numery krajowe są krótkie w porównaniu z większością rynków, więc walidatory dostrojone do numerów dziewięcio- lub dziesięciocyfrowych mogą odrzucić prawdziwy numer. Zapisuj numery jako +685 plus cyfry krajowe bez separatorów i usuwaj zero, które użytkownik dodaje z przyzwyczajenia. Ponieważ znaczniki czasu webhooków są w sekundach Unix, porównuj je w UTC, a nie w czasie lokalnym; unikniesz niespodzianek, gdy Twój serwer i tester z Samoa znajdują się w różnych dniach kalendarzowych.

Jeśli Twój produkt pozwala użytkownikom przełączać się między numerem nowozelandzkim a samoańskim w tym samym profilu, dodaj test, który zmienia kod kraju i sprawdza, czy poprzedni stan weryfikacji jest czyszczony, tak aby kod wysłany na jeden numer nigdy nie został zaakceptowany dla drugiego.

Które usługi są dostępne na trasach Samoa?

Katalog Samoa obejmuje obecnie ponad 600 usług. Do często wybieranych należą WhatsApp, Facebook, Instagram, Telegram, Google (Gmail & YouTube), Viber, Signal, TikTok, Microsoft & Outlook, Amazon i Discord. Pokrycie jest tu skromniejsze niż na dużych rynkach i zmienia się w ciągu dnia, więc przed każdym uruchomieniem sprawdzaj GET /api/v1/services i GET /api/v1/countries. Jeśli usługi brakuje, test może się powieść na sąsiedniej trasie, takiej jak Fidżi lub Tonga.

Mniejszy katalog to dobry powód, by zbudować tolerancyjne środowisko testowe: jeśli preferowanej usługi brakuje w momencie uruchomienia, oznacz przypadek jako pominięty, a nie nieudany, i zapisz to, aby ktoś mógł spróbować później.

Zamawianie kodu z Samoa przez API

Mając klucz Bearer (or_live_…) i adres https://otproute.com/api/v1, sprawdź cenę przez GET /api/v1/prices?country=ws&service=<id>, a następnie wyślij {"service": "<id>", "country": "ws"} do POST /api/v1/activations. Śledź identyfikator aktywacji, odpytując GET /api/v1/activations/{id} albo nasłuchując zdarzenia activation.sms_received. Weryfikuj podpis HMAC X-OTPRoute-Signature przy każdym webhooku, odrzucaj przestarzałe znaczniki czasu i spraw, by obsługa była bezpieczna przy dwukrotnym uruchomieniu dla tej samej aktywacji. Pełny schemat pokazuje przewodnik integracji.

Limity są hojne jak na rynek tej wielkości: każde konto ma do 10 kluczy, 5 endpointów webhook i 300 żądań na minutę. Jeśli odpytujesz API, kilka sekund przerwy między sprawdzeniami w zupełności wystarczy.

Ręcznie, w panelu

1. Zaloguj się i otwórz OTP Gateway.
2. Wybierz usługę, a potem Samoa.
3. Sprawdź aktualną cenę i potwierdź.
4. Wklej numer +685 do testowanej aplikacji i poproś o kod.
5. Odczytaj kod na ekranie albo anuluj, jeśli już go nie potrzebujesz.

Gdy kod +685 jest spóźniony lub nie przychodzi

Zostaw aktywację otwartą przez pełne 20 minut, zanim się poddasz. Niektóre aplikacje w ogóle odrzucają numery wirtualne, i właśnie dlatego zamówienia bez odpowiedzi są zwracane. Jeśli trasa milczy, spróbuj później albo wybierz inną trasę usługi; składanie nowych zamówień w szybkiej pętli rzadko pomaga, a zużywa limit żądań.

Zapisuj identyfikator aktywacji przy każdej próbie, aby widzieć, czy milczenie dotyczyło jednej konkretnej aplikacji, czy całej trasy.

Numery długoterminowe i płatności za użycie

OTP Route nie sprzedaje samoobsługowego długoterminowego numeru samoańskiego. Numery dedykowane zaczynają się od $1.95/miesiąc i są dostępne wyłącznie w Stanach Zjednoczonych i Kanadzie; w sprawie linii z Samoa napisz na [email protected], bez obietnicy, że uda się ją zorganizować. Przedpłacony portfel w USD przyjmuje karty oraz USDT/USDC, wysyła fakturę PDF po każdym doładowaniu i nie ma opłaty miesięcznej. Poproś o tryb sandbox dla konta deweloperskiego, by przećwiczyć przepływ ws bez wydawania środków.

Najczęstsze pytania

Czy Samoa to to samo co Samoa Amerykańskie, jeśli chodzi o numery telefonów?

Nie. Samoa używa prefiksu +685, a Samoa Amerykańskie +1 684. Wybierz właściwy kraj w selektorze i w API.

Jaki jest identyfikator kraju w API dla Samoa?

Użyj ws w zapytaniu o ceny i w żądaniu aktywacji.

Ile kosztuje kod weryfikacyjny z Samoa?

Od $0.20 za kod; dokładna cena zależy od usługi i jest pokazywana przed zamówieniem.

Czy mogę testować rejestrację samoańskiego użytkownika z Nowej Zelandii lub Australii?

Tak. Numer +685 odbiera SMS, a OTP Route pokazuje go Tobie, gdziekolwiek pracuje Twój zespół.

Czy płacę, gdy wiadomość nie dotrze?

Nie. Aktywacje wygasłe lub anulowane są automatycznie zwracane do portfela.

W jakich językach przychodzą kody z Samoa?

Zwykle po angielsku, który jest językiem urzędowym obok samoańskiego. Analizuj cyfry, a nie otaczający je tekst.

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

Nie. Przestrzegaj regulaminu każdej usługi; Zasady Dopuszczalnego Użytkowania ograniczają OTP Route do testowania i obsługi własnych, legalnych kont i produktów.

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.