Jak wpiąć argentyńskie (+54) kody weryfikacyjne do swojej integracji

Jakie cztery wywołania API stoją za aktywacją numeru +54?

Wszystko działa pod https://otproute.com/api/v1 i uwierzytelnia się kluczem Bearer zaczynającym się od or_live_. Klucze wystawia się w konsoli deweloperskiej; konto może mieć ich do 10 i zarejestrować 5 endpointów webhooków, a limit wynosi 300 żądań na minutę.

1. Wycena. Wywołaj GET /api/v1/prices?country=ar&service=<id>, aby kod znał cenę na żywo, zanim zablokuje środki z portfela. Identyfikator kraju dla Argentyny to ar.
2. Zamówienie. Wyślij POST /api/v1/activations z treścią JSON {"service": "whatsapp", "country": "ar"}, podstawiając identyfikator usługi potrzebnej w teście. Odpowiedź zawiera identyfikator aktywacji i numer +54 do wpisania w testowanej aplikacji.
3. Oczekiwanie. Odczytuj GET /api/v1/activations/{id} w rozsądnych odstępach albo pozwól, by webhook activation.sms_received powiadomił Cię, że kod dotarł.
4. Wcześniejsze zwolnienie, jeśli trzeba. POST /api/v1/activations/{id}/cancel kończy niepotrzebną aktywację i zwraca pieniądze do portfela.

Jeśli chcesz zobaczyć identyfikatory, zanim wpiszesz je na stałe, GET /api/v1/services i GET /api/v1/countries wyświetlają to, co platforma aktualnie oferuje. Pełna dokumentacja jest w dokumentacji.

Jak zabezpieczyć odbiornik webhooków dla argentyńskich kodów?

Każde dostarczenie zawiera nagłówek X-OTPRoute-Signature w postaci t=<unix>,v1=<hex>. Zbuduj ciąg "<t>.<raw body>", oblicz HMAC-SHA256 z sekretem danego endpointu i porównaj wynik z v1 funkcją działającą w stałym czasie. Odrzucaj każde żądanie z nieaktualnym znacznikiem czasu, ponieważ stary, ale ważny podpis to dokładnie to, jak wygląda atak powtórzeniowy.

Poza activation.sms_received zasubskrybuj activation.expired i activation.cancelled, aby runner testów nie zawisł w oczekiwaniu na numer, który już się zamknął. Traktuj każde zdarzenie jako powiązane z identyfikatorem aktywacji i napisz handler tak, by drugie dostarczenie tego samego zdarzenia niczego nie zmieniło. Wpis o podpisywaniu i weryfikacji webhooków OTP omawia logikę porównania dokładniej.

Z jakimi aplikacjami mogę zweryfikować argentyński numer?

Aktualny przegląd dla Argentyny obejmuje ponad 2000 usług. Te, po które zespoły produktowe i QA z Argentyny sięgają najczęściej, to:

• Komunikatory: WhatsApp, Telegram, Signal, Discord
• Konta i produktywność: Google (Gmail & YouTube), Microsoft & Outlook, LinkedIn, ChatGPT (OpenAI)
• Social media i wideo: Instagram, TikTok
• Handel i mobilność: Amazon, Uber, Airbnb, Netflix

Lista zmienia się w ciągu dnia, dlatego API podaje dostępność na żywo, a nie w statycznej tabeli. Zapytaj GET /api/v1/services z myślą o kraju ar przed startem zaplanowanego zadania CI i szybko zakończ je czytelnym komunikatem, jeśli docelowej usługi chwilowo brakuje.

Dlaczego argentyńskie numery komórkowe sprawiają kłopot walidatorom telefonów?

Argentyna ma jeden z bardziej nietypowych planów numeracyjnych w regionie. W kraju zapisuje się prefiks międzymiastowy 0 przed numerem kierunkowym, a dla komórek 15 przed cyframi abonenta, więc telefon z Buenos Aires może wyglądać jak 011 15 i osiem cyfr. W międzynarodowej formie E.164 oba te elementy znikają, a zaraz po kodzie kraju pojawia się 9: +54 9 11, a potem ośmiocyfrowy numer abonenta.

Ma to znaczenie dla każdego, kto przechowuje numery telefonów. Normalizuj wszystko do E.164 przed zapisem, usuwaj 0 i 15 przy wprowadzaniu i dodawaj 9 dla numerów komórkowych. Walidator sprawdzający tylko długość chętnie zaakceptuje wartość w stylu numeru stacjonarnego +54 11, która nie odbierze SMS-a. Używaj numeru dokładnie w takiej postaci, w jakiej zwraca go API, zamiast formatować go samodzielnie.

Kody wysyłane na argentyńskie numery zwykle przychodzą po hiszpańsku, często z frazą w rodzaju „Tu código es” wokół cyfr. Kod numeryczny wyciągaj wzorcem, a nie dopasowaniem słów, bo szablony się zmieniają. Zespoły testują tu przy wejściu do Ameryki Łacińskiej, sprawdzaniu tekstów w hiszpańskim rioplatense (lokalne formy vos różnią się od podręcznikowego hiszpańskiego), prowadzeniu operacji regionalnych albo obsłudze Argentyńczyków mieszkających za granicą, którzy nadal rejestrują się z kartą SIM +54.

Czy osoba bez umiejętności programowania zamówi numer +54?

Tak. Pracownicy wsparcia, wzrostu i agencji mogą zrobić wszystko w przeglądarce:

1. Załóż konto na stronie rejestracji za pomocą adresu e-mail i 6-cyfrowego kodu albo logowania przez Google.
2. Zasil portfel.
3. Otwórz OTP Gateway, wybierz Argentynę, a następnie usługę, którą testujesz.
4. Sprawdź pokazaną cenę, zatwierdź i skopiuj numer +54 na ekran weryfikacji w aplikacji.
5. Obserwuj aktywację; kod pojawi się tam, gdy tylko zostanie odebrany.

Panel i API korzystają z tego samego portfela i tych samych aktywacji, więc programista może przejąć numer zamówiony przez kolegę, posługując się identyfikatorem aktywacji.

Argentyński kod się nie pojawił. Co dalej?

Każda aktywacja pozostaje otwarta przez 20 minut. Jeśli nic nie przyjdzie albo wcześniej anulujesz, pełna kwota automatycznie wraca do portfela, więc milcząca trasa kosztuje Cię czas, a nie pieniądze. Szybkość dostarczenia zależy od usługi i trasy, dlatego daj oknu uczciwą szansę, zanim uznasz próbę za nieudaną.

Potem przejdź przez krótką listę:

• Poproś raz o ponowne wysłanie kodu z poziomu aplikacji, a następnie pozwól oknu upłynąć.
• Spróbuj później w ciągu dnia albo zamów przez inną trasę dla tej samej usługi.
• Upewnij się, że usługa w ogóle akceptuje numery wirtualne; niektóre je odrzucają, i właśnie dlatego istnieje automatyczny zwrot.
• Unikaj ponawiania zamówień w ciasnej pętli z CI. Dodaj opóźnienie narastające i limit ponowień.

Nasz tekst o ograniczaniu nieudanych dostarczeń OTP opisuje dalsze wzorce dla tras argentyńskich. Każdy test prowadź zgodnie z regulaminem usługi; obowiązuje też Polityka dozwolonego użytkowania OTP Route.

Czy możemy zatrzymać argentyńską linię i jak płacić?

Nie ma obecnie samoobsługowego numeru długoterminowego dla Argentyny. Jeśli zespół potrzebuje stałej linii +54, napisz na [email protected] i opisz scenariusz; to, czy da się ją zorganizować, zależy od lokalnych przepisów i nie jest pewne. Numery dedykowane (Dedicated Virtual Numbers), które zatrzymujesz na czas odnawiania i które przekazują przychodzące SMS-y na Twój webhook, to produkt dla Stanów Zjednoczonych i Kanady, od $1.95/month.

Rozliczenia działają przez jeden przedpłacony portfel w USD, bez opłaty miesięcznej i bez wyboru planu. Zasilisz go kartą albo stablecoinami USDT/USDC, a każde zasilenie generuje fakturę PDF wysyłaną e-mailem. Szczegóły są na stronie cennika. Zanim wydasz prawdziwe środki, poproś o przełączenie konta deweloperskiego na sandbox, który zwraca symulowane numery i kody, abyś mógł przećwiczyć cały przepływ dla Argentyny od początku do końca.

Najczęstsze pytania

Jaki jest identyfikator kraju dla Argentyny w API OTP Route?

To ar. Przekaż go w polu country w POST /api/v1/activations oraz w zapytaniu GET /api/v1/prices.

Czy muszę dodać 9, wpisując numer +54 w aplikacji?

Użyj numeru dokładnie w takiej postaci, w jakiej zwraca go OTP Route. We własnej bazie przechowuj argentyńskie numery komórkowe w formacie E.164, który zawiera 9 po +54 i pomija krajowe 0 oraz 15.

Ile kosztuje odebranie argentyńskiego SMS-a OTP?

Od $0.20 za kod, zależnie od usługi. Dokładną kwotę zwraca GET /api/v1/prices i jest ona wyświetlana przed zatwierdzeniem zamówienia.

Czy mogę przetestować argentyński proces rejestracji w mojej aplikacji bez lokalnej karty SIM?

Tak. Zamów aktywację dla Argentyny dla własnej aplikacji lub zewnętrznej usługi w teście, wpisz numer +54 i odczytaj kod w panelu lub z webhooka.

Czy ten sam numer +54 zadziała ponownie przy logowaniu w przyszłym miesiącu?

Nie. Numer bramki obsługuje jeden kod w ciągu 20 minut. Dla kont, które muszą dalej odbierać kody, odpowiednim rozwiązaniem jest Numer dedykowany w USA lub Kanadzie.

W jakim języku będzie argentyński SMS weryfikacyjny?

Zwykle po hiszpańsku, choć zależy to od nadawcy i ustawień językowych konta. Wyciągaj cyfry, zamiast polegać na otaczających słowach.

Czy odpytywanie jest akceptowalną alternatywą dla webhooków?

Tak. Odpytuj GET /api/v1/activations/{id} w umiarkowanych odstępach i pozostań znacznie poniżej limitu 300 żądań na minutę na konto.

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.