Lista kontrolna przed startem: odbiór kodów weryfikacyjnych +372 w Estonii

Co powinno znaleźć się na liście kontrolnej przed pierwszym zamówieniem +372?

Większość nieudanych przebiegów testowych wynika z czegoś, czego zabrakło, zanim w ogóle poproszono o numer. Odhacz najpierw te punkty:

• Klucz API utworzony w konsoli deweloperskiej. Każdy klucz ma prefiks or_live_ i jest przekazywany jako token Bearer; skoro na koncie jest miejsce na 10 kluczy, runner CI zasługuje na własny.
• Endpoint webhooka z sekretem przechowywanym po stronie serwera, jeśli wolisz być wywoływany, niż odpytywać. Na koncie dozwolonych jest pięć endpointów.
• Właściwe identyfikatory. Estonia to ee w każdym żądaniu, a identyfikator usługi pochodzi z GET /api/v1/services.
• Sprawdzenie ceny na żywo. Wywołaj GET /api/v1/prices?country=ee&service=<id>, aby zadanie znało koszt, zanim zaangażuje środki z portfela.
• Sandbox, jeśli jeszcze budujesz integrację. Na prośbę konto deweloperskie można przełączyć w tryb sandbox, który zwraca symulowane numery i kody od początku do końca bez dotykania salda.
• Budżet żądań. API przyjmuje 300 żądań na minutę na konto, co w zupełności wystarcza, o ile zestaw testów nie odpytuje bezmyślnie.

Przewodnik integracji OTP API omawia każdy z tych punktów dokładniej.

Jak przeprowadzić żądanie Estonia OTP API od początku do końca?

Gdy lista kontrolna jest odhaczona, sekwencja wywołań jest krótka:

1. POST /api/v1/activations z treścią {"service": "<id>", "country": "ee"}. Odpowiedź zawiera identyfikator aktywacji i numer +372, który wpisujesz w testowanym formularzu rejestracji lub logowania.
2. Wywołaj wysłanie weryfikacyjnego SMS-a z testowanej aplikacji.
3. Poczekaj na kod. Albo Twój endpoint otrzyma activation.sms_received, albo wywołujesz GET /api/v1/activations/{id} w rozsądnych odstępach.
4. Wpisz kod w aplikacji i zapisz wynik przy identyfikatorze aktywacji.
5. Jeśli ścieżka testu się zmieni i numer nie jest już potrzebny, wywołaj POST /api/v1/activations/{id}/cancel, aby rezerwacja została zwolniona od razu.

W przypadku dostaw webhooków odczytaj nagłówek X-OTPRoute-Signature (t=<unix>,v1=<hex>), oblicz HMAC-SHA256 z <t>.<raw body> przy użyciu sekretu endpointu, porównaj w stałym czasie i odrzuć wszystko ze starym znacznikiem czasu. Artykuł zabezpieczanie webhooków OTP przez HMAC prowadzi przez wzorcowy handler. Zapisy uczyń idempotentnymi względem identyfikatora aktywacji, ponieważ ponowienie może dostarczyć to samo zdarzenie dwa razy.

Które usługi mogą wysyłać kody na estoński numer weryfikacyjny?

Aktualny zestaw dla Estonii obejmuje ponad 1 700 usług. Do popularnych tras należą WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, LinkedIn, Microsoft & Outlook, Amazon, Discord, Signal, Uber, Airbnb i ChatGPT (OpenAI).

Zasoby zmieniają się w ciągu dnia, więc trasa, która rano odpowiadała, wieczorem może być uboga. Traktuj GET /api/v1/countries i endpoint cen jako źródło prawdy, zamiast wpisywać listę na sztywno do fixture'ów testowych.

Jak przechowywać i walidować numery +372?

Estonia ma jeden z prostszych planów numeracyjnych, i właśnie dlatego leniwe walidatory się na nim wykładają. Nie ma prefiksu krajowego do usunięcia: numer zapisany w formie krajowej to te same cyfry, które dopisujesz po +372. Numery komórkowe zwykle zaczynają się od 5 i mają siedem lub osiem cyfr, więc wyrażenie regularne wymagające stałej długości numeru krajowego odrzuci poprawne dane.

Praktyczne zasady dla formularzy i bazy danych:

• Przechowuj pełny ciąg E.164, taki jak +3725xxxxxxx, a surowe dane wpisane przez użytkownika trzymaj osobno, jeśli potrzebujesz ich do obsługi zgłoszeń.
• Nigdy nie dopisuj zera; nie ma czego usuwać ani dodawać.
• Przetestuj w maskach wejściowych zarówno siedmiocyfrowe, jak i ośmiocyfrowe numery komórkowe.

Wiadomości weryfikacyjne kierowane do estońskich użytkowników zazwyczaj przychodzą po estońsku, choć wiele aplikacji stosuje język konta lub urządzenia, a częste są też szablony rosyjskie i angielskie. Jeśli Twój produkt ma estońską wersję językową, sprawdź, czy litery takie jak õ, ä, ö i ü przechodzą bez uszczerbku z szablonu do telefonu.

Dlaczego zespoły testują rejestrację na estońskich numerach?

Estonia w świecie oprogramowania znaczy więcej, niż wynikałoby z jej wielkości. Reputacja cyfrowego państwa i program e-Residency sprawiają, że wielu założycieli i firm zdalnych ma związek z tym krajem, nawet jeśli pracownicy mieszkają gdzie indziej, a produkty kierowane na region bałtycki i nordycki często startują właśnie tam.

Typowe powody, dla których lider QA prosi o numer +372 do testów:

• Sprawdzenie, czy selektory krajów, maski telefonów i szablony SMS działają na rynku UE z krótkim planem numeracyjnym.
• Kontrola lokalizacji estońskich tekstów przed regionalnym wydaniem.
• Odtworzenie zgłoszenia od estońskiego klienta, któremu kod nie dotarł.

W artykule testy QA opisujemy, jak zespoły włączają takie kontrole w cykl wydawniczy.

Co sprawdzić, gdy kod się nie pojawia?

Przejdź przez problem po kolei, zamiast zamawiać numer za numerem:

1. Pozwól oknu działać. Aktywacja pozostaje otwarta przez 20 minut, a niektóre usługi kolejkują swoje wiadomości.
2. Sprawdź, czy usługa przyjmuje numery wirtualne. Niektóre odrzucają je z zasady; po to istnieje zwrot środków.
3. Zobacz status końcowy. Zdarzenie activation.expired albo stan wygaśnięcia w odpowiedzi na GET oznacza, że SMS nie dotarł, a pieniądze są już z powrotem w portfelu.
4. Ponów próbę cierpliwie. Spróbuj nieco później albo wybierz inną trasę dla tej samej usługi, zamiast zamawiać ponownie w ciasnej pętli.
5. Sprawdź własny wyzwalacz. Test, który w ogóle nie zażądał SMS-a, wygląda dokładnie tak samo jak brakujący kod.

Nasz tekst o ograniczaniu nieudanych dostaw OTP wymienia kolejne przyczyny warte wykluczenia.

Czy mogę zatrzymać estońską linię na dłużej i jak działają rozliczenia?

Nie ma samoobsługowego, długoterminowego numeru estońskiego. Numery dedykowane to produkt dla USA i Kanady od $1.95/month; w sprawie Estonii napisz na [email protected], jeśli zespół potrzebuje stałej linii, a zespół odpowie, na co pozwalają lokalne przepisy, bez obietnicy dostępności.

Rozliczenia routingu OTP odbywają się przez jeden przedpłacony portfel w USD, bez opłaty miesięcznej i bez wyboru planu. Zasilasz go kartą lub USDT albo USDC, a każda wpłata generuje fakturę PDF wysyłaną e-mailem. Aktualne stawki znajdziesz na stronie cennika, a opis endpointów w dokumentacji.

Najczęstsze pytania

Czy mogę przetestować estońską ścieżkę rejestracji w mojej aplikacji bez lokalnej karty SIM?

Tak. Zamów numer +372 w OTP Gateway, użyj go w formularzu rejestracji i odczytaj kod z panelu, webhooka lub endpointu aktywacji.

Jaki jest identyfikator kraju Estonia w API OTP Route?

Użyj ee jako wartości country w żądaniach aktywacji i cen.

Czy estońskie numery telefonów mają prefiks krajowy, który trzeba usunąć?

Nie. Estonia nie ma prefiksu krajowego, więc cyfry w formie krajowej następują po +372 bez zmian.

Czy zapłacę, jeśli estoński kod nie dotrze?

Nie. Jeśli w ciągu 20-minutowego okna nic nie dotrze albo wcześniej anulujesz, cała kwota automatycznie wraca do portfela.

Czy osoba niebędąca deweloperem może zamówić numer weryfikacyjny z Estonii?

Tak. W panelu wybierz Estonię i usługę, potwierdź wyświetloną cenę, skopiuj numer do aplikacji i poczekaj, aż kod pojawi się na tym samym ekranie.

Czy estońską integrację można przećwiczyć, zanim wydam prawdziwe środki?

Poproś wsparcie o przełączenie konta deweloperskiego w tryb sandbox, który zwraca symulowane numery i kody, dzięki czemu cały przebieg zadziała bez środków z portfela.

Jakie zasady obowiązują przy korzystaniu z tych numerów?

Przestrzegaj regulaminu każdej usługi oraz Acceptable Use Policy OTP Route; numery służą do testowania i prowadzenia własnych, legalnych produktów i kont.

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.