Jak wciągnąć etiopskie kody SMS (+251) do potoku testowego

Które wywołania API pobierają etiopski kod weryfikacyjny?

Routing OTP dla Etiopii sprowadza się do pięciu prostych wywołań HTTP względem https://otproute.com/api/v1. Każde uwierzytelnij kluczem Bearer zaczynającym się od or_live_, wygenerowanym w konsoli deweloperskiej; konto może mieć do 10 kluczy, więc CI, staging i lokalny laptop mogą działać na osobnych danych uwierzytelniających.

1. GET /api/v1/countries wypisuje wszystkie trasy, a Etiopia występuje z identyfikatorem et.
2. GET /api/v1/services zwraca identyfikatory usług, a GET /api/v1/prices?country=et&service=<id> podaje aktualną cenę i dostępność dla pary, którą zamierzasz testować.
3. POST /api/v1/activations z {"service": "telegram", "country": "et"} rezerwuje numer +251 i zwraca identyfikator aktywacji.
4. Wpisz ten numer w pole telefonu testowanego produktu i wywołaj wysłanie SMS-a.
5. Odczytaj kod ze zdarzenia webhooka albo przez odpytywanie GET /api/v1/activations/{id}, a przebieg porzuć czysto przez POST /api/v1/activations/{id}/cancel.

Zasoby zmieniają się w ciągu dnia, więc wywołuj endpoint cen w czasie działania, zamiast cokolwiek wpisywać na sztywno. Szybkie GET /api/v1/balance przed startem zestawu pozwala zadaniu zatrzymać się wcześniej, gdy w portfelu zaczyna brakować środków. Kształty żądań i odpowiedzi tego API do weryfikacji SMS opisuje dokumentacja dla deweloperów.

Jak podłączyć podpisany webhook dla aktywacji +251?

Odpytywanie wystarcza przy pojedynczym teście, ale równoległe zadania łatwiej ogarnąć, gdy zdarzenia są do Ciebie wypychane. Zarejestruj do 5 endpointów webhooków na konto i zasubskrybuj activation.sms_received, activation.expired oraz activation.cancelled.

Każde żądanie zawiera X-OTPRoute-Signature: t=<unix>,v1=<hex>. Oblicz ponownie HMAC-SHA256 z <t>.<raw body> przy użyciu sekretu endpointu, porównaj wynik z v1 sprawdzeniem w stałym czasie i odrzuć wywołanie, gdy znacznik czasu jest nieaktualny. Weryfikuj na surowych bajtach, zanim dotknie ich jakikolwiek parser JSON.

Zakładaj, że zdarzenie może zostać dostarczone więcej niż raz: identyfikuj je w handlerze po identyfikatorze aktywacji i porzucaj powtórki, aby ponowione zdarzenie nigdy nie wypełniło pola OTP dwukrotnie. Jeśli zostajesz przy odpytywaniu, odstęp kilku sekund mieści się z zapasem w limicie 300 żądań na minutę. Nasz poradnik o zabezpieczaniu webhooków OTP przez HMAC zawiera wzorcowy handler.

Które usługi mogą teraz odbierać kody SMS OTP z Etiopii?

Trasa Etiopii obejmuje obecnie ponad 1 700 usług. Do popularnych pozycji w aktualnym zestawie należą WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, ChatGPT (OpenAI), Microsoft & Outlook, LinkedIn, Uber, Signal, Viber, imo i Netflix.

Traktuj tę listę jako migawkę. Dostępność pojedynczej usługi może się zmienić w ciągu godzin, dlatego API raportuje ją na żywo, a nie w statycznej tabeli. Odpytuj endpointy krajów i cen na początku każdego przebiegu, a rzadziej spotykanej usługi szukaj w pełnym katalogu w panelu.

Co zespoły QA powinny wiedzieć o formatach numerów +251 i języku SMS-ów?

Etiopski numer w E.164 to +251 i dziewięć cyfr. W formie krajowej wybiera się początkowe 0 przed tymi dziewięcioma cyframi, więc użytkownicy często wpiszą w formularzu 09…. Usuń to zero z prefiksu krajowego, dopisz +251 i zapisz kanoniczny ciąg E.164, a styl lokalny pokazuj wyłącznie w interfejsie. Pokryj oba warianty wpisu, a także spacje i myślniki, bo walidacja pola telefonu to miejsce, w którym kryje się wiele błędów rejestracji.

Amharski jest federalnym językiem roboczym i zapisuje się go pismem etiopskim (Ge'ez), natomiast afaan oromo, tigrinia i somalijski są szeroko używane w swoich regionach. Większość usług międzynarodowych wysyła kody po angielsku, lecz zlokalizowany szablon może przyjść po amharsku. Wyciągaj cyfry wzorcem zamiast dopasowywać otaczające słowa i upewnij się, że logi czysto zapisują UTF-8.

Zespoły testują tę trasę zwykle przy uruchamianiu aplikacji dla użytkowników z Etiopii, sprawdzaniu lokalizacji amharskiej albo obsłudze klientów z diaspory, którzy rejestrują się numerem z kraju pochodzenia. Jeśli Twój produkt wyświetla daty, osobnym przypadkiem lokalizacyjnym wartym dodania jest etiopski kalendarz. Strona testy QA pokazuje, jak inne zespoły układają takie zestawy.

Czy osoby niebędące deweloperami mogą dostać numer weryfikacyjny z Etiopii z panelu?

Tak. Menedżerowie produktu i pracownicy wsparcia mogą przejść ten sam przepływ bez pisania kodu:

1. Załóż konto z e-mailem i 6-cyfrowym kodem albo przez logowanie Google, a następnie włącz uwierzytelnianie dwuskładnikowe TOTP.
2. Zasil portfel.
3. Wybierz Etiopię, wskaż usługę i sprawdź wyświetloną cenę przed potwierdzeniem.
4. Wklej numer +251 do weryfikowanej aplikacji.
5. Zostaw aktywację otwartą; kod wyświetli się tam po otrzymaniu.

Wiele zespołów używa tej ścieżki do jednorazowych kontroli, podczas gdy inżynierowie prowadzą identyczną trasę przez API.

Co się dzieje, gdy kod +251 się nie pojawia?

Każda aktywacja pozostaje otwarta przez 20 minut. Płacisz tylko wtedy, gdy kod dotrze; jeśli okno zamknie się bez SMS-a albo anulujesz, cała kwota automatycznie wraca do portfela.

Gdy nic nie przychodzi:

• Pozwól oknu upłynąć, zanim uznasz próbę za nieudaną, bo czas zależy od usługi i trasy.
• Spróbuj później albo przełącz się na inną trasę usługi, jeśli pozwala na to Twój przypadek testowy.
• Sprawdź, czy usługa w ogóle akceptuje numery wirtualne. Niektóre ich odmawiają, a zwrot środków istnieje dokładnie na taką sytuację.
• Nie zamawiaj ponownie w ciasnej pętli. Rozstaw próby w czasie i loguj każdy identyfikator aktywacji, aby wzorce stały się widoczne.

Artykuł o ograniczaniu nieudanych dostaw OTP wymienia dalsze kontrole.

Czy istnieje długoterminowa linia etiopska i jak wyglądają rozliczenia?

OTP Route nie ma samoobsługowego numeru długoterminowego w Etiopii. Numery Dedykowane, czyli linie, które zachowujesz, dopóki się odnawiają, to produkt dla USA i Kanady od $1.95/month. Jeśli Twój zespół potrzebuje trwałej linii +251, napisz na [email protected]; dostępność zależy od lokalnych przepisów i nie jest gwarantowana.

Etiopskie aktywacje korzystają z jednego przedpłaconego portfela w USD, bez opłaty miesięcznej i bez wyboru planu. Zasilasz go kartą lub stablecoinami USDT/USDC; po każdej wpłacie do skrzynki trafia faktura PDF. Zanim wydasz prawdziwe środki na świeżą integrację, poproś o tryb sandbox dla konta deweloperskiego: zwraca on symulowane numery i kody, więc cały przepływ można przećwiczyć od początku do końca.

Etiopskie numery testowe z OTP Route służą do weryfikacji produktów i kont, które Twoja organizacja faktycznie posiada; nadal obowiązuje regulamin każdej usługi oraz nasza Acceptable Use Policy.

Najczęstsze pytania

Czy mogę przetestować etiopską ścieżkę rejestracji w mojej aplikacji bez lokalnej karty SIM?

Tak. Zamów numer +251 dla swojej usługi w OTP Gateway, wpisz go w aplikacji i odczytaj kod w panelu lub przez API. Płacisz tylko wtedy, gdy kod dotrze.

Jaki jest identyfikator kraju Etiopia w API OTP Route?

To et. Wysyłaj et jako pole country przy tworzeniu etiopskiej aktywacji i przy zapytaniach o ceny.

Ile kosztuje numer +251 do testów?

Kody zaczynają się od $0.20 za kod. Dokładną kwotę dla każdej usługi zwraca GET /api/v1/prices i pokazuje panel przed zamówieniem.

Czy etiopskie numery telefonów przechowywać z początkowym zerem?

Nie. Zachowaj formę E.164, czyli +251 i dziewięć cyfr, a krajowe 0 usuwaj, gdy użytkownik je wpisze. Formatowanie lokalne stosuj tylko na ekranie.

Czy etiopskie wiadomości weryfikacyjne będą przychodzić po amharsku?

Zwykle przychodzą po angielsku, choć usługa może użyć szablonu amharskiego w piśmie etiopskim. Parsuj cyfry, a nie brzmienie, by działały obie wersje.

Czy mogę zatrzymać etiopski numer na potrzeby późniejszych logowań?

Nie w trybie samoobsługowym, bo numer jednorazowy obejmuje jeden kod. Dla konta, które musi się logować ponownie, odpowiedni jest Numer Dedykowany w USA lub Kanadzie, albo możesz napisać do wsparcia w sprawie Etiopii.

Czy da się wypróbować Ethiopia OTP API bez wydawania środków z portfela?

Tak. Poproś o tryb sandbox dla konta deweloperskiego, a zwróci on symulowane numery i kody, dzięki czemu przetestujesz integrację 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.