Odbieranie czeskich kodów SMS OTP przez endpointy, webhooki lub panel

Na jakich endpointach opiera się Czech Republic OTP API?

Wszystko działa pod adresem https://otproute.com/api/v1 z kluczem Bearer z prefiksem or_live_. Klucze tworzysz w konsoli deweloperskiej, a konto może mieć ich do 10, więc łatwo dać środowisku testowemu, CI i lokalnemu laptopowi osobne dane dostępowe, które można unieważniać niezależnie. Limit wynosi 300 żądań na minutę na konto.

Typowy przebieg dla +420 wygląda tak:

1. Pobierz GET /api/v1/countries i GET /api/v1/services raz na wdrożenie i zapisz w pamięci podręcznej. Identyfikator kraju dla Czech to cz.
2. Zapytaj GET /api/v1/prices?country=cz&service=<id> o bieżącą cenę trasy, której planujesz użyć; zmienia się ona z usługą i dostępnością.
3. Utwórz aktywację przez POST /api/v1/activations z treścią JSON {"service": "<id>", "country": "cz"}. Odpowiedź zawiera identyfikator aktywacji i numer do wpisania w testowanym formularzu rejestracji.
4. Poczekaj na kod — przez webhook albo odczytując GET /api/v1/activations/{id} w umiarkowanych odstępach.
5. Jeśli test zostanie przerwany, zwolnij numer przez POST /api/v1/activations/{id}/cancel, aby blokada natychmiast wróciła do portfela.

Wywołanie GET /api/v1/balance przed dużym zestawem testów to tani sposób, by szybko przerwać, gdy w portfelu brakuje środków. Pełna dokumentacja jest w dokumentacji.

Jak weryfikować webhooki dla aktywacji +420?

Webhooki eliminują odpytywanie i dobrze pasują do równoległych runnerów testów. Skieruj jeden ze swoich endpointów (konsola deweloperska pozwala na 5 na konto) na czeski przepływ i zasubskrybuj activation.sms_received, activation.expired oraz activation.cancelled.

Każde żądanie zawiera nagłówek X-OTPRoute-Signature w postaci t=<unix>,v1=<hex>. Złóż ciąg <t>.<raw body> z nietkniętych bajtów żądania, oblicz HMAC-SHA256 z sekretem tego endpointu, porównaj wynik z v1 w stałym czasie i odrzuć wszystko, czego znacznik czasu jest zbyt stary jak na świeżą dostawę. Nasz przewodnik o zabezpieczaniu webhooków OTP przez HMAC omawia handler linia po linii.

Traktuj zdarzenia jako powiązane z identyfikatorem aktywacji i zadbaj o idempotentność handlera: ponowiona dostawa powinna zastać aktywację już oznaczoną jako zakończoną i po prostu zwrócić sukces. Odpytywanie GET /api/v1/activations/{id} pozostaje dobrą opcją awaryjną dla skryptów uruchamianych tam, gdzie nie ma publicznego endpointu.

Jakie usługi mogą wysyłać kody na czeskie numery?

Czeska trasa obejmuje obecnie ponad 1 700 usług. Popularne nazwy w najnowszym zestawieniu to WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, Microsoft & Outlook, LinkedIn, Discord, Uber, Airbnb, Signal, Viber i ChatGPT (OpenAI).

Ta lista nie jest zamrożona. Dostępność zmienia się w ciągu dnia, więc kod powinien odczytywać ją z API w czasie działania, a nie ze zaszytej tabeli. Jeśli potrzebnej usługi chwilowo brakuje, może się ona pojawić później, a w innych scenariuszach lepiej sprawdzi się sąsiednia trasa środkowoeuropejska.

Jak przechowywać i parsować czeski numer weryfikacyjny?

Czeski plan numeracyjny jest zamknięty: numery krajowe mają dziewięć cyfr i nie ma prefiksu międzymiastowego, więc forma krajowa i międzynarodowa różnią się tylko +420 z przodu. Normalizacja jest więc prostsza niż na wielu rynkach, ale formularze nadal otrzymują spacje, prefiks międzynarodowy 00420 albo gołe dziewięć cyfr. Usuń separatory, zamień 00 na +, dodaj +420, gdy go brakuje, i zapisz wynik w E.164.

Kody z aplikacji kierowanych do Czech zwykle przychodzą po czesku lub angielsku. Czeski tekst zawiera znaki diakrytyczne, takie jak háček i čárka, a niektórzy nadawcy je usuwają, by zmieścić wiadomość w prostym zestawie znaków, więc parser powinien szukać grupy cyfr, a nie dopasowywać całe zdanie.

Zespoły używają numeru +420 do testów, gdy wprowadzają produkt dla czeskich klientów, sprawdzają czeskie teksty onboardingu albo potwierdzają, że regionalny proces rejestracji akceptuje numery bez zera na początku. Strona o testach QA pokazuje, jak zespoły organizują takie przebiegi.

Co powinno się stać, gdy czeski kod nie dotrze?

Niektóre usługi odrzucają numery wirtualne, a niektóre trasy bywają o określonych porach wolniejsze. Nieodebrany kod nic nie kosztuje: jeśli w ciągu 20 minut nie nadejdzie żaden SMS albo wcześniej anulujesz zamówienie, cała kwota wraca automatycznie do portfela.

• Poczekaj do końca okna, zanim uznasz próbę za nieudaną.
• Sprawdź, czy testowana usługa w ogóle akceptuje numery wirtualne.
• Spróbuj później albo przez inną trasę kraju obsługiwaną przez usługę.
• Rób przerwy między próbami; ponowne zamawianie w ciasnej pętli zużywa limit zapytań i rzadko pomaga.
• Zapisuj identyfikator aktywacji przy każdym niepowodzeniu, by wzorce były widoczne między przebiegami.

Czy osoby niebędące programistami mogą używać trasy +420 z panelu?

Tak. Po rejestracji przez e-mail i 6-cyfrowy kod z e-maila (albo logowanie przez Google) otwórz OTP Gateway, wybierz usługę i Czechy, sprawdź wyświetloną cenę i złóż zamówienie. Czeski numer weryfikacyjny pojawia się od razu; wklej go do aplikacji, a kod zobaczysz na tym samym ekranie, gdy nadejdzie. Anulowanie z panelu zwraca kwotę do portfela tak samo jak wywołanie API.

Czy istnieje długoterminowy czeski numer i jak działa rozliczanie?

Obecnie nie ma czeskiego numeru długoterminowego w samoobsłudze. Numery dedykowane to produkt dla USA i Kanady od $1.95/month, obejmujący przychodzące i wychodzące SMS oraz połączenia z przeglądarki; szczegóły na stronie numerów wirtualnych. Jeśli zespół potrzebuje trwałej linii +420, napisz na [email protected], mając na uwadze, że dostępność zależy od lokalnych przepisów i nie jest obiecana.

Rozliczenie opiera się na jednym przedpłaconym portfelu w USD, bez opłaty miesięcznej i bez wyboru planu. Środki wpłacisz kartą lub jako USDT/USDC, a każde doładowanie wywołuje fakturę PDF wysyłaną e-mailem. Do prac integracyjnych na życzenie można przełączyć konto deweloperskie w tryb sandbox, aby symulowane numery i kody przećwiczyły cały przepływ bez wydawania środków z portfela. Dla samego konta dostępne jest też logowanie dwuskładnikowe TOTP.

Najczęstsze pytania

Czy mogę przetestować czeską rejestrację w mojej aplikacji bez czeskiej karty SIM?

Tak. Zamów numer +420 w OTP Gateway dla testowanej usługi, wpisz go w aplikacji i odczytaj kod w panelu, przez API lub webhook.

Jaki jest identyfikator kraju dla Czech w API OTP Route?

Użyj cz w polu country w POST /api/v1/activations oraz w zapytaniach o ceny.

Ile kosztuje czeski kod weryfikacyjny?

Kody zaczynają się od $0.20 za kod, a dokładną cenę dla każdej usługi zwraca GET /api/v1/prices i pokazuje panel przed zamówieniem. Płacisz tylko wtedy, gdy kod dotrze.

Czy czeskie numery wymagają zera na początku?

Nie. Czeskie numery nie mają prefiksu międzymiastowego, więc zapisuj je jako +420 i dziewięć cyfr numeru krajowego.

Jak długo aktywacja +420 pozostaje otwarta?

Dwadzieścia minut. Jeśli w tym czasie nic nie nadejdzie, aktywacja wygasa, a portfel zostaje w całości zwrócony.

Czy routing OTP do Czech nadaje się do masowego zakładania kont?

Nie. OTP Route służy do testowania własnego produktu i obsługi własnych, legalnych kont. Każdą aktywację +420 powiąż z własnym produktem lub kontem, w granicach regulaminu każdej usługi i Acceptable Use Policy OTP Route.

Czy mogę zachować ten sam czeski numer do późniejszych logowań?

Nie jako produkt samoobsługowy. Długoterminowe numery dedykowane istnieją tylko w Stanach Zjednoczonych i Kanadzie, a w sprawie innych rynków możesz napisać do wsparcia.

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.