Test weryfikacji +592 oparty na webhookach i odpytywaniu

Jak zaprojektować przepływ Guyana OTP API oparty na webhookach?

Przy czymkolwiek poza jednorazowym sprawdzeniem pozwól platformie wysyłać kody do Ciebie, zamiast pytać w kółko. W konsoli Developer dodaj endpoint HTTPS (konto może mieć ich 5) i zasubskrybuj go na activation.sms_received, a także activation.expired i activation.cancelled, by Twój runner testów dowiadywał się o ślepych zaułkach równie szybko jak o sukcesach.

Każde przychodzące żądanie traktuj jako niezaufane, dopóki nie przejdzie weryfikacji:

• Odczytaj nagłówek X-OTPRoute-Signature w formacie t=<unix>,v1=<hex>.
• Połącz znacznik czasu, kropkę i niezmodyfikowane ciało żądania, a następnie oblicz HMAC-SHA256 tego ciągu przy użyciu sekretu endpointu.
• Porównaj swój skrót z v1 w stałym czasie i odrzuć żądanie, jeśli znacznik czasu jest nieaktualny.
• Odczytaj id aktywacji ze zdarzenia; jeśli już je przetworzyłeś, zwróć sukces i nie rób nic więcej.

Ta ostatnia reguła czyni handler idempotentnym, więc ponowne dostarczenie po chwilowej awarii sieci nie namiesza w teście. Dłuższe omówienie znajdziesz w przechwytywaniu OTP przez webhooki.

Jakich endpointów i id używa zamówienie +592?

Uwierzytelnij się kluczem Bearer z konsoli Developer; klucze produkcyjne zaczynają się od or_live_, a każde konto może mieć ich do 10. Bazowy URL to https://otproute.com/api/v1, a id kraju Gujany to gy.

Typowy przebieg zaczyna się od GET /api/v1/prices?country=gy&service=<id>, bo cena i dostępność na tej trasie to wartości na żywo, a nie stałe. Następnie wysyła POST /api/v1/activations z {"service": "<id>", "country": "gy"} i otrzymuje numer +592 oraz id aktywacji. Bez webhooka runner odpytuje GET /api/v1/activations/{id} co kilka sekund, daleko poniżej limitu 300 żądań na minutę. Krok porządkujący wywołuje POST /api/v1/activations/{id}/cancel, gdy test zostanie przerwany, a wstępne GET /api/v1/balance zatrzymuje zestaw testów wcześniej, jeśli w portfelu brakuje środków. Id usług pobierzesz z GET /api/v1/services; w centrum dla deweloperów są przykłady klientów dla tego SMS verification API.

Jak formatować numery +592 do przechowywania?

Gujana używa kodu kraju 592 i siedmiocyfrowych numerów krajowych bez prefiksu krajowego do usunięcia, więc forma E.164 to po prostu +592 i te siedem cyfr. Ludzie zwykle zapisują cyfry jako grupę trzech i grupę czterech.

Skoro nie ma zera wiodącego do usunięcia, normalizacja sprowadza się do usunięcia spacji i myślników oraz dodania kodu kraju, gdy użytkownik wpisze tylko lokalne cyfry. Częsty błąd to formularz zakładający, że każdy numer z Ameryki Południowej ma numer kierunkowy, albo ustawiający minimalną długość powyżej siedmiu cyfr, przez co odrzuca poprawne wpisy z Gujany. Numer +592 do testów szybko to ujawnia. Zapisuj ciąg E.164, a lokalne formatowanie stosuj dopiero przy wyświetlaniu.

Jakie usługi mogą odbierać kody SMS OTP z Gujany i czy mogę zamówić ręcznie?

Trasa Gujany obejmuje ponad 900 usług. Do często zamawianych należą WhatsApp, Facebook, Instagram, Google (Gmail & YouTube), TikTok, Telegram, imo, Viber, Snapchat, Amazon, Microsoft & Outlook, Discord, Netflix i Claude. Ta lista to migawka katalogu na żywo, więc przed zaplanowaniem testu wokół konkretnego nadawcy sprawdź ją w API lub panelu.

Dla współpracowników, którzy nie piszą kodu, panel robi to samo. Zaloguj się, otwórz OTP Gateway, wybierz Gujanę i usługę, sprawdź cenę i zamów. Numer weryfikacyjny z Gujany pojawi się obok 20-minutowego odliczania, a kod zostanie wyświetlony obok po nadejściu.

Co powinien zrobić test, gdy kod +592 się spóźnia lub nie przychodzi?

Aktywacja pozostaje otwarta przez 20 minut. Płacisz tylko wtedy, gdy kod dotrze w tym oknie; jeśli aktywacja wygaśnie albo ją anulujesz, pełna kwota wraca do portfela bez żadnego zgłoszenia do wsparcia.

Rozsądne postępowanie w zautomatyzowanym przebiegu:

1. Poczekaj do końca okna, zanim uznasz test za nieudany, chyba że test ma twardy limit czasu; wtedy anuluj aktywację jawnie.
2. Spróbuj ponownie później albo przełącz się na inną trasę usługi, jeśli API ją oferuje.
3. Sprawdź, czy docelowa usługa akceptuje numery wirtualne; niektóre je odrzucają, a zwrot obejmuje właśnie ten przypadek.
4. Rozkładaj ponowienia z użyciem backoffu zamiast ponawiać zamówienia w ciasnej pętli.

Przewodnik po routingu OTP według krajów wyjaśnia, jak wybierać trasy zapasowe.

Dlaczego zespoły testują rejestrację w Gujanie?

Gujana to jedyny kraj Ameryki Południowej, w którym językiem urzędowym jest angielski, a Georgetown gości Sekretariat CARICOM, więc często pojawia się we wdrożeniach traktujących Wspólnotę Karaibską jako jeden rynek. Szybko rozwijający się morski sektor energetyczny przyciągnął międzynarodowych wykonawców i dostawców, a liczna diaspora w Stanach Zjednoczonych, Kanadzie i Wielkiej Brytanii zapewnia ruch aplikacjom do przekazów pieniężnych, komunikacji i podróży na numerach +592. Kreolski gujański jest szeroko używany na co dzień, lecz SMS-y weryfikacyjne zazwyczaj przychodzą po angielsku. Dla QA oznacza to skupienie wysiłku na wprowadzaniu numeru, listach wyboru kraju i treści zgody na SMS-y, a nie na przetłumaczonych tekstach. Wszystkie sprawdzenia prowadź na kontach należących do Twojej organizacji, przestrzegaj regulaminu każdej usługi i pamiętaj, że Polityka dopuszczalnego użytkowania OTP Route obejmuje wszystkie zamówienia.

Czy mogę zachować numer z Gujany i jak rozliczane jest użycie?

Samoobsługowe numery długoterminowe nie są oferowane dla Gujany. Numery dedykowane OTP Route obejmują wyłącznie Stany Zjednoczone i Kanadę, od $1.95/month. W sprawie linii +592 napisz na [email protected], a zespół sprawdzi, na co pozwalają lokalne przepisy, bez żadnej obietnicy.

Płatności idą przez jeden przedpłacony portfel w USD: bez opłaty miesięcznej, bez planu, doładowania kartą lub USDT/USDC, a za każde doładowanie dostajesz fakturę PDF e-mailem. Konto deweloperskie można na życzenie przełączyć na sandbox, więc testy integracji działają na symulowanych numerach i kodach i nie ruszają salda. Stawki za poszczególne usługi znajdziesz na stronie cennika.

Najczęstsze pytania

Czy mogę sprawdzić rejestrację w mojej aplikacji dla Gujany bez karty SIM od gujańskiego operatora?

Tak. Zamów numer +592 w OTP Gateway dla swojej usługi, wpisz go w swoim przepływie, a kod pojawi się w panelu lub dotrze na Twój webhook. Ceny zaczynają się od $0.20 za kod.

Jakiego id kraju API używa dla Gujany?

To gy, używane zarówno w zapytaniu o ceny, jak i w treści żądania aktywacji.

Czy muszę usuwać zero wiodące z numerów gujańskich?

Nie. Gujana nie ma prefiksu krajowego, więc forma E.164 to +592 i siedmiocyfrowy numer.

W jakim języku przychodzą wiadomości weryfikacyjne +592?

Zwykle po angielsku, czyli w języku urzędowym. Brzmienie ustala jednak nadawca i może ono zależeć od ustawienia języka w aplikacji.

Czy jest zwrot, jeśli usługa nigdy nie wyśle SMS-a?

Tak, i to automatyczny. Jeśli upłynie 20 minut bez kodu albo anulujesz aktywację, cała kwota wraca do Twojego portfela.

Czy mogę przetestować całą integrację bez wydawania pieniędzy?

Poproś wsparcie o przełączenie konta deweloperskiego na sandbox. Zwraca ono symulowane numery i kody, więc wywołania API i webhooki można przećwiczyć od początku do końca.

Czy dostępny jest długoterminowy numer +592?

Nie jako produkt samoobsługowy. Numery dedykowane są sprzedawane tylko w Stanach Zjednoczonych i Kanadzie; w sprawie Gujany napisz na [email protected].

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.