Итальянские (+39) номера для верификации: для разработчиков и QA

Чем итальянские номера неудобны для валидаторов?

Италия нарушает правило, которое многие нормализаторы молча предполагают. В остальной Европе при добавлении кода страны внутренний ноль отбрасывается, а итальянские стационарные номера его сохраняют: римский номер записывается +39 06 …, а миланский — +39 02 …. Мобильные номера начинаются с 3 и обычно содержат десять цифр после +39, без нуля впереди.

Поэтому библиотека, которая убирает ведущий 0 после кода страны, испортит итальянские стационарные номера, а валидатор с жёсткой длиной может отклонить корректные. Храните полную строку E.164 в точности как +39 плюс национальный номер и добавьте итальянские случаи в тесты разбора телефонов.

Практичный набор тестовых данных для итальянского QA должен включать как минимум один мобильный номер, один римский и один миланский стационарный. Прогоните все три через парсер, через запись в базу и чтение обратно и через любой форматировщик отображения и убедитесь, что сохранённое значение идентично введённому.

Зачем командам проверки верификации на маршрутах +39?

Италия — один из крупнейших рынков ЕС, поэтому её часто выбирают при расширении продукта из одной европейской страны в другую. Важна и QA локализации: проверочные сообщения здесь обычно приходят на итальянском, а ваши собственные шаблоны нужно проверить на буквы с диакритикой, форматы дат и длину текста. Маркетплейсы, финтех- и доставочные приложения также тестируют итальянский онбординг перед подключением местных платёжных или курьерских партнёров. Этот сценарий разбирают заметки об онбординге в финтехе.

У операционных команд свои причины. Агентства, которые ведут итальянским клиентам профили в соцсетях или на маркетплейсах, предпочитают подтверждать эти бизнес-аккаунты на номере, не принадлежащем личному телефону сотрудника; как это сочетается с общим логином, описывает страница для операционных команд.

Какие сервисы есть в итальянском списке?

Сейчас коды на номера итальянского маршрута могут отправлять более 2 100 сервисов. Среди популярных: WhatsApp, Instagram, Facebook, Google (Gmail и YouTube), Amazon, eBay, Airbnb, Uber, Telegram, Microsoft и Outlook, LinkedIn, Netflix, Discord и ChatGPT (OpenAI). Список актуален на момент запроса, поэтому запрашивайте его, а не кэшируйте надолго.

Как работает сценарий `it` через API?

Отправляйте запросы на https://otproute.com/api/v1 с Bearer-ключом, начинающимся с or_live_. Узнайте стоимость через GET /api/v1/prices?country=it&service=<id>, затем создайте заказ через POST /api/v1/activations с телом {"service": "<id>", "country": "it"}. В ответе придёт идентификатор активации; опрашивайте GET /api/v1/activations/{id} или ждите вебхук activation.sms_received, а activation.expired и activation.cancelled обрабатывайте как два других исхода.

Всегда проверяйте X-OTPRoute-Signature (HMAC-SHA256 от "<t>.<raw body>") и отклоняйте старые метки времени; подробности есть в руководстве по HMAC. Аккаунт допускает 10 ключей, 5 конечных точек вебхуков и 300 запросов в минуту.

В CI-конвейере обычно заказывают номер на подготовительном шаге, запускают браузерный тест, который вызывает SMS, а затем блокируются на короткоживущем слушателе, пока не придёт вебхук или не закроется окно. Отменяйте активацию на шаге очистки, чтобы прерванный прогон не оставлял номер открытым.

Заказ из панели управления вместо API

Не разработчики могут сделать то же самое в веб-приложении: откройте OTP Gateway, выберите сервис, выберите Италию, подтвердите цену и скопируйте номер +39 в тестируемое приложение. Код появится на экране, как только придёт. Если не пришёл, дождитесь конца окна, убедитесь, что сервис принимает виртуальные номера, затем повторите позже или на другом маршруте, а не заказывайте снова и снова.

Записывайте, какой сервис и маршрут вы использовали при каждой попытке: так проще понять, касается ли сбой одного приложения или всего итальянского маршрута в этот час.

Есть ли постоянная итальянская линия и как она оплачивается?

Самостоятельного долгосрочного номера для Италии нет. Выделенные номера, от $1.95/month, существуют только в США и Канаде; чтобы узнать об итальянской линии, напишите на [email protected], учитывая, что доступность зависит от местных правил. Оплата — предоплаченный кошелёк в долларах США с пополнением картой или USDT/USDC, PDF-счета и без абонентской платы. Чтобы начать, откройте страницу цен или зарегистрируйтесь и попросите включить режим песочницы на время разработки.

Частые вопросы

Нужно ли убирать 0 из итальянских номеров при добавлении +39?

Для стационарных — нет: итальянские стационарные номера сохраняют ведущий 0 после +39. Мобильные номера начинаются с 3, и никакого нуля в них изначально нет.

Каков идентификатор страны Италия в API OTP Route?

Это it; он используется и в запросе цен, и в теле активации.

Можно ли протестировать итальянскую регистрацию из-за пределов Италии?

Да. Номер +39 из OTP Gateway принимает код, где бы ни находилась ваша команда, а прочитать его можно в панели или через API.

Сколько стоит SMS OTP из Италии?

Итальянские коды стоят от $0.20 за код; API сообщает актуальный тариф для каждого сервиса, а панель показывает его до подтверждения.

Что будет, если итальянский код не придёт?

Через 20 минут активация истекает, и сумма автоматически возвращается в кошелёк, без обращений в поддержку.

Можно ли использовать один и тот же номер +39 в следующем месяце?

Нет, номера шлюза рассчитаны на одну верификацию. Долгосрочные линии доступны только в США и Канаде.

Будут ли проверочные сообщения приходить на итальянском?

Часто да, так как многие отправители локализуют сообщения по стране, но некоторые используют языковые настройки аккаунта. Стройте парсер вокруг цифр, а не формулировок.

Есть ли ограничения использования, о которых стоит знать?

Соблюдайте условия каждого сервиса и Политику допустимого использования OTP Route; шлюз предназначен для тестирования и работы с вашими собственными законными продуктами, а не для массового создания аккаунтов.

Названия сервисов являются товарными знаками их владельцев. OTP Route не связан с ними. Используйте номера законно, соблюдайте условия каждого сервиса и нашу Политику допустимого использования.