Odbieranie indyjskich (+91) kodów weryfikacyjnych przez API

Jak wygląda sekwencja wywołań India OTP API?

Cały przepływ to kilka żądań względem https://otproute.com/api/v1, uwierzytelnionych kluczem Bearer zaczynającym się od or_live_. Klucze pochodzą z konsoli Developer, do 10 na konto, więc każde środowisko może mieć własny.

1. Wywołaj raz GET /api/v1/countries i zapisz wynik w pamięci podręcznej. Id kraju Indii to in.
2. Wywołaj GET /api/v1/prices?country=in&service=<id> dla testowanej usługi. Zwraca cenę i dostępność na żywo, więc odczytuj ją w każdym przebiegu.
3. Zamów przez POST /api/v1/activations z treścią JSON taką jak {"service": "telegram", "country": "in"}. Odpowiedź daje id aktywacji i numer +91.
4. Wpisz ten numer na ekranie rejestracji lub logowania własnej aplikacji.
5. Odbierz kod przez webhook albo odpytując GET /api/v1/activations/{id}. Jeśli test padnie wcześniej, wywołaj POST /api/v1/activations/{id}/cancel.

Na początku zestawu testów sprawdź GET /api/v1/balance, aby przebieg szybko się wywalił. API pozwala na 300 żądań na minutę, co w zupełności wystarcza do odpytywania co kilka sekund. Szczegóły żądań i odpowiedzi znajdziesz w dokumentacji API.

Jak zbudować handler webhooka dla kodów +91?

Podpisany webhook skaluje się lepiej niż odpytywanie, gdy zadania działają równolegle. Zarejestruj endpoint w konsoli Developer (do 5 na konto) i nasłuchuj activation.sms_received, activation.expired i activation.cancelled.

Każde dostarczenie niesie nagłówek X-OTPRoute-Signature w postaci t=<unix>,v1=<hex>. Aby go sprawdzić, oblicz HMAC-SHA256 z ciągu <t>.<raw body> przy użyciu sekretu tego endpointu i porównaj wynik z v1 w stałym czasie. Dwa szczegóły potrafią zaskoczyć:

• Haszuj surowe bajty żądania, nigdy ponownie zserializowany obiekt JSON; kolejność kluczy i białe znaki zmieniają skrót.
• Odrzucaj znaczniki czasu starsze niż kilka minut, aby przechwyconego żądania nie dało się odtworzyć.

Kluczuj zapisy id aktywacji, aby zduplikowane dostarczenie stało się operacją pustą, i potwierdzaj kodem 2xx, zanim zrobisz coś wolnego. Nasz tekst o zabezpieczaniu webhooków OTP przez HMAC omawia krok porównania linijka po linijce.

Które usługi mogą wysyłać kody na numery indyjskie?

Trasa indyjska obejmuje obecnie ponad 2300 usług. Do popularnych pozycji w migawce na żywo należą WhatsApp, Telegram, Google (Gmail & YouTube), Instagram, Facebook, X (Twitter), ChatGPT (OpenAI), Microsoft & Outlook, Amazon, LinkedIn, Discord, Uber i Snapchat.

Dostępność zmienia się w ciągu dnia, dlatego API raportuje ją na żywo. Jeśli Twoja macierz testów zależy od jednej usługi, zapytaj o ceny dla in przed przebiegiem i czysto go pomiń, gdy ta trasa jest zamknięta. Używaj tych tras tylko dla własnych produktów i kont, przestrzegaj regulaminu każdej usługi i pamiętaj, że obowiązuje Polityka dopuszczalnego użytkowania OTP Route.

Czy osoby nietechniczne mogą zamówić numer weryfikacyjny z Indii z panelu?

Tak. Pracownicy operacji i opiekunowie kont w agencjach mogą pominąć API:

1. Załóż konto z adresem e-mail i 6-cyfrowym kodem z e-maila albo przez logowanie Google, a następnie włącz uwierzytelnianie dwuskładnikowe TOTP.
2. Doładuj portfel.
3. Wybierz Indie i usługę, sprawdź cenę na ekranie i złóż zamówienie.
4. Wpisz numer +91 w aplikacji, którą konfigurujesz; kod pojawi się na stronie aktywacji, gdy tylko SMS dotrze.

Panel i API dzielą jedno okno, jedną regułę zwrotu i jeden portfel.

Co zrobić, gdy kod nie dotrze w ciągu 20 minut?

Każda aktywacja pozostaje otwarta przez 20 minut. Płacisz tylko wtedy, gdy SMS dotrze: gdy okno skończy się puste albo najpierw anulujesz, pełna kwota automatycznie wraca do portfela, a Twój webhook otrzymuje activation.expired lub activation.cancelled.

Jeśli kodu brakuje:

• Poczekaj do końca okna, zanim zareagujesz; usługa może po prostu wysyłać wolniej niż zwykle.
• Potwierdź, że usługa w ogóle akceptuje numery wirtualne. Niektóre platformy je odrzucają, co jest ich polityką, a nie usterką dostarczania.
• Spróbuj ponownie później albo przetestuj inną trasę usługi.
• Nigdy nie zamawiaj ponownie w ciasnej pętli. Stosuj backoff między próbami, by nie tracić wysiłku na trasie, która odrzuca numery.

Dłuższe omówienie strategii ponowień jest w tekście o ograniczaniu nieudanych dostaw OTP.

Jak przechowywać i normalizować indyjskie numery telefonów?

Indyjskie numery komórkowe mają dziesięć cyfr i w praktyce zaczynają się od 6, 7, 8 lub 9. W Indiach ludzie często zapisują je z wiodącym prefiksem krajowym 0 albo dzielą na pięć i pięć spacją. Format międzynarodowy pomija to 0 i dodaje kod kraju, dając +91 i dziesięć cyfr.

Przechowuj wyłącznie formę E.164: +91 i dziesięć cyfr, bez spacji, łączników i zera. Normalizuj dane wejściowe na brzegu, usuwając formatowanie, wiodące 0 albo samo 91 wpisane bez plusa. Zapobiega to duplikatom użytkowników różniących się tylko formatowaniem.

Większość SMS-ów weryfikacyjnych w Indiach przychodzi po angielsku i od nadawcy alfanumerycznego, a nie z numeru telefonu. Niektóre aplikacje wysyłają jednak po hindi lub w innym języku regionalnym, więc testuj parser kodu także na pismach nielacińskich.

Dlaczego zespoły produktowe potrzebują numeru +91 do testów?

Indie to częsty rynek startowy dla aplikacji konsumenckich, onboardingu fintechowego i marketplace'ów, a użytkownicy oczekują kroku SMS przy rejestracji. Zespoły używają tras +91, by przećwiczyć start, przeprowadzić QA lokalizacji na interfejsach hindi, tamilskim, telugu, bengalskim, marathi i innych, wesprzeć regionalnych pracowników operacyjnych oraz sprawdzić przepływy klientów z indyjskiej diaspory za granicą, którzy nadal logują się numerem z kraju. Dobry routing OTP polega tu na wyborze trasy usługi zgodnej z realną ścieżką użytkownika, a następnie podpięciu jej do tych samych wywołań SMS verification API, których używasz na innych rynkach.

Czy jest długoterminowa linia indyjska i jak działają rozliczenia?

Nie. Numery dedykowane to produkt dla USA i Kanady, od $1.95/month, i z panelu nie kupisz długoterminowej linii indyjskiej. Jeśli jej potrzebujesz, napisz na [email protected]; dostępność zależy od lokalnych przepisów i nie jest gwarantowana.

Rozliczenia opierają się na jednym przedpłaconym portfelu w USD, bez opłaty miesięcznej i bez planu do wyboru. Doładuj kartą lub stablecoinami USDT/USDC, a każde doładowanie przychodzi z fakturą PDF e-mailem. Do prac integracyjnych poproś wsparcie o przełączenie konta deweloperskiego na sandbox: zwraca symulowane numery i kody, więc możesz przetestować handler webhooka od początku do końca bez wydawania środków z portfela.

Najczęstsze pytania

Czy mogę przetestować indyjską rejestrację w mojej aplikacji bez lokalnej karty SIM?

Tak. Zamów numer +91 w OTP Gateway, wpisz go na ekranie rejestracji i odczytaj kod z panelu, API lub swojego webhooka.

Jakie jest id kraju dla Indii w API OTP Route?

To in. Przekaż je jako kraj w GET /api/v1/prices i w treści POST /api/v1/activations.

Ile kosztuje odebranie SMS OTP z Indii?

Kody zaczynają się od $0.20 za kod, a dokładna cena zależy od usługi. Widzisz ją przed zamówieniem, a aktywacja bez kodu jest zwracana do portfela.

Czy mogę użyć tego samego numeru +91, by zalogować się ponownie w przyszłym miesiącu?

Nie. Numer bramki obsługuje jeden kod weryfikacyjny. Konta wymagające powtarzanych logowań należą na linię dedykowaną, a takie istnieją tylko w USA i Kanadzie.

Czy jest sandbox do budowania integracji dla Indii?

Tak, na życzenie. Wsparcie może przenieść konto deweloperskie do sandboxa, gdzie symulowane numery i kody przepływają przez Twój kod, nie ruszając portfela.

Czy nasz dział finansów może płacić stablecoinami?

Tak. Portfel przyjmuje płatności kartą oraz USDT i USDC, a każde doładowanie generuje fakturę PDF e-mailem.

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.