Włoskie numery weryfikacyjne (+39) dla programistów i zespołów QA

Co sprawia, że włoskie numery telefonów są kłopotliwe dla walidatorów?

Włochy łamią regułę, którą wiele normalizatorów po cichu zakłada. W reszcie Europy przy dodawaniu numeru kierunkowego kraju odrzuca się krajowe zero, ale włoskie numery stacjonarne je zachowują: numer z Rzymu zapisuje się +39 06 …, a z Mediolanu +39 02 …. Numery komórkowe zaczynają się od 3 i zwykle mają dziesięć cyfr po +39, bez zera z przodu.

Biblioteka, która usuwa początkowe 0 po numerze kierunkowym, zniekształci więc włoskie numery stacjonarne, a walidator wymagający stałej długości może odrzucić poprawne. Zapisuj pełny ciąg E.164 dokładnie jako +39 plus numer krajowy i dodaj włoskie przypadki do testów parsowania telefonów.

Praktyczny zestaw danych testowych dla włoskiego QA powinien zawierać co najmniej jeden numer komórkowy, jeden numer stacjonarny z Rzymu i jeden z Mediolanu. Przepuść wszystkie trzy przez parser, zapis i odczyt z bazy oraz każdy formatter wyświetlania, a potem sprawdź, czy zapisana wartość jest identyczna z wprowadzoną.

Dlaczego zespoły uruchamiają testy weryfikacji na trasach +39?

Włochy to jeden z większych rynków UE, więc to częsty przystanek, gdy produkt rozszerza się z jednego kraju europejskiego na kolejny. Ważne jest też QA lokalizacji: wiadomości weryfikacyjne przychodzą tu zwykle po włosku, a własne szablony warto sprawdzić pod kątem liter z akcentami, formatów dat i długości tekstu. Aplikacje marketplace, fintech i dostawcze testują też włoski onboarding, zanim włączą lokalnych partnerów płatniczych lub kurierskich. Opisują to notatki o onboardingu fintech.

Zespoły operacyjne mają własne powody. Agencje zarządzające włoskimi profilami klientów w mediach społecznościowych lub na marketplace wolą potwierdzać te konta firmowe na numerze, który nie jest prywatnym telefonem pracownika, a strona dla zespołów operacyjnych opisuje, jak to łączy się ze wspólnym loginem.

Jakie usługi są na włoskiej liście?

Ponad 2100 usług może obecnie wysyłać kody na numery z włoskiej trasy. Do popularnych należą WhatsApp, Instagram, Facebook, Google (Gmail & YouTube), Amazon, eBay, Airbnb, Uber, Telegram, Microsoft & Outlook, LinkedIn, Netflix, Discord i ChatGPT (OpenAI). Lista jest aktualizowana na żywo, więc odpytuj ją, zamiast długo trzymać ją w pamięci podręcznej.

Jak przebiega proces `it` przez API?

Wysyłaj żądania do https://otproute.com/api/v1 z kluczem Bearer zaczynającym się od or_live_. Sprawdź koszt przez GET /api/v1/prices?country=it&service=<id>, a następnie utwórz zamówienie przez POST /api/v1/activations z {"service": "<id>", "country": "it"}. Odpowiedź zawiera identyfikator aktywacji; odpytuj GET /api/v1/activations/{id} albo czekaj na webhook activation.sms_received, a activation.expired lub activation.cancelled obsłuż jako dwa pozostałe zakończenia.

Zawsze weryfikuj X-OTPRoute-Signature (HMAC-SHA256 z "<t>.<raw body>") i odrzucaj stare znaczniki czasu; szczegóły są w przewodniku o HMAC. Konta pozwalają na 10 kluczy, 5 endpointów webhooków i 300 żądań na minutę.

W potoku CI często zamawia się numer w kroku przygotowawczym, uruchamia test przeglądarkowy wywołujący SMS, a następnie blokuje się na krótkotrwałym nasłuchiwaczu, aż nadejdzie webhook albo zamknie się okno. Anuluj w kroku porządkującym, aby przerwany przebieg nie zostawił otwartego numeru.

Zamawianie z panelu

Osoby niebędące programistami mogą zrobić to samo w aplikacji webowej: otwórz OTP Gateway, wybierz usługę, wybierz Włochy, potwierdź cenę i skopiuj numer +39 do testowanej aplikacji. Kod pojawi się na ekranie zaraz po nadejściu. Jeśli nie dotrze, poczekaj do końca okna, sprawdź, czy usługa akceptuje numery wirtualne, a potem spróbuj później lub na innej trasie, zamiast zamawiać wielokrotnie.

Zapisuj sobie, jakiej usługi i trasy użyto przy każdej próbie; dzięki temu łatwiej zobaczyć, czy luka dotyczy jednej aplikacji, czy całej włoskiej trasy o danej porze.

Czy jest stała włoska linia i jak się ją rozlicza?

Włochy nie mają samoobsługowego numeru długoterminowego. Numery dedykowane, od $1.95/month, istnieją tylko w Stanach Zjednoczonych i Kanadzie; by zapytać o włoską linię, napisz na [email protected], pamiętając, że dostępność zależy od lokalnych przepisów. Rozliczenia opierają się na przedpłaconym portfelu w USD doładowywanym kartą lub USDT/USDC, z fakturami PDF i bez opłaty miesięcznej. Zobacz cennik lub załóż konto, aby zacząć, i poproś o tryb sandbox na czas budowania integracji.

Najczęstsze pytania

Czy usuwać 0 z włoskich numerów przy dodawaniu +39?

Nie w numerach stacjonarnych: włoskie numery stacjonarne zachowują początkowe 0 po +39. Numery komórkowe zaczynają się od 3 i nie mają zera na początku.

Jaki jest identyfikator kraju dla Włoch w API OTP Route?

To it, używany zarówno w zapytaniu o ceny, jak i w ciele aktywacji.

Czy mogę przetestować włoski proces rejestracji spoza Włoch?

Tak. Numer +39 z OTP Gateway odbiera kod, gdziekolwiek jest Twój zespół, a Ty odczytujesz go w panelu lub przez API.

Ile kosztuje SMS OTP z Włoch?

Włoskie kody zaczynają się od $0.20 za kod; API podaje aktualną stawkę dla każdej usługi, a panel pokazuje ją przed potwierdzeniem.

Co się stanie, jeśli włoski kod nie dotrze?

Po 20 minutach aktywacja wygasa, a kwota wraca automatycznie do portfela, bez zgłoszenia.

Czy mogę użyć tego samego numeru +39 w przyszłym miesiącu?

Nie, numery z bramki służą do jednej weryfikacji. Linie długoterminowe są dostępne tylko w USA i Kanadzie.

Czy wiadomości weryfikacyjne będą przychodzić po włosku?

Często tak, bo wielu nadawców lokalizuje wiadomości według kraju, ale niektórzy używają języka ustawionego na koncie. Oprzyj parser na cyfrach, a nie na brzmieniu tekstu.

Czy są limity użycia, o których powinienem wiedzieć?

Przestrzegaj regulaminów usług i Zasad dopuszczalnego użytkowania OTP Route; bramka służy do testowania i prowadzenia własnych legalnych produktów, a nie do masowego zakładania 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.