Odbieranie kodu SMS Battle.net na numerze testowym, krok po kroku

Sytuacja: studio lub zespół e-sportowy potrzebuje kontrolowanego numeru Battle.net

Wyobraź sobie lidera QA w firmie, która buduje narzędzia towarzyszące, nakładki lub oprogramowanie turniejowe wokół gier Blizzard. Zespół prowadzi oficjalne konta firmowe do testów i transmisji i nikt nie chce, by był do nich przypięty prywatny numer komórkowy inżyniera. Innym częstym przypadkiem jest organizacja e-sportowa, w której pracownicy operacyjni zarządzają współdzielonymi kontami drużyn i potrzebują, by weryfikacja trafiała tam, gdzie widzi ją cały zespół.

Battle.net używa numeru telefonu do kilku rzeczy: potwierdzania osoby stojącej za kontem, wysyłania kodów przy zmianie wrażliwych danych, wspierania odzyskiwania konta oraz jako warstwa bezpieczeństwa obok aplikacji Blizzard Authenticator. Niektóre tytuły Blizzard prosiły też o numer telefonu na koncie przed rozpoczęciem gry. Weryfikacja SMS Battle.net do testów dotyka więc procesów, które zespół może potrzebować odtwarzać więcej niż raz.

Lista kontrolna przed zamówieniem numeru wirtualnego dla Battle.net

• Wybierz właściwy produkt. Jednorazowe sprawdzenia pasują do OTP Gateway. Konto, które zachowa swój telefon i będzie musiało przechodzić przyszłe monity bezpieczeństwa, należy do numeru dedykowanego (zobacz niżej).
• Dopasuj kraj. Kraj konta Battle.net jest wybierany przy tworzeniu i zazwyczaj użytkownik nie może go później zmienić, więc zamów numer z tego samego rynku co konto.
• Przygotuj dane dostępowe. Klucz Bearer z konsoli deweloperskiej (prefiks or_live_) i najlepiej endpoint webhook z sekretem.
• Zasil portfel. Kartą lub USDT/USDC do przedpłaconego portfela w USD; nie ma planu miesięcznego.
• Próba na sucho w sandboxie. Wsparcie może przełączyć konto deweloperskie w tryb sandbox, aby integracja otrzymywała symulowane numery i kody bez wydawania środków.

Strona testy QA opisuje, jak zespoły organizują tego rodzaju wielokrotnego użytku dane testowe.

Z jakich krajów można odebrać OTP Battle.net?

Trasa battle_net obejmuje obecnie 197 krajów. Wśród nich są Stany Zjednoczone, Kanada, Wielka Brytania, Niemcy, Francja, Hiszpania, Polska, Szwecja, Korea Południowa, Tajwan, Japonia, Singapur, Filipiny, Australia, Brazylia, Meksyk, Turcja i Republika Południowej Afryki. Blizzard obsługuje graczy przez regionalne huby gier, więc wybrany kraj powinien odzwierciedlać region i sklep, których dotyczy przypadek testowy, a nie trasę, która akurat jest najtańsza. Aktualną dostępność dla każdego kraju zwraca GET /api/v1/prices.

Jak działa przepływ API kodu weryfikacyjnego Battle.net?

Adres bazowy https://otproute.com/api/v1, uwierzytelnianie Bearer, 300 żądań na minutę.

1. Potwierdź cenę i dostępność: GET /api/v1/prices?country=<id>&service=battle_net, używając identyfikatora kraju z GET /api/v1/countries.
2. Utwórz aktywację przez POST /api/v1/activations z ciałem takim jak {"service": "battle_net", "country": "us"}.
3. Wpisz zwrócony numer w Battle.net i poproś o kod.
4. Obsłuż activation.sms_received na swoim webhooku. Zweryfikuj X-OTPRoute-Signature, obliczając HMAC-SHA256 z <t>.<raw body> z sekretem endpointu, i odrzucaj stare znaczniki czasu.
5. Zadbaj o idempotentność handlera: opieraj przetwarzanie na identyfikatorze aktywacji, aby ponowione dostarczenie nie wysłało tego samego kodu dwa razy.
6. Brak publicznego endpointu? Odpytuj zamiast tego GET /api/v1/activations/{id} i traktuj zdarzenie activation.expired lub activation.cancelled jako koniec tego uruchomienia testu.

Przewodnik po przechwytywaniu przez webhook szczegółowo opisuje kolejkowanie i ponowienia.

Co robią w panelu osoby niebędące programistami?

Otwórz OTP Gateway, wybierz Battle.net i kraj konta, spójrz na wyświetloną cenę i potwierdź. Wpisz numer w polu telefonu w Battle.net, poproś o SMS i zostaw otwartą stronę aktywacji; kod pojawi się tam po dostarczeniu. Obowiązuje to samo 20-minutowe okno i automatyczny zwrot.

Dlaczego kod Battle.net może nie dotrzeć?

Blizzard może odrzucać numery wirtualne lub typu prepaid dla niektórych funkcji bezpieczeństwa, a ta polityka może się zmienić bez uprzedzenia. Jeśli kod nigdy nie przyjdzie, cała kwota wraca do portfela po zakończeniu okna lub anulowaniu. Wtedy:

• poczekaj na pełne okno, ponieważ czas dostarczenia zależy od usługi i trasy;
• spróbuj później albo z innym krajem, który nadal pasuje do konta;
• unikaj szybkich pętli anuluj-i-zamów-ponownie, które marnują limit żądań;
• jeśli numer zostanie odrzucony wprost, potraktuj to jako odpowiedź polityki, a nie coś do obejścia.

Lista kontrolna nieudanych dostaw wymienia więcej sygnałów do logowania.

Kiedy numer dedykowany jest lepszym numerem telefonu dla Battle.net?

Numer na jeden kod znika po swoim oknie, więc słabo nadaje się do konta, które będzie jeszcze musiało odebrać kod bezpieczeństwa. Dla długotrwałego konta firmowego numer dedykowany w Stanach Zjednoczonych lub Kanadzie, od $1.95/miesiąc, utrzymuje tę samą linię, odnawiając się z portfela, i przekazuje przychodzące SMS-y do panelu oraz na Twój webhook jako number.sms_received.

Cokolwiek wybierzesz, przestrzegaj regulaminu Blizzard: jedno konto na realną osobę lub firmę, bez dodatkowych kont i bez prób obejścia zawieszenia. OTP Route służy do testowania i prowadzenia własnych legalnych kont i produktów, a jego Acceptable Use Policy obowiązuje. Battle.net jest znakiem towarowym swojego właściciela, a OTP Route nie ma z nim żadnych powiązań.

Najczęstsze pytania

Czy mogę odebrać OTP Battle.net bez używania prywatnego telefonu?

Tak. Zamów numer OTP Gateway dla battle_net, wpisz go w Battle.net i odczytaj kod w panelu lub przez webhook. Kosztuje od $0.20 za kod, pobierane tylko po dostarczeniu.

Czy Battle.net akceptuje każdy numer wirtualny?

Nie. Blizzard może odrzucać numery wirtualne lub prepaid dla niektórych funkcji, dlatego niedostarczone aktywacje są zwracane automatycznie.

Jaki kraj wybrać dla konta testowego Battle.net?

Użyj tego samego kraju co konto. Kraj konta Battle.net jest ustawiany przy jego tworzeniu, więc niedopasowany numer może prowadzić do mylących wyników.

Jaki jest identyfikator usługi Battle.net w API?

Identyfikator usługi to battle_net. Połącz go z identyfikatorem kraju w POST /api/v1/activations.

Co powstrzymuje handler webhooka Battle.net przed dwukrotnym użyciem jednego kodu?

Zapisz identyfikator aktywacji przy pierwszej obsłudze activation.sms_received i po weryfikacji podpisu ignoruj każde późniejsze dostarczenie z tym samym identyfikatorem.

Czy konto firmowe, które później potrzebuje kodów, powinno używać aktywacji tymczasowej?

Nie. Przy powtarzanych monitach bezpieczeństwa numer dedykowany z USA lub Kanady od $1.95/miesiąc utrzymuje tę samą linię, dopóki się odnawia.

Ile krajów obejmuje trasa Battle.net?

197 krajów według ostatniego zrzutu. Dostępność zmienia się w ciągu dnia, więc przed zamówieniem odczytaj aktualne ceny z API.

Nazwy usług są znakami towarowymi ich właścicieli. OTP Route nie jest z nimi powiązany. Korzystaj z numerów zgodnie z prawem oraz przestrzegaj regulaminów poszczególnych usług i naszej Polityki akceptowalnego użytkowania.