Programistyczne kody weryfikacyjne +351 na potrzeby wdrożeń w Portugalii

Z jakich endpointów korzysta weryfikacja numeru +351?

Bazowy adres URL to https://otproute.com/api/v1, a każde żądanie zawiera klucz Bearer zaczynający się od or_live_. Identyfikator kraju dla Portugalii to pt.

1. GET /api/v1/countries i GET /api/v1/services zwracają identyfikatory; zapisz je w pamięci podręcznej na czas przebiegu testów.
2. GET /api/v1/prices?country=pt&service=<id> zwraca aktualną cenę i informację, czy trasa jest otwarta.
3. POST /api/v1/activations z {"service": "telegram", "country": "pt"} rezerwuje numer i zwraca identyfikator aktywacji.
4. GET /api/v1/activations/{id} podaje status oraz kod, jeśli wolisz polling.
5. POST /api/v1/activations/{id}/cancel zwalnia numer, którego test już nie potrzebuje.
6. GET /api/v1/balance pozwala potokowi zatrzymać się wcześniej, gdy w portfelu brakuje środków.

Limity konta to 10 kluczy API, 5 endpointów webhook i 300 żądań na minutę. Pełne schematy znajdziesz w dokumentacji API.

Jak podpisane webhooki dostarczają portugalskie kody do naszej usługi?

Zarejestruj endpoint HTTPS w konsoli deweloperskiej i zasubskrybuj activation.sms_received, activation.expired oraz activation.cancelled. Każdy POST zawiera nagłówek X-OTPRoute-Signature: t=<unix>,v1=<hex>.

Aby go zweryfikować, odtwórz ciąg <t>.<raw body>, oblicz HMAC-SHA256 z sekretem endpointu i porównaj wynik z v1 porównaniem w stałym czasie. Odrzucaj żądania ze zbyt starym znacznikiem czasu, żeby przechwycone żądanie nie mogło zostać odtworzone. Zapisuj identyfikator aktywacji z każdego zdarzenia i ignoruj powtórzenia, dzięki czemu handler jest bezpieczny przy ponowieniach dostarczenia. Ten wzorzec krok po kroku opisuje artykuł o przechwytywaniu OTP przez webhook.

Jakie usługi są dostępne na portugalskich trasach?

Według bieżącego zestawienia Portugalia ma ponad 2000 usług. Do często używanych należą WhatsApp, Telegram, Airbnb, Uber, Google (Gmail & YouTube), Facebook, Instagram, TikTok, LinkedIn, Microsoft & Outlook, Amazon, Netflix, Discord i Signal.

Lista zmienia się w ciągu dnia, gdy nasi partnerzy operatorscy przesuwają przepustowość. Dlatego to endpoint cen, a nie statyczny plik konfiguracyjny, powinien decydować, czy test się uruchomi.

Dlaczego zespoły produktowe testują na portugalskich numerach?

Portugalia często pojawia się na wczesnym etapie planu ekspansji w UE. W Lizbonie i Porto działa wiele zespołów produktowych i inżynierskich, a sporo firm wykorzystuje Portugalię jako europejską bazę. Jest też powód lokalizacyjny: europejska odmiana portugalskiego (pt-PT) różni się od brazylijskiej pisownią, słownictwem i formami grzecznościowymi, więc przepływ przetłumaczony dla Brazylii może brzmieć dziwnie dla osoby w Portugalii. Prawdziwa weryfikacja +351 pozwala recenzentom zobaczyć razem treści pt-PT, wiadomość SMS, która przychodzi, i otaczające ją ekrany.

W kontekście RODO trzymanie numerów telefonów pracowników z dala od kont testowych i współdzielonych to także dobra minimalizacja danych. Jednorazowy numer na każdą weryfikację oznacza mniej danych osobowych w systemach QA. Poradnik o potokach CI pokazuje, jak włączyć to do każdego builda.

Jak formatuje się i przechowuje numery +351?

W Portugalii nie ma prefiksu krajowego (trunk): numery mają dziewięć cyfr i wybiera się je tak samo w kraju i w formie międzynarodowej po +351. Numery komórkowe zaczynają się od 9, a stacjonarne geograficzne od 2. Zapisuj je w formacie E.164, odrzucaj wszystko, co nie ma dziewięciu cyfr po kodzie kraju, i usuwaj spacje, które użytkownicy dodają przy wpisywaniu grup po trzy cyfry.

Przychodzące kody zwykle mają treść po portugalsku lub angielsku, zależnie od nadawcy i języka ustawionego dla konta. Twój ekstraktor kodu powinien szukać cyfr, a nie stałej frazy.

Czy współpracownik może to zrobić bez kodu i co, gdy SMS nie dotrze?

W panelu otwórz OTP Gateway, wybierz Portugalię i usługę, sprawdź aktualną cenę i złóż zamówienie. Wklej numer do swojej aplikacji i czekaj na stronie aktywacji na kod.

Okno trwa 20 minut, a płacisz tylko wtedy, gdy kod dotrze; w przeciwnym razie pełna kwota automatycznie wraca do portfela. Gdy kodu brakuje:

• Poczekaj do końca okna zamiast anulować po kilku sekundach.
• Sprawdź, czy usługa w tym przepływie akceptuje numery wirtualne.
• Spróbuj później albo przetestuj ten sam ekran z inną trasą usługi.
• Rób przerwy między próbami zamiast składać zamówienia w ciasnej pętli.

Czy istnieje dedykowany portugalski numer i jak wygląda rozliczanie?

OTP Route nie oferuje w Portugalii dedykowanych numerów w modelu samoobsługowym. Dedykowane numery wirtualne istnieją tylko dla Stanów Zjednoczonych i Kanady, od $1.95/month; w sprawie długoterminowej linii +351 napisz na [email protected], pamiętając, że dostępność zależy od lokalnych przepisów i nie jest gwarantowana. Zobacz, czym różnią się numery tymczasowe i dedykowane.

Płatność odbywa się na zasadzie pay as you go z przedpłaconego portfela w USD, bez opłat miesięcznych i planów; doładowujesz kartą lub stablecoinami USDT/USDC, a do każdego doładowania dołączona jest faktura PDF. Konta deweloperskie można na prośbę przełączyć w tryb sandbox, aby testować na symulowanych numerach i kodach. Przestrzegaj regulaminów poszczególnych usług; obowiązuje Polityka Dopuszczalnego Użytkowania OTP Route.

Najczęstsze pytania

Jaki jest identyfikator kraju Portugalia w API OTP Route?

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

Czy portugalskie numery telefonów mają prefiks krajowy, np. wiodące 0?

Nie. Portugalskie numery mają dziewięć cyfr bez prefiksu krajowego, więc format E.164 to +351 i te dziewięć cyfr.

Czy mogę przetestować proces wdrożenia pt-PT bez portugalskiej karty SIM?

Tak. Numer +351 do testów z OTP Gateway odbiera kod, który odczytasz w panelu lub przez API.

Ile kosztuje portugalski numer weryfikacyjny?

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

Czy zapłacę za aktywację +351, która nic nie otrzyma?

Nie. Aktywacje, które wygasły lub zostały anulowane, są w całości zwracane do portfela.

Czy mogę wynająć portugalski numer do stałych logowań?

Nie w modelu samoobsługowym. Linie długoterminowe to produkt dla USA i Kanady; jeśli potrzebujesz linii +351, napisz do wsparcia.

Czy dla portugalskich kodów lepszy jest polling, czy webhooki?

Webhooki lepiej skalują się przy równoległych zadaniach, a polling GET /api/v1/activations/{id} sprawdza się na runnerach, które nie przyjmują ruchu przychodzącego.

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.