Как подключить эфиопские (+251) SMS-коды к вашему тестовому конвейеру

Какие вызовы API получают эфиопский код подтверждения?

Маршрутизация OTP для Ethiopia сводится к пяти обычным HTTP-вызовам к https://otproute.com/api/v1. Каждый вызов аутентифицируется Bearer-ключом с префиксом or_live_, созданным в консоли разработчика; в аккаунте может быть до 10 ключей, так что CI, стейджинг и локальный ноутбук могут работать с отдельными учётными данными.

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

Наличие меняется в течение дня, поэтому вызывайте эндпоинт цен во время выполнения и ничего не зашивайте в код. Быстрый GET /api/v1/balance перед запуском набора тестов позволяет задаче остановиться заранее, если в кошельке заканчиваются средства. Форматы запросов и ответов этого SMS verification API описаны в документации для разработчиков.

Как подключить подписанный вебхук для активаций +251?

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

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

Исходите из того, что событие может прийти более одного раза: привязывайте обработчик к id активации и отбрасывайте повторы, чтобы повторно отправленное событие не заполнило поле OTP дважды. Если вы остаётесь на опросе, интервал в несколько секунд комфортно укладывается в лимит 300 запросов в минуту. В нашем разборе защиты вебхуков OTP с помощью HMAC есть эталонный обработчик.

Какие сервисы могут сейчас получать SMS-коды OTP для Ethiopia?

Маршрут Ethiopia сейчас показывает более 1,700 сервисов. Среди популярных в актуальном срезе WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, ChatGPT (OpenAI), Microsoft & Outlook, LinkedIn, Uber, Signal, Viber, imo и Netflix.

Считайте этот список снимком состояния. Доступность отдельного сервиса может измениться за часы, поэтому API сообщает её в реальном времени, а не в статичной таблице. Запрашивайте эндпоинты стран и цен в начале каждого прогона, а если нужно что-то менее распространённое, ищите по полному каталогу в дашборде.

Что QA-командам нужно знать о формате номеров +251 и языке SMS?

Эфиопский номер в E.164 — это +251 и девять цифр. Внутри страны перед этими девятью цифрами набирают ведущий 0, так что пользователи часто вводят в вашу форму 09…. Уберите этот ноль, добавьте +251 и храните каноническую строку E.164, а местный стиль показывайте только в интерфейсе. Покройте оба варианта ввода, а также пробелы и дефисы: именно в валидации поля телефона прячется много ошибок регистрации.

Амхарский — федеральный рабочий язык, он записывается эфиопским письмом (геэз), а оромо, тигринья и сомали широко используются в своих регионах. Большинство международных сервисов присылают коды на английском, но локализованный шаблон может прийти и на амхарском. Извлекайте цифры по шаблону, а не сопоставляя окружающие слова, и проследите, чтобы ваши логи корректно хранили UTF-8.

Обычно этот маршрут тестируют при запуске приложения для эфиопских пользователей, при проверке амхарской локализации или при работе с диаспорой, регистрирующейся по номеру родной страны. Если ваш продукт показывает даты, отдельным случаем локализации стоит добавить и собственный календарь Эфиопии. Как другие команды строят такие наборы тестов, показано на странице QA-тестирования.

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

Да. Менеджеры продукта и сотрудники поддержки могут пройти тот же поток без кода:

1. Создайте аккаунт по почте и 6-значному коду либо через вход с Google, затем включите двухфакторную защиту TOTP.
2. Пополните кошелёк.
3. Выберите Ethiopia, сервис и посмотрите цену, прежде чем подтверждать.
4. Вставьте номер +251 в приложение, которое проверяете.
5. Не закрывайте активацию: код отобразится там, как только придёт.

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

Что происходит, если код +251 не приходит?

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

Когда ничего не приходит:

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

Дополнительные проверки перечислены в статье о снижении числа неудачных доставок OTP.

Есть ли долгосрочная эфиопская линия и как устроена оплата?

У OTP Route нет самостоятельно оформляемого долгосрочного номера в Ethiopia. Dedicated Numbers — линии, которые вы сохраняете, пока они продлеваются, — это продукт для США и Канады от $1.95/месяц. Если вашей команде нужна постоянная линия +251, напишите на [email protected] и спросите; доступность зависит от местных правил и не гарантируется.

Эфиопские активации списываются с единого предоплаченного кошелька в USD, без абонентской платы и без выбора тарифа. Пополняйте картой либо стейблкоинами USDT/USDC; после каждого пополнения PDF-счёт приходит на почту. Прежде чем тратить реальные средства на новую интеграцию, запросите режим песочницы для аккаунта разработки: он возвращает имитированные номера и коды, так что весь поток можно отработать от начала до конца.

Эфиопские тестовые номера OTP Route предназначены для проверки продуктов и аккаунтов, которыми ваша организация действительно владеет; правила каждого сервиса по-прежнему действуют, как и наша Политика допустимого использования.

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

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

Да. Закажите номер +251 для своего сервиса в OTP Gateway, введите его в приложение и прочитайте код в дашборде или через API. Плата взимается, только если код пришёл.

Какой идентификатор у Ethiopia в API OTP Route?

Это et. Передавайте et в поле country при создании эфиопской активации и при запросе цен.

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

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

Хранить ли эфиопские номера с ведущим нулём?

Нет. Сохраняйте форму E.164, то есть +251 и девять цифр, и отбрасывайте внутренний 0, когда его вводит пользователь. Местное форматирование применяйте только на экране.

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

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

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

Самостоятельно нельзя: одноразовый номер рассчитан на один код. Для аккаунта, в который нужно входить снова, подходит Dedicated Number в США или Канаде, либо можно написать в поддержку и спросить про Ethiopia.

Можно ли попробовать Ethiopia OTP API, не тратя средства кошелька?

Да. Запросите режим песочницы для аккаунта разработки, и он будет возвращать имитированные номера и коды, так что интеграцию можно проверить от начала до конца.

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