Automatyzacja weryfikacji SMS +260 w testach rejestracji w Zambii

Jakie endpointy wywołuje integracja Zambia OTP API?

Integracja to krótki łańcuch wywołań HTTPS do https://otproute.com/api/v1, z których każde niesie Authorization: Bearer z kluczem z prefiksem or_live_. Identyfikator kraju Zambii to zm.

• GET /api/v1/countries i GET /api/v1/services: dane referencyjne, które można spokojnie przechowywać w pamięci podręcznej przez dobę.
• GET /api/v1/prices?country=zm&service=<id>: aktualna cena oraz informacja, czy ta trasa może teraz przyjąć zamówienie.
• POST /api/v1/activations z {"service": "whatsapp", "country": "zm"}: zwraca identyfikator aktywacji i numer +260.
• GET /api/v1/activations/{id}: status i, po odebraniu, kod.
• POST /api/v1/activations/{id}/cancel: oddaj numer wcześniej.
• GET /api/v1/balance: uruchom go jako pierwszy, aby zestaw testów szybko zatrzymał się przy pustym portfelu.

Klucze generuj w konsoli Developer, do 10 na konto; jeden na środowisko to porządny wzorzec. Limit konta to 300 żądań na minutę. Pełne schematy znajdziesz w dokumentacji API.

Jak napisać webhook odbierający kody +260?

Polling działa, ale gdy równocześnie trwa kilka aktywacji, czystszy jest webhook. Dodaj do 5 endpointów w konsoli Developer i zasubskrybuj activation.sms_received, activation.expired i activation.cancelled.

Każde żądanie niesie X-OTPRoute-Signature: t=<unix>,v1=<hex>. Zbuduj ciąg <t>.<raw body>, policz HMAC-SHA256 z sekretem endpointu i porównaj z v1 w stałym czasie. Używaj surowych bajtów w takiej postaci, w jakiej przyszły, odrzucaj znaczniki czasu starsze niż kilka minut i zapisuj wyniki pod kluczem identyfikatora aktywacji, aby ponowiona dostawa niczego nie zmieniała. Odpowiadaj szybko kodem 2xx, a wolną pracę wykonuj później. Nasz poradnik o zabezpieczaniu webhooków OTP przez HMAC zawiera więcej szczegółów, a testowanie SMS OTP w pipeline'ach CI pokazuje, gdzie to pasuje w buildzie.

Od jakich usług może odbierać kody numer weryfikacyjny z Zambii?

Migawka na żywo wskazuje dla Zambii ponad 1100 usług. Wśród nich: WhatsApp, Facebook, Google (Gmail & YouTube), Telegram, Instagram, TikTok, X (Twitter), LinkedIn, Uber, imo, Microsoft & Outlook, Amazon i Netflix. Ponieważ trasy zmieniają się z godziny na godzinę, pozwól, by endpoint cen powiedział Twojemu kodowi, co jest otwarte, zanim złożysz zamówienie.

Format zambijskich numerów i języki, w których przychodzą kody

Zambijskie numery wybiera się w kraju z prefiksem krajowym 0, a potem dziewięcioma cyframi. W formie międzynarodowej zero znika, co daje +260 i dziewięć cyfr. Przed zapisem normalizuj wszystko do tej postaci E.164 i upewnij się, że Twoje pole wejściowe akceptuje zarówno lokalny styl, który użytkownicy faktycznie wpisują, jak i międzynarodowy.

Językiem urzędowym jest angielski, a szeroko używane są też takie języki jak bemba, nyanja, tonga i lozi. SMS-y weryfikacyjne zwykle przychodzą po angielsku, co upraszcza parsowanie, ale i tak dopasowuj cyfry, aby zmiana sformułowania przez nadawcę nie psuła Twoich testów.

Zespoły testują w Zambii, gdy rozszerzają działalność na Afrykę Południową, budują wdrożenie dla produktów mobile money lub pożyczkowych albo obsługują klientów z regionalnego centrum operacyjnego. Ten scenariusz opisuje strona wdrożenie w fintech.

Czy to samo można zrobić z panelu?

Tak, i jest to wygodne przy jednorazowych sprawdzeniach. Zaloguj się, otwórz OTP Gateway, wybierz usługę i Zambię, spójrz na wyświetloną cenę i złóż zamówienie. Wpisz numer +260 w aplikacji; kod pojawi się w panelu, gdy dotrze. Anuluj aktywację, której już nie chcesz, a jej kwota wróci do portfela.

Co, jeśli kod nie przyjdzie, i kiedy lepsza jest linia dedykowana?

Aktywacje trwają 20 minut i płacisz tylko wtedy, gdy kod dotrze. Jeśli okno wygaśnie albo anulujesz, cała kwota wraca automatycznie. Niektóre usługi odrzucają numery wirtualne i właśnie dlatego istnieje zwrot środków. Gdy kod +260 jest wolny: poczekaj do końca okna, spróbuj ponownie później lub przez inną trasę usługi, sprawdź, czy usługa akceptuje numery wirtualne, i nie zamawiaj ponownie w ciasnej pętli.

Dla konta, które musi się ponownie logować albo odzyskiwać dostęp w przyszłości, numer jednorazowy to złe narzędzie. Tę rolę pełnią Dedykowane Numery Wirtualne, ale tylko w Stanach Zjednoczonych i Kanadzie, od $1.95/miesiąc. OTP Route nie ma samoobsługowej, długoterminowej linii zambijskiej; jeśli masz realną potrzebę, napisz na [email protected], pamiętając, że decydują lokalne przepisy i nic nie jest zapewnione.

Używaj numerów wyłącznie dla własnych, legalnych produktów i kont, przestrzegaj regulaminów poszczególnych usług i pamiętaj, że obowiązuje Acceptable Use Policy OTP Route.

Jak rozliczana i bezpiecznie testowana jest integracja z Zambią?

Jeden przedpłacony portfel w USD finansuje wszystko; nie ma opłaty miesięcznej ani planu. Zasilaj go kartą lub w USDT/USDC i za każdym razem otrzymuj fakturę PDF e-mailem. Podczas budowania poproś o tryb sandbox dla konta deweloperskiego: symulowane numery i kody pozwalają przećwiczyć całą ścieżkę routingu OTP bez wydatków z portfela. Aktualne stawki są na stronie cennika.

Najczęstsze pytania

Jakiego identyfikatora kraju OTP Route używa dla Zambii?

zm, jak w POST /api/v1/activations z {"service": "telegram", "country": "zm"}.

Czy mogę odbierać zambijskie kody SMS OTP bez zambijskiej karty SIM?

Tak. OTP Gateway udostępnia numer +260 do testów, a kod trafia do Ciebie w panelu, przez webhook lub polling.

Jak poprawnie przechowywać numery +260?

Pomiń krajowy prefiks 0 i zapisz +260 plus dziewięć cyfr w E.164. Formatowanie do wyświetlania wykonuj osobno.

Czy pieniądze wrócą, jeśli WhatsApp lub inna usługa odrzuci numer?

Tak. Gdy w ciągu 20 minut nie dotrze żaden kod albo anulujesz, kwota jest automatycznie zwracana na Twój portfel.

Czy mogę zachować zambijski numer do przyszłych logowań?

Nie w trybie samoobsługowym. Numery długoterminowe to produkt dla USA i Kanady; o Zambię zapytaj e-mailem na [email protected], bez obietnicy.

Czy mogę wypróbować integrację, zanim zapłacę za prawdziwe kody?

Tak. Poproś o tryb sandbox dla konta deweloperskiego, aby otrzymać symulowane numery i kody do testów od początku do końca.

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.