Тест проверки по +592 на основе вебхуков и опроса

Как спроектировать поток Guyana OTP API на основе вебхуков?

Для всего, что выходит за рамки разовой проверки, пусть платформа присылает коды вам, а не спрашивайте её снова и снова. В консоли разработчика добавьте HTTPS-эндпоинт (в аккаунте их может быть 5) и подпишите его на activation.sms_received, а также на activation.expired и activation.cancelled, чтобы ваш тест-раннер узнавал о тупиках так же быстро, как об успехах.

Считайте каждый входящий запрос недоверенным, пока он не пройдёт проверку:

• Прочитайте заголовок X-OTPRoute-Signature формата t=<unix>,v1=<hex>.
• Соедините метку времени, точку и неизменённое тело запроса, затем вычислите HMAC-SHA256 от этой строки с секретом эндпоинта.
• Сравните свой дайджест с v1 за постоянное время и отбросьте запрос, если метка времени устарела.
• Найдите в событии id активации; если вы его уже обработали, верните успех и больше ничего не делайте.

Последнее правило делает обработчик идемпотентным, так что повторная доставка после сетевого сбоя не собьёт тест. Подробнее — в материале о приёме OTP через вебхуки.

Какие эндпоинты и id использует заказ +592?

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

Типичный прогон сначала читает GET /api/v1/prices?country=gy&service=<id>, поскольку цена и доступность на этом маршруте — живые значения, а не константы. Затем отправляет POST /api/v1/activations с {"service": "<id>", "country": "gy"} и получает номер +592 и id активации. Без вебхука раннер опрашивает GET /api/v1/activations/{id} раз в несколько секунд, что намного ниже потолка в 300 запросов в минуту. Шаг очистки вызывает POST /api/v1/activations/{id}/cancel, когда тест прерывается, а предварительный вызов GET /api/v1/balance останавливает набор тестов заранее, если на кошельке мало средств. Id сервисов берутся из GET /api/v1/services; в центре разработчиков есть примеры клиентов для этого API SMS-верификации.

Как форматировать номера +592 для хранения?

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

Поскольку ведущего нуля нет, нормализация сводится к удалению пробелов и дефисов и добавлению кода страны, если пользователь вводит только местные цифры. Частая ошибка — форма, которая предполагает, что у любого южноамериканского номера есть код региона, или задаёт минимальную длину больше семи цифр и поэтому отклоняет корректные гайанские номера. Номер +592 для тестирования быстро выявляет это. Сохраняйте строку E.164, а местное форматирование применяйте только при отображении.

Какие сервисы принимают SMS с OTP-кодами из Гайаны и можно ли заказывать вручную?

В маршруте Гайаны указано более 900 сервисов. Среди часто запрашиваемых — WhatsApp, Facebook, Instagram, Google (Gmail & YouTube), TikTok, Telegram, imo, Viber, Snapchat, Amazon, Microsoft & Outlook, Discord, Netflix и Claude. Этот список — срез живого каталога, поэтому подтвердите наличие через API или панель, прежде чем строить тест вокруг конкретного отправителя.

Для коллег, которые не пишут код, ту же работу выполняет панель. Войдите, откройте OTP Gateway, выберите Гайану и сервис, проверьте цену и закажите. Проверочный номер Гайаны появится рядом с 20-минутным обратным отсчётом, а по приходе код отобразится рядом с ним.

Что должен делать тест, если код +592 опаздывает или не приходит?

Активация остаётся открытой 20 минут. Вы платите, только если код пришёл в это окно; если оно истекло или вы отменили активацию, вся сумма возвращается на кошелёк без обращения в поддержку.

Разумная обработка в автоматическом прогоне:

1. Дождитесь конца окна, прежде чем объявлять неудачу, если только у теста нет жёсткого лимита времени — тогда отмените активацию явно.
2. Повторите позже или переключитесь на другой маршрут сервиса, если API его предлагает.
3. Проверьте, принимает ли целевой сервис виртуальные номера; некоторые отказывают, и возврат предусмотрен именно для такого случая.
4. Растягивайте повторы с нарастающей паузой, а не заказывайте заново в плотном цикле.

Руководство по маршрутизации OTP по странам объясняет, как выбирать запасные маршруты.

Зачем командам тестировать регистрацию в Гайане?

Гайана — единственная страна Южной Америки, где официальным языком является английский, а в Джорджтауне находится секретариат КАРИКОМ, поэтому она часто фигурирует в запусках, где Карибское сообщество рассматривается как один рынок. Быстрорастущий шельфовый энергетический сектор привлёк международных подрядчиков и поставщиков, а многочисленная диаспора в США, Канаде и Великобритании обеспечивает работой приложения для переводов, обмена сообщениями и путешествий на номерах +592. В повседневной жизни широко распространён гайанский креольский, но проверочные тексты обычно приходят на английском. Для QA это значит, что усилия нужно направить на ввод номера, выбор страны и формулировки согласия на SMS, а не на переведённые тексты. Проводите все проверки на аккаунтах, которыми владеет ваша организация, соблюдайте условия каждого сервиса и помните, что Политика допустимого использования OTP Route распространяется на все заказы.

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

Долгосрочные номера по самообслуживанию для Гайаны не предлагаются. Выделенные номера OTP Route охватывают только США и Канаду, от $1.95/месяц. Для линии +592 напишите на [email protected], и команда проверит, что допускают местные правила, без каких-либо обещаний.

Оплата идёт через единый предоплаченный кошелёк в USD: без абонентской платы и тарифного плана, пополнение картой или USDT/USDC и PDF-счёт на email за каждое пополнение. Аккаунт разработчика по запросу можно перевести в песочницу, и интеграционные тесты будут идти на имитированных номерах и кодах, не затрагивая баланс. Цены по сервисам указаны на странице тарифов.

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

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

Да. Закажите номер +592 в OTP Gateway для своего сервиса, введите его в своём потоке, и код появится в панели или придёт на ваш вебхук. Цены начинаются от $0.20 за код.

Какой id страны использует API для Гайаны?

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

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

Нет. В Гайане нет транковой приставки, поэтому формат E.164 — это +592 и семизначный номер.

На каком языке приходят проверочные сообщения на +592?

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

Вернут ли деньги, если сервис так и не отправил SMS?

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

Можно ли протестировать всю интеграцию, не тратя деньги?

Попросите поддержку перевести ваш аккаунт разработчика в песочницу. Она возвращает имитированные номера и коды, так что вызовы API и вебхуки можно проверить от начала до конца.

Доступен ли долгосрочный номер +592?

Не как продукт самообслуживания. Выделенные номера продаются только в США и Канаде; о Гайане можно спросить письмом на [email protected].

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