Подключаем казахстанские коды подтверждения +7 к набору тестов

Какие конечные точки задействует прогон OTP для Казахстана?

Полный цикл — это пять-шесть запросов к https://otproute.com/api/v1, подписанных Bearer-ключом с префиксом or_live_. Идентификатор страны Казахстана — kz, а один аккаунт может держать до 10 ключей, так что у CI, стейджинга и ноутбука разработчика могут быть свои.

• GET /api/v1/balance в начале задачи, чтобы пустой кошелёк останавливал прогон сразу.
• GET /api/v1/prices?country=kz&service=telegram, чтобы узнать текущую цену и доступность этой пары.
• POST /api/v1/activations с {"service": "telegram", "country": "kz"}, который возвращает идентификатор активации и номер +7.
• GET /api/v1/activations/{id}, если вы опрашиваете, или ничего, если полагаетесь на вебхуки.
• POST /api/v1/activations/{id}/cancel, когда тест завершается раньше, чем нужен код.

Лимит — 300 запросов в минуту на аккаунт, что оставляет запас для параллельных задач, опрашивающих раз в несколько секунд. Если это ваша первая сборка, начните с руководства по интеграции API.

Как получать коды +7 по вебхуку вместо опроса?

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

Восстановите подпись как HMAC-SHA256 от <t>.<raw body> с секретом конечной точки и сравнивайте за постоянное время. Используйте сырые байты в том виде, как они пришли, потому что повторно сериализованный JSON даст другой дайджест, и отклоняйте метки времени за пределами короткого допуска, чтобы остановить повторное воспроизведение. Поскольку доставка может повторяться, делайте upsert по идентификатору активации, чтобы вторая копия ничего не меняла. Пошаговый разбор есть в материале о приёме OTP через вебхуки.

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

В маршруте kz указано более 1 700 сервисов. Среди популярных в последнем срезе: Telegram, WhatsApp, Google (Gmail и YouTube), Instagram, TikTok, Facebook, Viber, Discord, Microsoft и Outlook, LinkedIn, Uber, AliExpress и Amazon.

Не зашивайте этот список в код. Маршруты меняются в течение дня, поэтому скрипту стоит проверять GET /api/v1/prices перед каждым заказом и выбирать запасной идентификатор сервиса, если пара недоступна.

Почему +7 требует особой аккуратности в базе телефонных номеров?

У Казахстана общий с Россией код страны 7. В обоих случаях национальные номера состоят из десяти цифр, а казахстанские мобильные диапазоны обычно начинаются с 7 после кода страны, так что номер вида +7 7xx xxx xx xx — казахстанский, тогда как многие российские мобильные начинаются с 9. Никогда не определяйте страну только по коду набора: выводите её из диапазона номера с помощью поддерживаемой телефонной библиотеки или ведите явное поле страны.

Внутри страны перед десятью цифрами набирают префикс 8. Убирайте его при вводе и храните форму E.164: +7 и национальный номер. Казахский — государственный язык, а русский также широко используется на официальном уровне, поэтому проверочные тексты могут приходить на русском, казахском или английском, как правило, кириллицей. Убедитесь, что ваш SMS-парсер и логи работают с UTF-8 и извлекают цифры, а не формулировки.

Команды тестируют здесь при запуске в Центральной Азии, проверке двуязычной локализации или поддержке региональных операционных сотрудников.

Есть ли путь через панель для тех, кто не пишет код?

Да. После регистрации по коду из письма или через Google пополните кошелёк, выберите Казахстан и сервис, подтвердите показанную цену и оформите заказ. Номер +7 и позже код появятся на карточке активации. Менеджеры продукта и тестировщики локализации используют это для выборочных проверок, пока конвейер справляется с объёмом.

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

Самостоятельно — нет. Номера OTP Gateway рассчитаны на один код, а долгосрочные выделенные номера продаются только для США и Канады, от $1.95/month, с входящими и исходящими SMS и звонками из браузера. Если нужна долгосрочная казахстанская линия, напишите на [email protected]; возможность её организовать зависит от местных правил и не гарантирована. Для стейджинг-аккаунтов, в которые нужно входить снова, практичным ответом часто служит американская или канадская линия, если сервис её принимает.

Что происходит, если код не пришёл за 20 минут?

Активация истекает, вебхук отправляет activation.expired, и вся сумма возвращается в кошелёк без каких-либо действий с вашей стороны. Перед повтором проведите диагностику:

• Был ли номер передан с +7, а не с внутренним 8?
• Не отказывается ли сервис от виртуальных номеров? Некоторые отказываются, поэтому OTP Route возвращает средства за неиспользованные активации.
• Повторите позже или на другом маршруте, а не в мгновенном цикле; короткая пауза делает ваши логи читаемыми.

Скорость доставки зависит от сервиса и маршрута, поэтому не задавайте в тестах жёсткие тайм-ауты.

Как выставляются счета?

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

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

Как отличить казахстанский номер +7 от российского?

Смотрите на диапазон номера, а не только на код страны. Казахстанские мобильные обычно начинаются с 7 после +7; поддерживаемая библиотека телефонных номеров или явное поле страны помогает избежать ошибок.

Каков идентификатор Казахстана в API OTP Route?

Используйте kz в теле активации и в параметре country конечной точки цен.

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

Да. Закажите номер +7 для Казахстана в OTP Gateway, введите его в своём сценарии и получите код по вебхуку, опросом или в панели.

Спишутся ли деньги, если код Telegram не придёт?

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

Приходят ли казахстанские проверочные тексты на русском или казахском?

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

Есть ли абонентская плата за казахстанский маршрут?

Нет. OTP Route работает по мере использования с предоплаченного кошелька в долларах США, пополняемого картой, USDT или USDC.

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