Программные коды подтверждения +351 для запуска в Португалии

Какие эндпоинты задействованы при проверке номера +351?

Базовый URL — https://otproute.com/api/v1, а каждый запрос содержит Bearer-ключ с префиксом or_live_. Идентификатор Португалии — pt.

1. GET /api/v1/countries и GET /api/v1/services отдают идентификаторы; кэшируйте их на время прогона тестов.
2. GET /api/v1/prices?country=pt&service=<id> возвращает текущую цену и сообщает, открыт ли маршрут.
3. POST /api/v1/activations с телом {"service": "telegram", "country": "pt"} резервирует номер и возвращает идентификатор активации.
4. GET /api/v1/activations/{id} показывает статус и код, если вы предпочитаете опрос.
5. POST /api/v1/activations/{id}/cancel освобождает номер, который тесту больше не нужен.
6. GET /api/v1/balance позволяет пайплайну остановиться заранее, если на кошельке мало средств.

Лимиты аккаунта: 10 API-ключей, 5 вебхук-эндпоинтов и 300 запросов в минуту. Полные схемы приведены в справочнике API.

Как подписанные вебхуки доставляют португальские коды в наш сервис?

Зарегистрируйте HTTPS-эндпоинт в консоли разработчика и подпишитесь на activation.sms_received, activation.expired и activation.cancelled. Каждый POST содержит заголовок X-OTPRoute-Signature: t=<unix>,v1=<hex>.

Чтобы проверить подпись, соберите строку <t>.<raw body>, посчитайте HMAC-SHA256 с секретом эндпоинта и сравните результат с v1 сравнением за постоянное время. Отклоняйте запросы со слишком старой меткой времени, чтобы перехваченный запрос нельзя было воспроизвести повторно. Сохраняйте идентификатор активации из каждого события и игнорируйте повторы — тогда обработчик безопасен при повторных доставках. Схема подробно разобрана в статье о приёме OTP через вебхуки.

Какие сервисы доступны на португальских маршрутах?

По текущему снимку для Португалии доступно более 2000 сервисов. Часто используют WhatsApp, Telegram, Airbnb, Uber, Google (Gmail & YouTube), Facebook, Instagram, TikTok, LinkedIn, Microsoft & Outlook, Amazon, Netflix, Discord и Signal.

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

Зачем продуктовым командам тестировать португальские номера?

Португалия часто попадает в план запуска в ЕС одной из первых. В Лиссабоне и Порту работает много продуктовых и инженерных команд, а многие компании используют страну как европейскую базу. Есть и причина, связанная с локализацией: европейский португальский (pt-PT) отличается от бразильского орфографией, лексикой и формами обращения, поэтому интерфейс, переведённый для Бразилии, в Португалии может звучать странно. Реальная проверка по номеру +351 позволяет ревьюерам увидеть текст pt-PT, пришедшее SMS и окружающие экраны вместе.

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

Как форматировать и хранить номера +351?

В Португалии нет префикса для внутренних звонков: номера состоят из девяти цифр и набираются одинаково и внутри страны, и в международном формате после +351. Мобильные номера начинаются с 9, а географические городские — с 2. Храните их в E.164, отклоняйте всё, где после кода страны не девять цифр, и убирайте пробелы, которые пользователи ставят при вводе группами по три цифры.

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

Можно ли обойтись без кода, и что делать, если SMS не пришло?

В панели откройте OTP Gateway, выберите Португалию и сервис, проверьте актуальную цену и оформите заказ. Вставьте номер в своё приложение и ждите код на странице активации.

Окно длится 20 минут, а платить нужно только в случае, если код пришёл; иначе вся сумма автоматически возвращается на кошелёк. Если кода нет:

• Дождитесь конца окна, а не отменяйте через несколько секунд.
• Убедитесь, что сервис принимает виртуальные номера в этом сценарии.
• Повторите позже или проверьте тот же экран через другой маршрут сервиса.
• Делайте паузы между попытками, а не заказывайте заново в плотном цикле.

Есть ли выделенная португальская линия и как устроена оплата?

OTP Route не продаёт выделенные номера в Португалии по схеме самообслуживания. Dedicated Virtual Numbers есть только для США и Канады, от $1.95/месяц; если нужна долгосрочная линия +351, напишите на [email protected], но учтите, что доступность зависит от местных правил и не гарантируется. Чем различаются временные и выделенные номера, читайте в материале временные и выделенные номера.

Оплата — по мере использования с предоплаченного кошелька в USD, без абонентской платы и тарифных планов; пополнять можно картой или USDT/USDC, а к каждому пополнению прилагается PDF-счёт. Тестовые аккаунты по запросу переводятся в песочницу, где работают симулированные номера и коды. Соблюдайте условия каждого сервиса; действует Политика допустимого использования OTP Route.

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

Какой идентификатор Португалии используется в API OTP Route?

Это pt — его указывают и в запросе цен, и в теле запроса на активацию.

Используются ли в португальских номерах префикс для внутренних звонков вроде начального 0?

Нет. Португальские номера состоят из девяти цифр без такого префикса, поэтому формат E.164 — это +351 и следующие за ним девять цифр.

Можно ли протестировать онбординг на pt-PT без португальской SIM-карты?

Да. Номер +351 для тестирования из OTP Gateway принимает код, который вы читаете в панели или через API.

Сколько стоит номер для верификации в Португалии?

От $0.20 за код; точная цена зависит от сервиса и показывается перед заказом.

Придётся ли платить за активацию +351, на которую ничего не пришло?

Нет. Истёкшие и отменённые активации полностью возвращаются на кошелёк.

Можно ли арендовать португальский номер для постоянных входов?

Не в режиме самообслуживания. Долгосрочные линии — продукт для США и Канады; если нужна линия +351, напишите в поддержку.

Что лучше для португальских кодов: опрос или вебхуки?

Вебхуки лучше масштабируются при параллельных задачах, а опрос GET /api/v1/activations/{id} подходит раннерам, которые не могут принимать входящий трафик.

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