Lista kontrolna odbierania kodów SMS TikToka w testach i operacjach

Do czego TikTok wysyła kody SMS?

TikTok pozwala założyć konto za pomocą numeru telefonu, zalogować się jednorazowym kodem zamiast hasła, włączyć weryfikację dwuetapową i odzyskać dostęp po zapomnieniu hasła. Każdy z tych momentów może wywołać kod SMS i każdy jest krokiem, który zespoły budujące rozwiązania wokół TikToka mogą musieć odtworzyć: agencja potwierdzająca konto marki, którym zarządza, inżynier QA sprawdzający integrację z logowaniem społecznościowym albo zespół operacyjny, który nie chce powiązać profilu firmowego z prywatnym telefonem pracownika.

Numer wirtualny dla TikToka pasuje do tych przypadków, a najczęstszym z nich jest weryfikacja SMS TikToka do testów. Wszystkie są zgodne z zasadami, gdy konto należy do Ciebie lub Twojego klienta i pozostaje w granicach regulaminu TikToka.

Lista kontrolna przed zamówieniem

Dziesięć minut poświęcone na te punkty przed pierwszym zamówieniem TikToka oszczędza godziny późniejszego szukania brakujących kodów:

• Wybierz rynek. Kraj numeru powinien odpowiadać regionowi konta lub przypadkowi testowemu, który odtwarzasz.
• Sprawdź cenę i dostępność. GET /api/v1/prices?country=<id>&service=tiktok zwraca oba parametry na żywo.
• Zasil portfel. GET /api/v1/balance na początku przebiegu kończy się szybkim błędem zamiast niepowodzenia w trakcie testu.
• Zdecyduj o sposobie dostarczania. Webhook dla CI i zadań równoległych, odpytywanie dla szybkich kontroli ręcznych.
• Pomyśl z wyprzedzeniem o ponownym logowaniu. Jeśli konto musi zalogować się ponownie za miesiąc, numer jednorazowy jest złym narzędziem (patrz ostatnia sekcja).
• Poznaj zasady. Jedno konto na jedną prawdziwą osobę lub firmę, regulamin TikToka oraz polityka dopuszczalnego użytkowania OTP Route (Acceptable Use Policy).

Z jakiego kraju powinien pochodzić numer telefonu dla TikToka?

Trasa TikToka jest otwarta w 202 krajach. Częste wybory to Stany Zjednoczone, Kanada, Wielka Brytania, Niemcy, Francja, Brazylia, Meksyk, Indonezja, Filipiny, Wietnam, Tajlandia, Turcja, Arabia Saudyjska, Pakistan, Nigeria i Kenia.

Wybór kraju nie jest kosmetyczny. TikTok dostosowuje treści, funkcje i kontrole przy rejestracji do regionu, więc przypadek QA na premierę w Brazylii powinien używać numeru +55, a test lokalizacji dla Filipin numeru +63. Niedopasowanie numeru do rynku konta to częsty powód, dla którego proces zachowuje się inaczej, niż widzą to użytkownicy.

Krok po kroku: API kodu weryfikacyjnego TikTok

Uwierzytelniaj się w https://otproute.com/api/v1 kluczem Bearer zaczynającym się od or_live_ z konsoli deweloperskiej.

1. Ustal identyfikator kraju przez GET /api/v1/countries; identyfikator usługi to tiktok.
2. Odczytaj aktualną cenę: GET /api/v1/prices?country=br&service=tiktok.
3. Utwórz aktywację przez POST /api/v1/activations z treścią {"service": "tiktok", "country": "br"}. Zachowaj identyfikator aktywacji z odpowiedzi.
4. Wpisz zwrócony numer na ekranie telefonu TikToka i poproś o kod.
5. Odbierz go ze zdarzenia activation.sms_received albo odpytuj GET /api/v1/activations/{id} co kilka sekund.
6. Jeśli scenariusz zostanie porzucony, wywołaj POST /api/v1/activations/{id}/cancel, aby środki wróciły od razu.

Limit konta to 300 żądań na minutę, co z zapasem wystarcza do odpytywania kilku aktywacji naraz. Pełne kształty żądań i odpowiedzi podaje dokumentacja API.

Budowa odbiornika webhooków

Zarejestruj w konsoli deweloperskiej endpoint HTTPS (do 5 na konto) i zasubskrybuj activation.sms_received, activation.expired oraz activation.cancelled. Następnie go zabezpiecz:

• Sparsuj X-OTPRoute-Signature na t i v1, oblicz HMAC-SHA256 z <t>.<raw body> przy użyciu sekretu endpointu i porównaj w stałym czasie.
• Odrzucaj znaczniki czasu starsze niż kilka minut, by blokować ataki powtórzeniowe.
• Traktuj identyfikator aktywacji jako klucz idempotencji, aby ponownie dostarczone zdarzenie niczego nie aktualizowało dwa razy.
• Odpowiadaj szybko kodem 2xx, a wolniejszą pracę przekazuj do kolejki.

Zachowaj odpytywanie jako rozwiązanie zapasowe w lokalnym środowisku bez publicznego adresu URL. Nasz przewodnik po zabezpieczaniu webhooków OTP omawia kod weryfikacji.

Rozwiązywanie problemów z kodem TikToka, który się nie pojawia

Cisza ze strony TikToka ma zwykle zwyczajną przyczynę:

1. Poczekaj do końca okna. Aktywacja pozostaje otwarta przez 20 minut; jeśli nic nie dotrze, pełna opłata jest zwracana automatycznie.
2. Pogódź się z tym, że część numerów jest odrzucana. TikTok może odrzucać numery wirtualne w niektórych regionach lub sytuacjach, a zasada zwrotu obejmuje ten przypadek.
3. Zmień jedną zmienną. Spróbuj później albo w innym kraju, który nadal pasuje do testu.
4. Zwolnij. Wielokrotne żądanie kodów w krótkim czasie może uruchomić własne limity TikToka; rozłóż próby w czasie.
5. Sprawdź swoją stronę. Upewnij się, że numer wpisano w pełnym formacie międzynarodowym i że Twój webhook zwrócił 2xx.

Kiedy lepsza jest dedykowana linia z USA lub Kanady?

Aktywacja jednorazowa wystarcza do pojedynczej weryfikacji. Konto marki, które po miesiącach musi zalogować się ponownie, odzyskać dostęp lub przejść kontrole dwuetapowe, potrzebuje numeru, który zespół zachowuje. Numery Dedicated obejmują ten przypadek w Stanach Zjednoczonych i Kanadzie od $1.95/month, z przychodzącymi SMS-ami w panelu i na webhooku przez number.sms_received; zobacz numery wirtualne. Samoobsługowe linie długoterminowe nie są dostępne w innych krajach.

Wszystkie wydatki pochodzą z jednego portfela prepaid w USD, zasilanego kartą lub USDT/USDC, z fakturą PDF za każde doładowanie. Na prośbę można włączyć konto sandbox do testów integracji z symulowanymi kodami.

Najczęstsze pytania

Jak sprawić, by kod TikToka trafiał automatycznie do mojego backendu?

Zamów aktywację z identyfikatorem usługi tiktok, a potem odbierz kod przez podpisany webhook activation.sms_received albo odpytując GET /api/v1/activations/{id}.

Czy mogę przetestować weryfikację SMS TikToka dla konkretnego kraju?

Tak. Wybierz kraj przy tworzeniu aktywacji; trasa TikToka obejmuje obecnie 202 kraje, a aktualną dostępność zwraca endpoint cen.

Ile kosztuje OTP TikToka?

Od $0.20 za kod, w zależności od kraju. Dokładna kwota widnieje w panelu i w GET /api/v1/prices przed zamówieniem.

Co się dzieje, gdy TikTok odrzuci numer wirtualny?

SMS nie dociera, więc aktywacja wygasa po 20 minutach albo ją anulujesz, a pełna kwota wraca do portfela.

Czy numer jednorazowy wystarczy dla konta marki, którym zarządzamy długoterminowo?

Zwykle nie. Do powtarzanych logowań i odzyskiwania użyj numeru Dedicated z USA lub Kanady, który Twój zespół zachowuje na czas odnawiania.

Czy mogę używać OTP Route do tworzenia wielu kont TikTok?

Nie. OTP Route służy do testowania i obsługi własnych, legalnych kont i produktów; przestrzegaj regulaminu TikToka i utrzymuj jedno konto na jedną prawdziwą osobę lub firmę.

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.