Droga dewelopera do laotańskich (+856) kodów jednorazowych

Jaka jest najkrótsza droga od klucza API do kodu +856?

Zacznij w konsoli deweloperskiej: utwórz klucz Bearer (zaczyna się od or_live_) i trzymaj po jednym na środowisko, bo konto pozwala na dziesięć. Wszystkie żądania trafiają na https://otproute.com/api/v1, a identyfikator kraju dla Laosu to la. Minimalny przebieg wygląda tak:

1. Pobierz identyfikator usługi z GET /api/v1/services; identyfikatory krajów pochodzą z GET /api/v1/countries.
2. Zapytaj GET /api/v1/prices?country=la&service=<id>, ile kosztuje zamówienie i czy dana para jest w tej chwili dostępna.
3. Utwórz aktywację przez POST /api/v1/activations z treścią w rodzaju {"service": "telegram", "country": "la"}. Odpowiedź zawiera identyfikator aktywacji i numer laotański.
4. Wpisz numer w testowanej aplikacji, a potem poczekaj na kod.
5. Jeśli test zostanie przerwany wcześniej, POST /api/v1/activations/{id}/cancel zwalnia blokadę.

To cała powierzchnia API OTP dla Laosu, jakiej potrzebuje podstawowy test. Przegląd dla deweloperów i pełna dokumentacja opisują odpowiedzi i kody błędów.

Odpytywanie czy webhooki: co lepsze dla testów w Laosie?

Dla jednorazowego skryptu odpytywanie GET /api/v1/activations/{id} co kilka sekund jest w zupełności rozsądne; przy 300 żądaniach na minutę na konto kilka równoległych zadań nadal się zmieści. Większym zestawom testów lepiej służy dostarczanie push. Dodaj do pięciu endpointów webhooków i nasłuchuj activation.sms_received, activation.expired oraz activation.cancelled.

Handler odbierający ma trzy zadania. Po pierwsze, zweryfikować X-OTPRoute-Signature (t=<unix>,v1=<hex>), obliczając HMAC-SHA256 z <t>.<raw body> przy użyciu sekretu endpointu. Po drugie, odrzucać nieaktualne znaczniki czasu. Po trzecie, pozostać idempotentnym przez zapisywanie identyfikatora aktywacji, aby ponownie dostarczone zdarzenie nic nie zmieniało. Więcej wzorców znajdziesz we wpisie o przechwytywaniu OTP przez webhooki.

Jak zapisuje się numery laotańskie i w jakim języku przychodzą kody?

W kraju numery laotańskie wybiera się z prefiksem krajowym 0, a w formacie międzynarodowym to zero znika. Numery komórkowe zwykle zaczynają się od 20 po kodzie kraju, więc lokalny numer 020 staje się w E.164 +856 20 z dalszymi cyframi abonenta. Przechowuj formę E.164 i podczas normalizacji usuwaj zero prefiksu; w przeciwnym razie wyszukiwanie w tabeli użytkowników nie wykryje duplikatów zapisanych na oba sposoby.

Językiem urzędowym jest laotański, który ma własne pismo. Jeśli Twój produkt wysyła zlokalizowane szablony OTP, upewnij się, że znaki laotańskie przetrwają kodowanie SMS i że cyfry pozostają łatwe do zauważenia, bo długa wiadomość Unicode może zostać podzielona na kilka części. Wiele międzynarodowych usług zachowuje na tym rynku angielski tekst weryfikacji, więc Twój parser powinien radzić sobie z obiema wersjami.

Dlaczego zespoły produktowe testują w Laosie?

Kraj graniczy z Tajlandią, Wietnamem, Chinami, Kambodżą i Mjanmą, a wiele regionalnych aplikacji traktuje go jako część szerszego wdrożenia w regionie Mekongu. Zespoły zwykle potrzebują numeru +856 do testów, gdy dodają laotański do wydania z lokalizacją, uruchamiają transgraniczny portfel lub produkt dostawczy albo obsługują użytkowników przemieszczających się między Laosem a sąsiednimi rynkami. Przejście rejestracji przez prawdziwą trasę laotańską wychwytuje problemy z formatowaniem, limitami i szablonami, zanim zgłoszą je klienci. Przewodnik po routingu krajów wyjaśnia, jak podejmuje się decyzje o routingu OTP dla poszczególnych rynków.

Które usługi są otwarte na trasach +856?

Aktualny katalog dla la zawiera ponad 1,700 usług. Do popularnych w chwili pisania należą WhatsApp, Facebook, LINE, WeChat, TikTok, Telegram, Google (Gmail & YouTube), imo, Shopee, Lazada, Zalo, Instagram i ChatGPT (OpenAI). Dostępność zmienia się wraz z mocami partnerów, więc przy każdym uruchomieniu pozwól odpowiedzieć na to pytanie endpointowi cen.

Bez kodu proces w panelu jest krótki: wybierz usługę, wybierz Laos, sprawdź wyświetloną cenę, złóż zamówienie i obserwuj kartę aktywacji w oczekiwaniu na kod.

Co zrobić, gdy kod z Laosu nie przychodzi?

Każda aktywacja przetrzymuje numer przez 20 minut. Płacisz tylko wtedy, gdy kod dotrze; po wygaśnięciu lub anulowaniu środki wracają do portfela automatycznie.

• Daj oknu pełny czas, zanim uznasz, że trasa zawiodła.
• Nie zamawiaj ponownie w ciasnej pętli; rozłóż próby w czasie lub wróć później.
• Jeśli jedna trasa ciągle wygasa, przełącz się na inną trasę usługi dla tego samego przypadku testowego.
• Sprawdź, czy aplikacja akceptuje numery wirtualne, bo niektóre je odrzucają.
• Upewnij się, że formularz wysłał +856 bez doklejonego zera prefiksu.

Linie długoterminowe, rozliczenia i sandbox dla Laosu

OTP Route nie oferuje samoobsługowego długoterminowego numeru laotańskiego. Dedicated Numbers to produkt dla USA i Kanady od $1.95/miesiąc; w sprawie linii +856 napisz na [email protected], a zespół powie, czy lokalne przepisy na to pozwalają, bez żadnej obietnicy.

Płatność odbywa się na zasadzie pay as you go z przedpłaconego portfela w USD: bez abonamentu, doładowania kartą lub w USDT/USDC i faktura PDF wysyłana e-mailem po każdym z nich. Do pracy w CI poproś o przełączenie konta deweloperskiego na sandbox, aby symulowane numery i kody przechodziły przez te same endpointy bez kosztów. Szczegóły są na stronie z cennikiem.

Najczęstsze pytania

Czy mogę zweryfikować rejestrację mojej aplikacji w Laosie bez laotańskiej karty SIM?

Tak. Zamów numer +856 w OTP Gateway, użyj go na ekranie rejestracji i odbierz kod przez API, webhook lub panel.

Jakiego identyfikatora kraju OTP Route używa dla Laosu?

To la. Użyj go w zapytaniu o ceny i w treści żądania aktywacji.

Czy zachować początkowe 0 w numerach laotańskich?

Tylko przy wybieraniu krajowym. W E.164 oraz w Twojej bazie danych pomiń je i zapisuj +856 z numerem krajowym.

Ile kosztuje laotański numer weryfikacyjny?

Od $0.20 za kod. Dokładna cena zależy od usługi i jest zwracana przez GET /api/v1/prices przed zamówieniem.

Czy zwrot jest automatyczny, jeśli kod nie przyjdzie?

Tak. Jeśli SMS nie dotrze w ciągu 20 minut albo anulujesz zamówienie, cała kwota wraca do Twojego portfela.

Co oznacza dopuszczalne użycie numerów +856?

Testowanie własnych laotańskich procesów rejestracji i obsługa kont, które Twoja firma legalnie posiada. OTP Route oczekuje przestrzegania regulaminów usług i Acceptable Use Policy, czyli jednego konta na osobę lub firmę.

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.