Как принимать коды подтверждения телефона Yahoo через API

Где Yahoo запрашивает номер телефона?

Аккаунты Yahoo объединяют почту, новости, финансы и фэнтези-спорт под одним логином, и номер телефона находится почти в центре этой учётной записи. В известных сценариях он появляется в нескольких местах:

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

Для QA-команды каждый из этих моментов — отдельный тест-кейс. Для проверки регистрации номер нужен один раз, а для проверки восстановления или двухэтапной защиты тот же номер должен быть доступен снова позже, и от этого зависит, какой продукт OTP Route выбрать.

Важна ли страна номера для Yahoo?

Да. Yahoo используют по всему миру, а номер из рынка, к которому относится ваш аккаунт, даёт самую точную проверку локализованных текстов, региональных экранов регистрации и формата номеров. Коды Yahoo сейчас можно получать в 198 странах, включая США, Великобританию, Канаду, Индию, Филиппины, Мексику, Бразилию, Германию, Францию, Индонезию, Нигерию, ЮАР, Австралию, Испанию и Тайвань.

Подбирайте страну номера под тест-кейс: агентству, которое ведёт почтовый ящик Yahoo клиента в Маниле, стоит проходить верификацию через филиппинский маршрут, а команда, проверяющая испаноязычный онбординг, узнает больше с мексиканским или испанским номером, чем с американским.

Как выглядит работа с API для сервиса yahoo?

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

1. Узнайте, сколько придётся заплатить: GET /api/v1/prices?country=gb&service=yahoo (замените gb на любой идентификатор api_country).
2. Откройте активацию через POST /api/v1/activations с телом {"service": "yahoo", "country": "gb"}.
3. Введите полученный номер на шаге Yahoo, где запрашивается телефон.
4. Заберите код из события activation.sms_received или опросите GET /api/v1/activations/{id}, если вебхуки ещё не настроены.
5. Отмените заказ через POST /api/v1/activations/{id}/cancel, если тест прекращён.

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

Как получить OTP Yahoo из личного кабинета?

1. Войдите и откройте OTP Gateway.
2. Выберите Yahoo, затем страну, подходящую для вашего теста.
3. Проверьте цену на экране и подтвердите заказ.
4. Введите номер в Yahoo и запросите код.
5. Прочитайте сообщение на карточке активации, когда оно придёт.

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

Почему код Yahoo может не прийти?

Yahoo сам решает, отправлять ли сообщение и на какие номера. Он может отклонять виртуальные номера в некоторых регионах или для некоторых типов аккаунтов и может замедлять повторные запросы из одной сессии. Если код не пришёл:

• Оставьте активацию открытой на всё окно: задержанная отправка всё ещё может дойти.
• Попробуйте тот же сценарий через маршрут другой страны.
• Подождите некоторое время, а не заказывайте заново в плотном цикле.
• Считайте отказ свойством сервиса, а не ошибкой в вашем коде.

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

Когда для Yahoo лучше подходит Dedicated Number?

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

Для таких задач Dedicated Number остаётся за вами, пока продлевается с баланса, принимает SMS в личном кабинете и на вашем вебхуке как number.sms_received и стоит от $1.95/месяц. Их мгновенно продают только в США и Канаде; страница виртуальных номеров сравнивает два продукта.

Каковы правила тестирования с Yahoo?

Используйте OTP Route, чтобы тестировать собственный продукт или вести законные аккаунты, принадлежащие реальному человеку или компании, по одному аккаунту на каждого. Соблюдайте условия Yahoo и помните, что Политика допустимого использования OTP Route действует для каждой активации. Yahoo — товарный знак его владельца, OTP Route с ним не связан.

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

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

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

Да. Закажите номер для сервиса yahoo в OTP Route, и код появится в личном кабинете или на вашем вебхуке. Если Yahoo ничего не пришлёт за 20 минут, вся сумма вернётся на баланс.

Сколько стоит виртуальный номер для Yahoo?

Активации начинаются от $0.20 за код, точная сумма зависит от страны. Вызовите GET /api/v1/prices с идентификатором страны и yahoo, чтобы увидеть актуальную цену.

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

Нет. Активация прекращается после одного кода, поэтому позже восстановление не сработает. Для восстановления и повторных входов подходит Dedicated Number в США или Канаде.

Принимает ли Yahoo любой номер телефона?

Не обязательно. Yahoo может отказывать виртуальным номерам или ограничивать запросы, поэтому OTP Route возвращает деньги за активации, по которым SMS не пришло.

Как не дать дубликатам вебхуков сломать мой тест Yahoo?

Сохраняйте идентификатор каждой обработанной активации и игнорируйте повторы. Проверяйте подпись до любой обработки.

Какие страны можно выбрать для номера Yahoo?

Сейчас Yahoo доступен на маршрутах 198 стран. Актуальный список даёт GET /api/v1/countries и личный кабинет.

Можно ли автоматизировать SMS-верификацию Yahoo для тестирования в CI?

Да. Используйте API с вебхуком или опросом и запросите режим песочницы на аккаунте разработки, чтобы прогоны пайплайна работали на имитированных номерах и кодах.

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