Wpinanie kazachskich kodów weryfikacyjnych +7 w zestaw testów

Z jakich endpointów korzysta przebieg OTP dla Kazachstanu?

Pełny cykl to pięć lub sześć żądań do https://otproute.com/api/v1, podpisanych kluczem Bearer zaczynającym się od or_live_. Identyfikator kraju dla Kazachstanu to kz, a konto może mieć do 10 kluczy, więc CI, staging i laptop programisty mogą mieć własne.

• GET /api/v1/balance na początku zadania, aby pusty portfel od razu przerywał przebieg.
• GET /api/v1/prices?country=kz&service=telegram, aby odczytać aktualną cenę i dostępność tej pary.
• POST /api/v1/activations z {"service": "telegram", "country": "kz"}, co zwraca identyfikator aktywacji i numer +7.
• GET /api/v1/activations/{id}, jeśli odpytujesz, albo nic, jeśli polegasz na webhookach.
• POST /api/v1/activations/{id}/cancel, gdy test kończy się, zanim kod będzie potrzebny.

Limit to 300 żądań na minutę na konto, co zostawia miejsce na równoległe zadania odpytujące co kilka sekund. Jeśli to Twoja pierwsza integracja, zacznij od przewodnika integracji API.

Jak odbierać kody +7 przez webhook zamiast odpytywania?

Zarejestruj endpoint w konsoli Developer (pięć na konto) i zasubskrybuj activation.sms_received, activation.expired oraz activation.cancelled. Każdy POST niesie X-OTPRoute-Signature: t=<unix>,v1=<hex>.

Odtwórz podpis jako HMAC-SHA256 z <t>.<raw body> przy użyciu sekretu endpointu i porównaj w stałym czasie. Używaj surowych bajtów w postaci, w jakiej przyszły, bo ponownie zserializowany JSON daje inny skrót, i odrzucaj znaczniki czasu spoza krótkiej tolerancji, by zatrzymać powtórzenia. Ponieważ dostarczenie może zostać ponowione, rób upsert względem identyfikatora aktywacji, aby druga kopia niczego nie zmieniała. Szczegółowy opis krok po kroku znajdziesz w przechwytywaniu OTP przez webhooki.

Jakie aplikacje mogą wysyłać kody na numer kazachski?

Trasa kz obejmuje ponad 1700 usług. Do popularnych w najnowszym zestawieniu należą Telegram, WhatsApp, Google (Gmail & YouTube), Instagram, TikTok, Facebook, Viber, Discord, Microsoft & Outlook, LinkedIn, Uber, AliExpress i Amazon.

Nie zamrażaj tej listy w kodzie. Trasy zmieniają się w ciągu dnia, więc skrypt powinien sprawdzać GET /api/v1/prices przed każdym zamówieniem i wybierać zapasowy identyfikator usługi, gdy dana para jest niedostępna.

Dlaczego +7 wymaga szczególnej uwagi w bazie numerów telefonów?

Kazachstan dzieli numer kierunkowy 7 z Rosją. Oba kraje używają dziesięciocyfrowych numerów krajowych, a kazachskie zakresy komórkowe zwykle zaczynają się od 7 po numerze kierunkowym kraju, więc numer taki jak +7 7xx xxx xx xx jest kazachski, podczas gdy wiele rosyjskich komórek zaczyna się od 9. Nigdy nie wnioskuj kraju wyłącznie z numeru kierunkowego; ustalaj go na podstawie zakresu numeru za pomocą utrzymywanej biblioteki telefonicznej albo trzymaj jawne pole kraju.

W kraju wybiera się prefiks 8 przed dziesięcioma cyframi. Usuń go przy wprowadzaniu i zapisz formę E.164, czyli +7 i numer krajowy. Kazachski jest językiem państwowym, a rosyjski jest także szeroko używany urzędowo, więc teksty weryfikacyjne mogą przychodzić po rosyjsku, kazachsku lub angielsku, zwykle cyrylicą. Upewnij się, że parser SMS i logi obsługują UTF-8 i wyodrębniają cyfry, a nie brzmienie tekstu.

Zespoły testują tu, gdy startują w Azji Środkowej, sprawdzają dwujęzyczną lokalizację albo wspierają regionalnych pracowników operacyjnych.

Czy jest ścieżka przez panel dla zespołów, które nie programują?

Tak. Po rejestracji z kodem e-mail lub przez Google zasil portfel, wybierz Kazachstan i usługę, potwierdź wyświetloną cenę i złóż zamówienie. Numer +7, a później kod, pojawiają się na karcie aktywacji. Menedżerowie produktu i testerzy lokalizacji używają tego do wyrywkowych kontroli, podczas gdy potok obsługuje wolumen.

Czy kazachski numer można zachować do powtarzanych logowań?

Nie ma na to opcji samoobsługowej. Numery OTP Gateway obsługują pojedynczy kod, a długoterminowe Numery dedykowane sprzedajemy tylko dla Stanów Zjednoczonych i Kanady, od $1.95/month, z odbiorem i wysyłaniem SMS oraz połączeniami w przeglądarce. Jeśli potrzebujesz długotrwałej linii kazachskiej, napisz na [email protected]; to, czy da się ją zorganizować, zależy od lokalnych przepisów i nie jest pewne. Dla kont stagingowych, które muszą logować się ponownie, praktyczną odpowiedzią jest często linia amerykańska lub kanadyjska, jeśli usługa ją akceptuje.

Co się dzieje, gdy kod nie dotrze w ciągu 20 minut?

Aktywacja wygasa, webhook wysyła activation.expired, a pełna kwota wraca do portfela bez żadnej akcji z Twojej strony. Potem zdiagnozuj przyczynę, zanim spróbujesz ponownie:

• Czy numer wpisano z +7, a nie z krajowym 8?
• Czy usługa odrzuca numery wirtualne? Niektóre tak, i dlatego OTP Route zwraca niewykorzystane aktywacje.
• Spróbuj później lub na innej trasie, zamiast pętli natychmiastowych ponowień; krótki backoff utrzymuje czytelność logów.

Szybkość dostarczenia zależy od usługi i trasy, więc unikaj ciasnych limitów czasu w testach.

Jak rozlicza się konto?

Jeden przedpłacony portfel w USD, pay as you go, bez abonamentu i bez poziomów planów. Doładuj kartą lub stablecoinami USDT albo USDC; każde doładowanie i zakup numeru generuje fakturę PDF wysyłaną e-mailem. Konta deweloperskie można na prośbę przełączyć na sandbox, który zwraca symulowane numery i kody do testów od początku do końca. Używaj usługi do własnych legalnych produktów, przestrzegaj regulaminu każdej aplikacji i Zasad dopuszczalnego użytkowania, a aktualne stawki znajdziesz w cenniku.

Najczęstsze pytania

Jak odróżnić kazachski numer +7 od rosyjskiego?

Patrz na zakres numeru, a nie tylko na numer kierunkowy kraju. Kazachskie komórki zwykle zaczynają się od 7 po +7; utrzymywana biblioteka numerów telefonicznych lub jawne pole kraju pozwala uniknąć pomyłek.

Jaki jest identyfikator Kazachstanu w API OTP Route?

Użyj kz w ciele aktywacji i w parametrze country endpointu cen.

Czy mogę przetestować kazachski proces rejestracji w mojej aplikacji bez lokalnej karty SIM?

Tak. Zamów numer +7 dla Kazachstanu z OTP Gateway, wpisz go w swoim procesie i odbierz kod przez webhook, odpytywanie lub panel.

Czy zapłacę, jeśli kod z Telegrama nigdy nie dotrze?

Nie. Bez SMS-a w ciągu 20-minutowego okna lub po anulowaniu kwota wraca automatycznie do portfela.

Czy kazachskie SMS-y weryfikacyjne przychodzą po rosyjsku czy po kazachsku?

Możliwe jest jedno i drugie, a niektóre usługi używają angielskiego. Wyodrębniaj kod liczbowy i upewnij się, że Twój stos obsługuje tekst cyrylicą.

Czy trasa Kazachstanu wiąże się z opłatą miesięczną?

Nie. OTP Route działa w modelu pay as you go z przedpłaconego portfela w USD zasilanego kartą, USDT lub USDC.

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.