Подключаем верификацию +993 (Туркменистан) к вашему OTP-конвейеру

Какие вызовы API возвращают номер для верификации в Туркменистане?

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

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

Лимит аккаунта — 300 запросов в минуту на все ключи вместе. Форматы запросов и ответов описаны в справочнике API.

Что выбрать для теста +993: вебхуки или опрос?

Опроса достаточно, если один разработчик вручную проходит сценарий. Когда одновременно идёт несколько задач, вебхуки дешевле и реагируют быстрее. На аккаунте может быть 5 вебхук-эндпоинтов; направьте один на ваш раннер туркменских тестов для событий activation.sms_received, activation.expired и activation.cancelled.

Считайте каждую доставку недоверенной, пока не доказано обратное. Разделите заголовок X-OTPRoute-Signature на t и v1, посчитайте HMAC-SHA256 от t, точки и точного сырого тела с секретом эндпоинта и сравните за постоянное время. Отклоняйте метки времени за пределами короткого допуска, чтобы заблокировать повторы. Сохраняйте результаты по id активации, чтобы повторная доставка ничего не меняла. В статье про приём OTP через вебхуки показан обработчик на очереди, а тестирование в CI-пайплайнах разбирает тайм-ауты в сборочных задачах.

Что можно подтвердить на туркменском номере?

В маршруте tm доступно более 1 600 сервисов. Среди самых востребованных сейчас — imo, Telegram, WhatsApp, Google (Gmail & YouTube), Instagram, Microsoft & Outlook, LinkedIn, ChatGPT (OpenAI), Viber, WeChat, Discord и Snapchat. Мессенджеры составляют значительную часть повседневного трафика в Центральной Азии, поэтому их в списке так много.

Это снимок, а не обязательство. Ёмкость наших партнёров-операторов в течение дня меняется, так что перед каждым запуском запрашивайте цены и не считайте, что вчерашний список остался в силе.

Как форматируются и локализуются номера +993?

Национальный значащий номер Туркменистана состоит из восьми цифр, и большинство мобильных диапазонов начинается с 6. Внутри страны перед номером набирают транковый префикс 8; в международном виде он отбрасывается, и номер превращается в +993 и восемь цифр.

• Приводите номера к E.164 (+9936XXXXXXX) на границе вашей системы и храните только этот вид.
• Не используйте валидацию, написанную для соседних стран: длины и префиксы в Центральной Азии различаются.
• Государственный язык — туркменский, он пишется латиницей с буквами ä, ç, ň, ö, ş, ü, ý и ž. Русский по-прежнему широко понимают. Поэтому SMS с кодом может прийти на туркменском, русском или английском, и ваш парсер должен вынимать цифры из любого тела в UTF-8.

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

Можно ли заказать код для +993 без программирования?

Да. После регистрации по коду из письма или через Google и пополнения кошелька откройте OTP Gateway, выберите сервис, укажите Туркменистан и подтвердите показанную цену. Номер +993 появится сразу; введите его в приложении, запросите SMS и следите за карточкой активации — там появится код. Номер подходит только для этой одной верификации.

Почему код из Туркменистана может не прийти?

• Сервис не принимает виртуальные номера. Некоторые не принимают. Это их политика, и правило возврата существует именно на такой случай.
• Маршрут загружен. Повторите позже или с новой активацией — она получит другой номер.
• Окно закрыли слишком рано. Оставляйте активацию открытой все 20 минут; истёкший заказ возвращается автоматически.
• Слишком агрессивные повторы. Делайте паузы между попытками, а не заказывайте номера подряд.

Эти шаги поддерживают здоровую OTP-маршрутизацию для всех, кто пользуется общим пулом.

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

Самообслуживаемого Dedicated Number для Туркменистана нет. OTP Route продаёт долгосрочные линии только в США и Канаде, от $1.95/месяц; запросы по другим странам можно отправить на [email protected], без обещаний, что местные правила это позволят.

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

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

Можно ли получить номер +993 для тестирования регистрации в моём приложении?

Да. Создайте активацию с id страны tm и выбранным сервисом, затем используйте полученный номер в собственном сценарии регистрации.

Сколько стоит код подтверждения для Туркменистана в OTP Route?

От $0.20 за код. Актуальная цена по каждому сервису приходит от эндпоинта цен и показывается в панели.

Нужно ли вводить префикс 8 при вводе туркменского номера?

Нет. Префикс 8 нужен только при наборе внутри страны, поэтому используйте +993 и восьмизначный национальный номер.

Как понять, что вебхук о коде +993 действительно пришёл от OTP Route?

Проверьте HMAC-SHA256 подпись в заголовке X-OTPRoute-Signature по сырому телу запроса и отклоняйте старые метки времени.

Возврат автоматический, если SMS на туркменский номер не пришло?

Да. Когда 20-минутное окно истекает или вы отменяете активацию, вся сумма возвращается на кошелёк.

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

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

На каком языке придут туркменские OTP-сообщения?

Зависит от приложения: возможны туркменский, русский и английский, поэтому разбирайте цифры, а не слова.

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