Odbieranie kodów SMS z Botswany jednym wywołaniem API

Przez jakie wywołania API przechodzi aktywacja dla Botswany?

Wszystko działa pod https://otproute.com/api/v1 i uwierzytelnia się kluczem Bearer zaczynającym się od or_live_. Klucze tworzysz w konsoli deweloperskiej; konto może mieć ich do 10, a limit wynosi 300 żądań na minutę, co w zupełności wystarcza zestawowi testów zamawiającemu na przebieg kilka numerów z Botswany.

Typowa sekwencja wygląda tak:

1. Wywołaj raz GET /api/v1/countries i zapisz wynik w pamięci podręcznej, aby kod wiedział, że bw to identyfikator Botswany.
2. Zapytaj GET /api/v1/prices?country=bw&service=whatsapp o cenę na żywo i dostępność potrzebnej pary. Ceny różnią się zależnie od usługi i kraju, więc odczytuj je, zamiast wpisywać na stałe.
3. Wyślij POST /api/v1/activations z treścią {"service": "whatsapp", "country": "bw"}. Odpowiedź zawiera numer +267 i identyfikator aktywacji.
4. Wpisz ten numer w testowanym formularzu rejestracji, a następnie odpytuj GET /api/v1/activations/{id} albo czekaj na webhook.
5. Jeśli test zostanie przerwany, wywołaj POST /api/v1/activations/{id}/cancel, aby środki od razu wróciły do portfela.

Przewodnik integracji API OTP omawia te same wywołania z naciskiem na obsługę błędów.

Jak odbiornik webhooków powinien traktować zdarzenia +267?

Webhooki są lepszym wyborem, gdy równolegle działa więcej niż jeden test. Zarejestruj endpoint (pięć na konto) i nasłuchuj activation.sms_received, activation.expired i activation.cancelled, każde powiązane z identyfikatorem aktywacji otrzymanym przy zamówieniu.

Każde dostarczenie niesie nagłówek X-OTPRoute-Signature w postaci t=<unix>,v1=<hex>. Odtwórz HMAC-SHA256 ciągu "<t>.<raw body>" za pomocą sekretu endpointu, porównaj z v1 w stałym czasie i odrzuć wszystko z nieaktualnym znacznikiem czasu. JSON parsuj dopiero po pozytywnej kontroli, ponieważ ponowna serializacja treści zmienia bajty.

Zrób handler idempotentnym: zapisuj identyfikator aktywacji, gdy kod zostanie wykorzystany, i ignoruj powtórzenie tego samego zdarzenia. Szczegóły są w tekście o zabezpieczaniu webhooków OTP przez HMAC.

Do czego można użyć numeru weryfikacyjnego z Botswany?

Aktualny przegląd dla Botswany obejmuje ponad 800 usług. Wśród popularnych są WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, ChatGPT (OpenAI), Microsoft & Outlook, Amazon, LinkedIn, Uber, Signal, Netflix i Airbnb.

Dostępność na danej trasie zmienia się w ciągu dnia wraz z mocami operatorów. Dlatego endpoint cen zgłasza też to, co można zamówić w tej chwili: traktuj jego odpowiedź jako źródło prawdy, a nie tę listę.

Co inżynierowie powinni wiedzieć o numerach telefonów z Botswany?

Botswana używa kodu kraju +267 i nie ma krajowego prefiksu, więc numer krajowy wybiera się tak, jak jest zapisany. Numery komórkowe mają osiem cyfr i zaczynają się od 7. W E.164 daje to +267 i osiem cyfr, bez zera do usunięcia.

Kilka praktycznych uwag dla każdego, kto zapisuje lub waliduje takie numery:

• Normalizuj wszystko do E.164 już przy wprowadzaniu. Użytkownicy mogą wpisać 00267, spacje albo początkowy plus; sprowadź je wszystkie do jednej kanonicznej formy, zanim porównasz lub zdeduplikujesz.
• Nie przenoś reguły prefiksu krajowego z sąsiedniego rynku. Walidator skopiowany z kraju, który usuwa początkowe zero, odrzuci prawidłowe wpisy z Botswany.
• Głównymi językami są angielski i setswana. Kody z globalnych aplikacji zwykle przychodzą po angielsku, ale Twój parser powinien wyciągać cyfry wzorcem, a nie polegać na stałym brzmieniu.

Zespoły testują tu przy starcie produktu w południowej Afryce, sprawdzaniu onboardingu klientów mieszkających po drugiej stronie granicy z RPA albo w operacjach regionalnych, które potrzebują lokalnego numeru +267 do testów.

Czy osoba niebędąca programistą zamówi kod z Botswany w panelu?

Tak. Zarejestruj się za pomocą adresu e-mail i sześciocyfrowego kodu (lub Google), zasil portfel, a następnie otwórz OTP Gateway, wybierz Botswanę i usługę, sprawdź pokazaną cenę i zamów. Wklej numer w testowanej aplikacji; kod pojawi się w panelu, gdy tylko SMS dotrze na trasę.

Każda aktywacja pozostaje otwarta przez 20 minut. Jeśli w tym czasie nie przyjdzie żadna wiadomość albo wcześniej anulujesz, pełna kwota automatycznie wraca do portfela.

Co jeśli kod z Botswany nie dotrze?

Szybkość dostarczenia zależy od usługi i trasy, więc daj oknu czas, zanim zareagujesz. Jeśli zamknie się puste, przejdź przez tę listę:

• Spróbuj ponownie nieco później albo wybierz inną trasę usługi dla tego samego przepływu, jeśli Twój produkt to obsługuje.
• Upewnij się, że aplikacja po drugiej stronie chce wysłać SMS na linię wirtualną; kilka aplikacji odrzuca takie numery, i właśnie dlatego niewykorzystane aktywacje wracają na Twoje saldo.
• Pozwól 20-minutowemu oknu dobiec końca, zamiast anulować po minucie.
• Unikaj ponawiania zamówień w ciasnej pętli z CI; dodaj opóźnienie między próbami.

Więcej wzorców znajdziesz w tekście o ograniczaniu nieudanych dostarczeń OTP. Cokolwiek testujesz, przestrzegaj regulaminu każdej usługi; Polityka dozwolonego użytkowania OTP Route obejmuje każde zamówienie.

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

Nie jako produkt samoobsługowy. Numery dedykowane sprzedajemy natychmiast tylko w Stanach Zjednoczonych i Kanadzie, od $1.95/month; w sprawie Botswany możesz napisać na [email protected] z pytaniem, a dostępność zależy od lokalnych przepisów. Zobacz numery wirtualne, by sprawdzić, co obejmują linie amerykańskie i kanadyjskie.

Rozliczenia opierają się na jednym przedpłaconym portfelu w USD, bez opłaty miesięcznej, zasilanym kartą lub USDT/USDC, a do każdego zasilenia dostajesz e-mailem fakturę PDF. Do prac integracyjnych konto deweloperskie można na prośbę przełączyć na sandbox, aby cały przepływ działał na symulowanych numerach i kodach. Aktualne stawki są na stronie cennika.

Najczęstsze pytania

Jaki jest identyfikator kraju dla Botswany w API OTP Route?

To bw. Przekaż go jako country w POST /api/v1/activations oraz w zapytaniu GET /api/v1/prices.

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

Tak. Zamów numer +267 dla usługi swojej aplikacji w OTP Gateway i odczytaj kod w panelu albo na swoim webhooku, bez karty SIM i bez telefonu.

Czy numery z Botswany wymagają początkowego zera przy zapisie?

Nie. Botswana nie ma krajowego prefiksu, więc zapisuj numer jako +267 i ośmiocyfrowy numer komórkowy.

Czy zostanę obciążony, jeśli kod +267 nie dotrze?

Nie. Jeśli nic nie dotrze w 20-minutowym oknie albo anulujesz zamówienie, pełna kwota automatycznie wraca do portfela.

Czy mogę zatrzymać numer z Botswany na potrzeby przyszłych logowań?

Dla Botswany nie ma samoobsługowego numeru długoterminowego. Linie długoterminowe to produkt dla USA i Kanady; napisz na [email protected], jeśli chcesz zapytać o inne opcje.

Czy mogę uruchamiać testy dla Botswany w CI bez wydawania środków z portfela?

Poproś o przełączenie konta deweloperskiego na sandbox. Zwraca symulowane numery i kody, więc pełną ścieżkę API i webhooków można przetestować bez kosztów.

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.