Получение SMS-кода Battle.net на тестовый номер шаг за шагом

Ситуация: студии или киберспортивной команде нужен номер Battle.net, который они контролируют

Представьте QA-лида в компании, которая создаёт сопутствующие инструменты, оверлеи или турнирное ПО для игр Blizzard. Команда ведёт официальные корпоративные аккаунты для тестирования и трансляций, и никто не хочет привязывать к ним личный мобильный номер инженера. Другой распространённый случай — киберспортивная организация, у которой операционные сотрудники управляют общими командными аккаунтами, и проверка должна приходить туда, где её видит вся команда.

Battle.net использует номер телефона для нескольких целей: подтверждает человека, стоящего за аккаунтом, отправляет коды при изменении чувствительных данных, помогает восстановить доступ и служит уровнем защиты наряду с приложением Blizzard Authenticator. Некоторые игры Blizzard также запрашивали номер телефона в аккаунте до начала игры. Поэтому проверка по SMS Battle.net для тестирования затрагивает сценарии, которые вашей команде может понадобиться воспроизводить не один раз.

Чек-лист перед заказом виртуального номера для Battle.net

• Выберите правильный продукт. Разовые проверки подходят для OTP Gateway. Аккаунт, у которого телефон останется привязанным и который будет проходить будущие проверки безопасности, относится к выделенному номеру (см. ниже).
• Совпадение страны. Страна аккаунта Battle.net выбирается при создании и, как правило, не меняется пользователем позже, поэтому заказывайте номер из того же рынка, что и аккаунт.
• Подготовьте учётные данные. Bearer-ключ из консоли разработчика (префикс or_live_) и, в идеале, вебхук-эндпоинт с его секретом.
• Пополните кошелёк. Картой или USDT/USDC на предоплаченный кошелёк в USD; абонентского тарифа нет.
• Пробный прогон в песочнице. Поддержка может перевести аккаунт разработки в песочницу, чтобы интеграция получала имитированные номера и коды без затрат.

На странице QA-тестирования описано, как команды организуют такие многоразовые тестовые данные.

В каких странах можно получить OTP Battle.net?

Маршрут battle_net сейчас охватывает 197 стран. Среди них США, Канада, Великобритания, Германия, Франция, Испания, Польша, Швеция, Южная Корея, Тайвань, Япония, Сингапур, Филиппины, Австралия, Бразилия, Мексика, Турция и Южная Африка. Blizzard обслуживает игроков через региональные игровые хабы, поэтому страна, которую вы выбираете, должна отражать регион и магазин, о которых ваш тестовый случай, а не просто самый дешёвый маршрут. Актуальную доступность по странам возвращает GET /api/v1/prices.

Как работает сценарий API кода подтверждения Battle.net?

Базовый адрес https://otproute.com/api/v1, аутентификация Bearer, 300 запросов в минуту.

1. Подтвердите цену и доступность: GET /api/v1/prices?country=<id>&service=battle_net, используя идентификатор страны из GET /api/v1/countries.
2. Создайте активацию через POST /api/v1/activations с телом вроде {"service": "battle_net", "country": "us"}.
3. Введите полученный номер в Battle.net и запросите код.
4. Обработайте activation.sms_received на вашем вебхуке. Проверьте X-OTPRoute-Signature, вычислив HMAC-SHA256 от <t>.<raw body> с секретом эндпоинта, и отклоняйте старые метки времени.
5. Сделайте обработчик идемпотентным: привяжите обработку к идентификатору активации, чтобы повторная доставка не отправила один и тот же код дважды.
6. Нет публичного эндпоинта? Вместо этого опрашивайте GET /api/v1/activations/{id} и считайте событие activation.expired или activation.cancelled концом тестового прогона.

В руководстве по приёму через вебхуки подробно описаны очереди и повторные попытки.

Что делать не разработчикам в панели?

Откройте OTP Gateway, выберите Battle.net и страну аккаунта, посмотрите показанную цену и подтвердите. Введите номер в телефонное поле Battle.net, запросите SMS и держите страницу активации открытой: код появится там после доставки. Действуют то же 20-минутное окно и автоматический возврат.

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

Blizzard может отклонять виртуальные номера или номера типа предоплаченных для некоторых функций безопасности, и эта политика может измениться без предупреждения. Если код так и не пришёл, вся сумма возвращается на кошелёк по окончании окна или после отмены. Затем:

• дайте окну пройти целиком, ведь время доставки зависит от сервиса и маршрута;
• повторите позже или с другой страной, которая всё ещё соответствует аккаунту;
• избегайте быстрых циклов «отмена — повторный заказ», они расходуют лимит запросов;
• если номер отклонён сразу, воспринимайте это как ответ политики, а не как препятствие, которое нужно обойти.

В чек-листе по недоставленным сообщениям перечислены другие сигналы, которые стоит логировать.

Когда выделенный номер лучше подходит для Battle.net?

Номер на один код исчезает по окончании окна, поэтому плохо подходит любому аккаунту, которому снова понадобится код безопасности. Для долгоживущего корпоративного аккаунта выделенный номер (Dedicated Number) в США или Канаде от $1.95/мес. сохраняет одну и ту же линию, пока продлевается с кошелька, и пересылает входящие SMS в панель и на ваш вебхук как number.sms_received.

Что бы вы ни выбрали, соблюдайте условия Blizzard: один аккаунт на реального человека или компанию, никаких лишних аккаунтов и попыток обойти блокировку. OTP Route существует для тестирования и работы с вашими собственными законными аккаунтами и продуктами, и действует его Политика допустимого использования. Battle.net — товарный знак его владельца, и OTP Route не связан с ним.

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

Можно ли получить OTP Battle.net, не используя личный телефон?

Да. Закажите номер OTP Gateway для battle_net, введите его в Battle.net и прочитайте код в панели или через вебхук. Это стоит от $0.20 за код и списывается только при доставке.

Принимает ли Battle.net любой виртуальный номер?

Нет. Blizzard может отклонять виртуальные или предоплаченные номера для некоторых функций, поэтому недоставленные активации возвращаются автоматически.

Какую страну выбрать для тестового аккаунта Battle.net?

Ту же, что у аккаунта. Страна аккаунта Battle.net задаётся при его создании, поэтому несовпадающий номер может привести к запутанным результатам.

Какой идентификатор сервиса Battle.net в API?

Идентификатор сервиса — battle_net. Укажите его вместе с идентификатором страны в POST /api/v1/activations.

Что мешает обработчику вебхука Battle.net действовать дважды по одному коду?

Сохраните идентификатор активации при первой обработке activation.sms_received и после проверки подписи игнорируйте любую следующую доставку с тем же идентификатором.

Стоит ли корпоративному аккаунту, которому коды нужны позже, использовать временную активацию?

Нет. Для повторных запросов безопасности выделенный номер в США или Канаде от $1.95/мес. сохраняет ту же линию, пока продлевается.

Сколько стран охватывает маршрут Battle.net?

197 стран по последнему снимку. Доступность меняется в течение дня, поэтому перед заказом читайте актуальные цены из API.

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