Odbieranie kodów SMS X (Twitter): lista kontrolna dla zespołów produktowych i QA

Po co X prosi o numer telefonu?

X wykorzystuje numery telefonów w kilku dobrze znanych miejscach: jako alternatywę dla e-maila przy rejestracji, przy dodawaniu numeru do istniejącego konta, podczas wyzwań logowania wywołanych nietypową aktywnością, przy resetowaniu hasła oraz przy uwierzytelnianiu dwuskładnikowym przez SMS. Na przestrzeni lat X zawęził grono kont, które mogą korzystać z dwuskładnikowego SMS-a, i oferuje aplikacje uwierzytelniające jako opcję, więc sprawdź aktualne ustawienia konta, które testujesz. Każdy z tych przepływów wysyła krótki kod numeryczny i każdy warto objąć testami, jeśli Twój produkt integruje się z kontami X lub nimi zarządza. Typowe przypadki to narzędzie do mediów społecznościowych, które wprowadza konta marek, agencja prowadząca profile klientów ze wspólnego loginu zespołu oraz zestaw QA sprawdzający, jak zachowuje się Twoja aplikacja po powiązaniu przez użytkownika profilu X.

Lista kontrolna przed testami weryfikacji SMS X (Twitter)

• Własność. Konto należy do Ciebie, Twojej firmy lub klienta, który poprosił Cię o zarządzanie nim. Jedno konto na jedną prawdziwą osobę lub firmę.
• Regulamin. Przeczytaj zasady X dotyczące numerów telefonów i automatyzacji; obowiązują one obok naszej polityki dopuszczalnego użytkowania (Acceptable Use Policy).
• Kraj. Zdecyduj, jaki rynek reprezentuje konto, zanim złożysz zamówienie.
• Identyfikator usługi. W OTP Route identyfikator usługi X to twitter.
• Instalacja. Klucz Bearer (or_live_) oraz pętla odpytywania albo endpoint webhooka.
• Czas życia. Czy to konto będzie musiało zalogować się ponownie za miesiąc? Jeśli tak, przeczytaj sekcję o linii dedykowanej, zanim zaczniesz.

Z którego z 198 krajów powinien pochodzić numer?

Trasa X obejmuje 198 krajów, w tym Stany Zjednoczone, Kanadę, Wielką Brytanię, Niemcy, Francję, Indie, Indonezję, Filipiny, Japonię, Brazylię, Meksyk, Turcję, Arabię Saudyjską, Kenię, Nigerię i Ghanę. Dopasuj numer do rynku, który obsługuje konto, lub do przypadku testowego, który sprawdzasz: regionalne konto marki powinno mieć numer ze swojego regionu, a test lokalizacji wymaga języka i formatu numeru danego kraju. Niezgodność numeru, lokalizacji IP i profilu to także rodzaj sygnału, który może wywołać dodatkowe kontrole po stronie X.

Kroki: zamawianie numeru dla X przez API

Bazowy adres URL: https://otproute.com/api/v1.

1. Sprawdź cenę dla swojej pary przez GET /api/v1/prices?country=<id>&service=twitter, co potwierdza też aktualną dostępność.
2. Utwórz zamówienie: POST /api/v1/activations z treścią {"service": "twitter", "country": "<id>"}. Zapisz identyfikator aktywacji.
3. Wpisz zwrócony numer w polu telefonu X.
4. Odbierz kod ze zdarzenia webhooka albo odpytuj GET /api/v1/activations/{id}, aż się pojawi.
5. Jeśli X odrzuci numer, zwolnij go przez POST /api/v1/activations/{id}/cancel.

Identyfikatory krajów pochodzą z GET /api/v1/countries; dokumentacja API pokazuje kształty żądań i odpowiedzi.

Jak zbudować odbiornik webhooków?

Zasubskrybuj activation.sms_received, activation.expired i activation.cancelled. Każde dostarczenie niesie X-OTPRoute-Signature: t=<unix>,v1=<hex>; oblicz HMAC-SHA256 ze znacznika czasu, kropki i surowej treści przy użyciu sekretu endpointu, porównaj w stałym czasie i odrzucaj stare znaczniki czasu. Ponieważ dostarczenia mogą się powtarzać, zapisuj przetworzone identyfikatory aktywacji i ignoruj duplikaty. Odpytywanie jest dobrym rozwiązaniem zapasowym dla małych zestawów, z dużym zapasem w ramach 300 żądań na minutę. Przewodnik po HMAC zawiera działający przykład.

Wolisz klikać? W panelu otwórz OTP Gateway, wybierz X i kraj, potwierdź wyświetloną cenę, wklej numer do X i obserwuj, jak kod pojawia się obok zamówienia.

Rozwiązywanie problemów: X nie wysłał kodu

• Numer został odrzucony. X może odrzucać numery wirtualne, czasem z komunikatem, że numeru nie można użyć. Anuluj, a potem spróbuj później lub w innym kraju.
• Nic jeszcze nie dotarło. Zostaw otwarte 20-minutowe okno, zamiast od razu zamawiać ponownie.
• X ogranicza ruch. Powtarzane żądania z jednego konta mogą uruchomić własne limity X; rozłóż próby w czasie.
• Twój handler to odrzucił. Sprawdź w logach błędy podpisu i inne błędy.
• Konto jest oflagowane. Jeśli X ograniczył samo konto, nowy numer tego nie zmieni; rozwiąż to przez własne kanały wsparcia X.

Zasada zwrotu eliminuje koszt niepowodzenia: płacisz tylko wtedy, gdy kod dotrze, a wygasłe lub anulowane aktywacje zwracają pełną kwotę do portfela.

Kiedy lepsza jest linia dedykowana z USA lub Kanady?

Aktywacja jednorazowa wystarcza do pojedynczej weryfikacji. Konto firmowe, które za kilka miesięcy musi przejść wyzwania logowania lub odzyskać dostęp, potrzebuje numeru, który zostaje na miejscu. Numery Dedicated dają to w Stanach Zjednoczonych i Kanadzie od $1.95/month: przychodzące SMS-y w panelu i na webhooku przez number.sms_received, wychodzące SMS-y i połączenia z przeglądarki. Porównaj oba rozwiązania na stronie numerów wirtualnych. OTP Route rozlicza wszystko z jednego portfela prepaid, zasilanego kartą lub USDT/USDC, z fakturami PDF.

Najczęstsze pytania

Jaki jest identyfikator usługi X (Twitter) w API OTP Route?

To twitter. Użyj go w żądaniu cen i w treści aktywacji.

Czy mogę odebrać OTP X bez karty SIM?

Tak, na numerze OTP Gateway w dowolnym z 198 krajów, widocznym w panelu lub wysłanym na Twój webhook.

Dlaczego X napisał, że mój numer telefonu nie może być użyty?

X może odrzucać niektóre numery wirtualne. Anuluj aktywację, by otrzymać zwrot, i spróbuj w innym kraju lub później.

Ile kosztuje kod weryfikacyjny X?

Od $0.20 za kod; dokładna cena zależy od kraju i jest pokazywana przed zamówieniem.

Czy mogę później użyć tego samego numeru do logowania w X?

Aktywacja jednorazowa odbiera jeden kod. Do powtarzanych logowań użyj numeru dedykowanego z USA lub Kanady.

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

Nie. Służy do testowania i obsługi własnych, legalnych kont i produktów zgodnie z regulaminem X.

Czy istnieje sandbox do budowania integracji?

Tak. Na prośbę konto deweloperskie można przełączyć w tryb sandbox, który zwraca symulowane numery i kody.

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.