Тестируем регистрацию с номерами +994, когда ни у кого в команде нет азербайджанской SIM-карты

Наш продукт запускается в Баку, и шаг верификации блокирует все тесты. Какие варианты?

Это типичная ситуация для команд, добавляющих Азербайджан в существующее приложение. Экран телефона принимает +994, локализованные тексты готовы, а потом QA останавливается, потому что единственная азербайджанская SIM-карта принадлежит подрядчику в другом часовом поясе. Взять личный телефон коллеги можно один раз, но он привязывает тестовый аккаунт к частному номеру и не работает внутри конвейера.

OTP Gateway снимает это узкое место. Вы запрашиваете номер +994 для одного кода, используете его на своём экране регистрации или входа и забираете SMS, не держа в руках никакого оборудования. Каждый номер обслуживает одну верификацию, что сохраняет чистоту тестовых данных и не пускает личные телефоны в бизнес-аккаунты. Команды, которые делают это каждый спринт, обычно сочетают его с процессом QA-тестирования.

Какие приложения могут доставить коды на азербайджанский маршрут прямо сейчас?

В актуальном срезе для Азербайджана указано более 1600 сервисов. Среди популярных — WhatsApp, Telegram, Viber, Uber, Google (Gmail & YouTube), Facebook, Instagram, TikTok, Microsoft & Outlook, LinkedIn, Discord, Signal и Amazon.

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

Как встроить API OTP для Азербайджана в автоматизированный набор тестов?

Все вызовы идут на https://otproute.com/api/v1 с Bearer-ключом из консоли разработчика; ключи начинаются с or_live_, и в аккаунте их может быть до 10. Идентификатор страны Азербайджана — az.

1. Получите каталог через GET /api/v1/services и GET /api/v1/countries, затем подтвердите комбинацию через GET /api/v1/prices?country=az&service=<id>.
2. Создайте заказ через POST /api/v1/activations с телом вроде {"service": "viber", "country": "az"}. Сохраните идентификатор активации из ответа.
3. Введите возвращённый номер +994 в тестируемую сборку.
4. Ждите activation.sms_received на вебхуке или опрашивайте GET /api/v1/activations/{id}, если задача выполняется там, где входящий трафик заблокирован.
5. Освобождайте всё брошенное через POST /api/v1/activations/{id}/cancel.

Вебхук-вызовы несут X-OTPRoute-Signature: t=<unix>,v1=<hex>. Пересчитайте HMAC-SHA256 от <t>.<raw body> с секретом эндпоинта, сравните за постоянное время и отбросьте устаревшие метки времени; как это сделать, описано в руководстве по безопасности вебхуков. Лимит 300 запросов в минуту оставляет достаточно места для параллельных задач.

Может ли сотрудник не из инженерной команды получить код +994 вручную?

Да. Продакт-менеджерам, переводчикам и руководителям поддержки часто нужен один код, чтобы проверить экран, и панель решает это без какого-либо API-ключа:

• Войдите и откройте OTP Gateway.
• Выберите Азербайджан, затем сервис, который тестируете, и прочитайте актуальную цену.
• Закажите номер и вставьте его в своё приложение.
• Не закрывайте страницу активации; SMS появится там, как только будет доставлено.

Если тест отменён, отмените активацию, и сумма сразу вернётся в кошелёк.

Как нашему бэкенду хранить и нормализовать номера +994?

Сохраняйте каждый номер в формате E.164, например +994 и девятизначный национальный номер. Внутри страны перед кодом оператора набирают внутренний префикс 0, поэтому форма регистрации получит оба стиля. Уберите пробелы, дефисы и этот внутренний 0, затем добавьте код страны перед сохранением. Поддерживаемая библиотека разбора надёжнее самописного регулярного выражения.

Азербайджанский — официальный язык и использует латинский алфавит с буквами вроде ə, ğ, ı, ş и ç; русский тоже широко понимают. В зависимости от сервиса и локали устройства код может прийти на азербайджанском, русском или английском. Поэтому маршруты +994 удобны, чтобы проверить, что ваши собственные шаблоны SMS корректно отображают специальные символы, а парсер кода не зависит от английских формулировок.

Код так и не появился. Что попробовать перед эскалацией?

Начните с того, чтобы дать активации отработать полные 20 минут; некоторые отправители держат сообщения в очереди. Если ничего не пришло, заказ истекает, срабатывает activation.expired, а вся сумма автоматически возвращается, так что вы платите, только если код пришёл.

Затем проверьте обычные причины:

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

Дополнительную диагностику покрывает чек-лист по неудачным доставкам.

Есть ли долгосрочная азербайджанская линия и как оплачивается использование?

Самостоятельно оформляемого выделенного номера для Азербайджана нет. Dedicated Numbers — продукт для США и Канады, от $1.95 в месяц; если вам нужна постоянная линия +994, напишите на [email protected], и команда проверит, что допускают местные правила, без обещания доступности. Для аккаунтов, которым нужны повторные входы, альтернатива — линия в США или Канаде.

Для тестов в Баку расходы списываются с единого предоплаченного кошелька в долларах США; подписного тарифа и ежемесячной платы нет. Пополняйте картой или USDT либо USDC, и за каждое пополнение по электронной почте приходит PDF-счёт; актуальные цены — на странице тарифов. Аккаунт разработки по запросу можно перевести в песочницу, где возвращаются симулированные номера и коды, так что интеграцию можно проверить от начала до конца до траты реальных средств. К каждому заказу применяются Политика допустимого использования OTP Route и условия самого сервиса.

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

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

Да. Закажите номер +994 в OTP Gateway, введите его в приложении и читайте код в панели или через API, без физической SIM-карты.

Какой идентификатор Азербайджана в API OTP Route?

Используйте az в поле country запроса POST /api/v1/activations и в запросах цен.

Сколько стоит номер +994 для тестирования?

Коды стоят от $0.20 за код; точная сумма зависит от сервиса и возвращается через GET /api/v1/prices до подтверждения.

Спишутся ли деньги, если азербайджанское SMS не придёт?

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

Нужно ли хранить азербайджанские номера с ведущим нулём?

Нет. Отбросьте внутренний префикс 0 и храните номер в формате E.164, начинающемся с +994.

Можно ли оставить тот же номер подтверждения Азербайджана для последующих входов?

Через OTP Gateway — нет, он выдаёт один номер на один код. Долгосрочные линии с самостоятельным оформлением есть только в США и Канаде; об Азербайджане спросите поддержку.

На каком языке придут азербайджанские проверочные сообщения?

Это зависит от отправителя и настроек устройства; распространены азербайджанский, русский и английский.

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