Получение йеменских (+967) кодов подтверждения через API

Какой кратчайший путь к коду +967 через API?

Направьте клиент на https://otproute.com/api/v1 с Bearer-ключом из консоли разработчика; ключи имеют префикс or_live_. Идентификатор страны Йемена — ye.

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

GET /api/v1/services и GET /api/v1/countries меняются редко, поэтому кэшируйте их на день. Вызов GET /api/v1/balance перед пакетом позволяет задаче рано остановиться, когда средства на исходе. Лимит в 300 запросов в минуту действует на аккаунт, и можно выпустить до 10 ключей. Рабочий пример этого сценария OTP API для Йемена — в руководстве по интеграции.

Как проверять доставки вебхуков для активаций Йемена?

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

Проверка подписи следует одному рецепту. Разделите X-OTPRoute-Signature на t и v1, вычислите HMAC-SHA256 от строки <t>.<raw body> с секретом эндпоинта и сравните результат с v1 функцией с постоянным временем. Отклоняйте запрос, если метка времени старше вашего допуска. Поскольку доставка может повторяться, сделайте обработчик идемпотентным: сохраняйте идентификатор активации и игнорируйте повторы. В материале защита вебхуков OTP с помощью HMAC разобраны граничные случаи, например расхождение часов.

Чего ожидать парсеру от сообщений на арабском языке?

Арабский — официальный язык Йемена, поэтому многие сервисы отправляют окружающий текст на арабском. Для тех, кто тестирует собственные сообщения, это имеет практические последствия: арабскому письму нужна кодировка UCS-2, из-за чего один сегмент SMS ограничен 70 символами, а текст справа налево может сдвигать место, где в уведомлении появляется код. Одни шаблоны ставят цифры перед предложением, другие — после него.

Напишите шаг извлечения так, чтобы он находил последовательность цифр независимо от окружающих слов. Разумно также нормализовать арабо-индийские цифры (٠–٩) в ASCII на случай, если отправитель их использует. Команды проводят такие проверки при локализации приложения для арабоязычных пользователей, при поддержке йеменских клиентов, живущих в странах Залива, или чтобы убедиться, что региональный аккаунт поддержки по-прежнему проходит верификацию. OTP Route возвращает сообщение в том виде, в каком оно получено, поэтому то, что вы разбираете в тесте, — это то, что получил бы пользователь.

Как форматируются йеменские телефонные номера?

Код страны — +967. У мобильных номеров после него девять цифр, и начинаются они с 7, что даёт вид +967 7XX XXX XXX. Если пользователь вводит внутренний 0 в начале, удалите его перед сохранением и храните строку E.164 без разделителей; локальное форматирование относится только к интерфейсу.

Полезные случаи валидации для номера +967 для тестирования:

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

Каждый из них должен приводить к одному и тому же сохранённому значению — это делает поиск и дедупликацию надёжными.

Какие сервисы сейчас маршрутизируются на номера +967?

Для Йемена в OTP Gateway доступно более 1 700 сервисов. Часто используемые в живом снимке — WhatsApp, Telegram, imo, Facebook, Instagram, TikTok, Snapchat, Google (Gmail & YouTube), X (Twitter), Microsoft & Outlook, Signal, Discord и Amazon.

Доступность — движущаяся цель, поэтому стройте наборы тестов так, чтобы они сначала спрашивали API. Люди вне инженерии могут сделать ту же работу из панели: создайте аккаунт по коду из письма или через Google, пополните баланс, выберите Йемен и сервис, затем скопируйте проверочный номер Йемена в приложение и ждите код на странице активации.

Почему код из Йемена может не прийти и как это исправить?

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

Типичные причины и реакции:

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

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

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

Не в режиме самообслуживания. Dedicated Virtual Numbers предлагаются только в США и Канаде и покупаются мгновенно от $1.95/мес. Команды, которым нужна постоянная линия +967, могут написать на [email protected]; можно ли её предоставить, зависит от местных правил и никогда не гарантировано.

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

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

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

Да. Закажите номер OTP Gateway со страной ye, введите его в своём приложении и прочитайте сообщение на арабском или английском в панели или через вебхук.

Сколько стоит код подтверждения +967?

От $0.20 за код, цена зависит от сервиса; актуальную сумму возвращает GET /api/v1/prices. Коды, которые так и не пришли, возвращаются по окончании 20-минутного окна.

Как извлечь код, если SMS читается справа налево?

Ищите последовательность цифр, а не шаблон предложения, и сначала преобразуйте арабо-индийские цифры в ASCII. Это работает независимо от того, с какой стороны текста стоит код.

Номер +967 остаётся у меня навсегда?

Нет, номер OTP Gateway рассчитан на одну проверку. Постоянные номера — продукт для США и Канады; для Йемена напишите в поддержку и спросите.

Можно ли интегрироваться, не тратя баланс кошелька?

Да, попросите песочницу для тестового аккаунта. Она возвращает имитированные номера и коды, чего достаточно для проверки опроса, вебхуков и обработки ошибок.

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

ye. Передавайте его в запросах цен и в JSON-теле POST /api/v1/activations.

Почему сервис отказал моему йеменскому номеру?

Некоторые сервисы не принимают виртуальные номера. Отмените активацию или дайте ей истечь, и деньги автоматически вернутся на ваш кошелёк.

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