Jednorazowy czy długoterminowy? Wybór trasy +1 787 do testów weryfikacji

Czy projekt dla Portoryko powinien używać OTP Gateway, czy numeru dedykowanego?

Zacznij od tego, jak długo numer ma żyć. OTP Gateway wydaje numer +1 787 na dokładnie jeden kod, co sprawdza się przy teście rejestracji, kontroli lokalizacji lub zadaniu CI, które weryfikuje raz i idzie dalej. Numer dedykowany to linia, którą zachowujesz, odpowiednia dla konta stagingowego, które musi zalogować się ponownie za tydzień, albo dla współdzielonej skrzynki wsparcia.

W przypadku Portoryko wybór jest w praktyce przesądzony. Choć wyspa jest terytorium USA, jej numery nie wchodzą w skład samoobsługowej puli numerów dedykowanych; ten produkt obejmuje Stany Zjednoczone i Kanadę, od $1.95/month. Jeśli dla konta cyklicznego wystarczy numer z kontynentalnych USA, strona o numerach wirtualnych wyjaśnia dostępne opcje. Jeśli potrzebujesz konkretnie portorykańskiej linii długoterminowej, napisz na [email protected]; to, czy da się ją zorganizować, zależy od lokalnych przepisów i nie jest gwarantowane.

Które wywołania Puerto Rico OTP API tworzą i odczytują aktywację?

API działa pod adresem https://otproute.com/api/v1 i wymaga kluczy Bearer z prefiksem or_live_. Identyfikator kraju dla Portoryko to pr.

1. Pobierz identyfikatory przez GET /api/v1/services i GET /api/v1/countries i zapisz je w pamięci podręcznej na czas wdrożenia.
2. Sprawdź cenę: GET /api/v1/prices?country=pr&service=<id> zwraca aktualną kwotę i pokazuje, czy trasa jest otwarta.
3. Złóż zamówienie przez POST /api/v1/activations z ciałem {"service": "<id>", "country": "pr"}.
4. Wstaw zwrócony numer do testowanego przepływu.
5. Odbierz kod przez activation.sms_received na swoim webhooku albo odpytuj GET /api/v1/activations/{id}.
6. Anuluj przez POST /api/v1/activations/{id}/cancel, jeśli zadanie zakończy się wcześniej.

Wywołania webhooka zawierają X-OTPRoute-Signature: t=<unix>,v1=<hex>. Oblicz ponownie HMAC-SHA256 z <t>.<raw body> z sekretem endpointu, porównaj w stałym czasie, odrzucaj stare znaczniki czasu i ignoruj powtórzone zdarzenia dla identyfikatora aktywacji, który już obsłużyłeś. Każde konto ma 10 kluczy, 5 endpointów webhook i 300 żądań na minutę. Poradnik integracji API OTP wchodzi w szczegóły.

Co sprawia, że numery +1 787 i +1 939 bywają kłopotliwe w formularzach?

Portoryko należy do Północnoamerykańskiego Planu Numeracji, więc jego numery wyglądają jak każdy numer amerykański: kod kraju 1, trzycyfrowy numer kierunkowy (787 lub nakładka 939) i siedem cyfr, zapisywane w E.164 jako +1787 lub +1939 plus siedem cyfr.

To podobieństwo powoduje realne błędy. Niektóre aplikacje traktują Portoryko jako odrębny kraj z kodem ISO PR, inne włączają je do Stanów Zjednoczonych, a formularze adresowe mogą oczekiwać PR jako wartości stanu. Sprawdź, czy lista krajów, walidator telefonu i pola adresu są ze sobą zgodne oraz czy użytkownik wybierający Portoryko nigdy nie usłyszy, że jego numer +1 jest nieprawidłowy. Zapisuj numery w E.164, a region wyznaczaj na podstawie numeru kierunkowego, a nie początkowego +1.

Które usługi mogą odbierać kody SMS OTP z Portoryko?

Trasa portorykańska obsługuje obecnie ponad 900 usług. Popularni nadawcy to WhatsApp, Uber, Google (Gmail & YouTube), Facebook, Instagram, TikTok, X (Twitter), Amazon, ChatGPT (OpenAI), Microsoft & Outlook, LinkedIn, Discord, Airbnb, Netflix i Telegram. Dostępność zmienia się w ciągu dnia, więc w chwili zamówienia ufaj odpowiedzi API, a nie żadnej liście.

Bez kodu: otwórz w panelu OTP Gateway, wybierz Portoryko i usługę, potwierdź wyświetlaną cenę i złóż zamówienie. Portorykański numer weryfikacyjny pojawi się z odliczaniem, a kod zostanie wyświetlony obok niego, gdy dotrze SMS.

Co zrobić, jeśli kod nie pojawi się w ciągu 20 minut?

Każda aktywacja trwa 20 minut, a płacisz tylko wtedy, gdy kod dotrze. Jeśli okno wygaśnie puste albo anulujesz zamówienie, pełna kwota wraca do portfela automatycznie.

Jeśli portorykańskie kody nie przychodzą:

• Daj aktywacji pełne okno, zanim oznaczysz test jako nieudany.
• Spróbuj ponownie nieco później albo wybierz inną trasę usługi.
• Sprawdź, czy usługa akceptuje numery wirtualne; niektóre je odrzucają, a zwrot środków właśnie to amortyzuje.
• Nie wysyłaj nowych zamówień w ciasnej pętli; dodaj wykładnicze opóźnienie między próbami.

Szersze wzorce znajdziesz w artykule o ograniczaniu nieudanych dostarczeń OTP.

Dlaczego zespoły weryfikują przepływy po hiszpańsku i angielsku dla Portoryko?

Hiszpański i angielski są językami urzędowymi, a hiszpański jest językiem, którego większość mieszkańców używa na co dzień. To czyni Portoryko praktycznym miejscem do sprawdzania dwujęzycznego onboardingu: czy SMS weryfikacyjny przychodzi po hiszpańsku, gdy aplikacja ma ustawiony hiszpański, czy ekran wpisywania kodu radzi sobie z tekstem z akcentami i czy wychodzi właściwy szablon, gdy użytkownik zmieni język w trakcie przepływu? Na wyspie obowiązuje dolar amerykański, a wiele firm z USA już ją obsługuje, więc aplikacje płatnicze, platformy dostaw, marketplace'y i banki rozszerzające wdrożenie z USA często potrzebują numeru +1 787 do testów. Wykonuj te kontrole na kontach, które kontrolujesz, przestrzegaj regulaminów każdej usługi i trzymaj się Polityki Dopuszczalnego Użytkowania OTP Route. Aby je zautomatyzować, zobacz testy CI/CD.

Jak działają portfel i sandbox przy testach dla Portoryko?

Nie ma subskrypcji. Jeden przedpłacony portfel w USD finansuje wszystkie zamówienia, bez opłaty miesięcznej i bez wyboru planu. Doładowujesz kartą lub USDT/USDC, a faktura PDF przychodzi e-mailem za każde doładowanie i zakup numeru. Zanim przejdziesz na produkcję, poproś o przełączenie konta deweloperskiego w tryb sandbox, który zwraca symulowane numery i kody, dzięki czemu cały przepływ routingu OTP można przećwiczyć bez wydawania środków. Gdy będziesz gotowy, załóż konto za pomocą e-maila i 6-cyfrowego kodu lub logowania przez Google, a dla zespołu włącz uwierzytelnianie dwuskładnikowe TOTP.

Najczęstsze pytania

Czy mogę przetestować rejestrację w Portoryko bez lokalnej karty SIM?

Tak. Zamów numer +1 787 z OTP Gateway, wpisz go w aplikacji i odbierz kod w panelu albo przez API weryfikacji SMS i webhooki.

Czy Portoryko jest w API traktowane jak Stany Zjednoczone?

Nie. Ma własny identyfikator kraju, pr, którego używasz w zapytaniach o ceny i żądaniach aktywacji zamiast identyfikatora USA.

Czy mogę kupić numer dedykowany +1 787?

Nie z poziomu panelu. Samoobsługowe numery dedykowane obejmują tylko Stany Zjednoczone i Kanadę; w sprawie portorykańskiej linii napisz na [email protected].

Czy SMS weryfikacyjny będzie po hiszpańsku?

To zależy od nadawcy i często od ustawienia języka w aplikacji. Jeśli Twój produkt obsługuje oba języki, przetestuj wersję hiszpańską i angielską.

Jakie numery kierunkowe mogę zobaczyć na numerze z Portoryko?

Portoryko używa 787 i 939. Który z nich otrzymasz, zapisz go w E.164, aby Twoje dane pozostały spójne.

Ile kosztuje kod weryfikacyjny z Portoryko?

Od $0.20 za kod. Dokładną cenę dla każdej usługi podaje GET /api/v1/prices i panel, a jeśli kod nie dotrze, nic nie jest pobierane.

Ile testów równolegle mogę uruchomić?

Konto pozwala na 300 żądań na minutę i 10 kluczy. Większość tego budżetu pochłania polling, więc webhooki zostawiają więcej zapasu dla zadań równoległych.

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.