Kierowanie kodów weryfikacyjnych z Republiki Konga (+242) do Twojego stosu testowego

Jakie wywołania API pobierają kod +242 od początku do końca?

Wszystko działa pod https://otproute.com/api/v1 i uwierzytelnia się kluczem Bearer zaczynającym się od or_live_. Klucze generujesz w konsoli deweloperskiej; konto może mieć ich do 10, co ułatwia nadanie osobnych, niezależnie odwoływalnych poświadczeń środowisku staging, CI i laptopowi kolegi.

Typowy przebieg testu na rynku Brazzaville wygląda tak:

1. Pobierz GET /api/v1/services i GET /api/v1/countries i zapisz identyfikatory w pamięci podręcznej. Republika Konga to cg (nie mylić z większym sąsiadem, który ma własny identyfikator i stronę Kongo (DRK)).
2. Zapytaj GET /api/v1/prices?country=cg&service=<id> o bieżącą cenę i dostępność testowanej aplikacji.
3. Utwórz aktywację przez POST /api/v1/activations z treścią w rodzaju {"service": "telegram", "country": "cg"}. Dostajesz identyfikator aktywacji i numer +242.
4. Wpisz ten numer na ekranie rejestracji lub logowania własnego produktu.
5. Odbierz kongijski kod z dostawy webhooka albo odpytując GET /api/v1/activations/{id}. Jeśli test zostanie przerwany, zwolnij go przez POST /api/v1/activations/{id}/cancel.

Uruchom GET /api/v1/balance przed startem zestawu testów, aby pusty portfel przerywał zadanie na początku, a nie w połowie. Limit 300 żądań na minutę zostawia sporo zapasu dla kilku równoległych workerów. Pełne kształty żądań i odpowiedzi są w dokumentacji dla deweloperów.

Jak podłączyć podpisany webhook dla kongijskich aktywacji?

Odpytywanie wystarcza, gdy jeden inżynier klika przepływ; webhook jest łagodniejszy dla floty CI. Dodaj endpoint w konsoli deweloperskiej (na konto dozwolonych jest pięć) i zasubskrybuj activation.sms_received, activation.expired oraz activation.cancelled.

Każde żądanie niesie X-OTPRoute-Signature: t=<unix>,v1=<hex>. Odbuduj HMAC-SHA256 z "<t>.<raw body>" przy użyciu sekretu tego endpointu, porównaj z v1 kontrolą w stałym czasie i odrzuć wszystko, co ma przeterminowany znacznik czasu. Haszuj surowe bajty przed jakimkolwiek parsowaniem JSON, bo ponownie zserializowany JSON rzadko zgadza się bajt w bajt.

Traktuj zdarzenia jako powiązane z identyfikatorem aktywacji. Jeśli to samo zdarzenie przyjdzie dwa razy, Twój handler powinien zauważyć, że identyfikator jest już rozstrzygnięty, i po prostu zwrócić status sukcesu. Przewodnik po przechwytywaniu przez webhook pokazuje wzorce kolejkowania, które chronią wolne runnery testów przed przekroczeniem limitu czasu.

Jakie usługi obejmuje kongijski numer weryfikacyjny?

Dzisiejszy zrzut dla cg zawiera WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, X (Twitter), ChatGPT (OpenAI), Claude, Microsoft & Outlook, LinkedIn, Signal, Viber i imo. W sumie kraj ma w OTP Gateway ponad 1000 usług.

Lista zmienia się w ciągu dnia, gdy trasy się otwierają i zamykają, więc nigdy nie wpisuj jej na sztywno. Niech Twój zestaw testowy pyta endpoint cen o konkretną usługę, której potrzebuje, i elegancko pomija lub przesuwa test, gdy dostępność jest pusta. W kongijskiej ofercie dominują komunikatory, co odpowiada temu, jak wielu tamtejszych klientów po raz pierwszy poznaje nowy produkt: przez link udostępniony w grupie czatu, a nie wyszukiwanie w sklepie z aplikacjami.

Jak przechowywać i normalizować numery +242?

Numery Republiki Konga mają dziewięć cyfr po kodzie kraju i, w przeciwieństwie do wielu planów numeracyjnych, początkowe 0 jest częścią numeru abonenta, a nie prefiksem krajowym. Numery komórkowe zapisuje się lokalnie zwykle jako 06… lub 05…, a międzynarodowo jako +242 06…. Normalizator skopiowany z europejskiej bazy kodu, który usuwa każde początkowe zero, po cichu zepsuje takie numery, więc zapisuj dokładnie ten ciąg E.164, który zwraca API, i sprawdzaj długość dla danego kraju, a nie jedną globalną regułą.

Francuski jest językiem urzędowym i zwykłym językiem SMS-ów weryfikacyjnych, choć na co dzień szeroko używa się lingala i kituba. Spodziewaj się znaków diakrytycznych w niektórych szablonach i dopilnuj, by parser wyciągał cyfry wzorcem, zamiast polegać na stałych angielskich słowach.

Zespoły testują tu zwykle przy wprowadzaniu produktu do francuskojęzycznej Afryki Środkowej, wspieraniu pracowników operacyjnych w Brazzaville lub Pointe-Noire albo obsłudze kongijskich klientów za granicą, którzy wciąż rejestrują się numerem z kraju. Sprawdzenie całego przepływu na prawdziwej trasie +242 wyłapuje problemy z formatowaniem i treścią, które umknęłyby symulatorowi.

Co, jeśli kod nie dociera na numer +242?

Cisza to zwykle problem z trasą lub akceptacją, a nie błąd integracji. Rozsądny schemat postępowania:

• Pozwól, by 20-minutowe okno dobiegło końca, zanim cokolwiek wywnioskujesz; niektórzy nadawcy wysyłają ruch wychodzący partiami.
• Potwierdź, że docelowa usługa akceptuje numery wirtualne. Kilka z nich ich nie akceptuje, i właśnie dlatego niedostarczony kod nic nie kosztuje.
• Spróbuj ponownie później albo zmień trasę usługi, zamiast wysyłać nowe zamówienia w ciasnej pętli, która zużywa limit żądań.
• Anuluj numery, których już nie potrzebujesz, aby środki wróciły od razu, a nie dopiero po wygaśnięciu.

Nasz artykuł o ograniczaniu nieudanych dostaw OTP szerzej omawia wycofywanie i budżety ponowień.

Czy mogę zachować długoterminową kongijską linię?

Dla Republiki Konga nie ma samoobsługowego numeru długoterminowego. OTP Gateway wydaje jeden numer na jeden kod weryfikacyjny i to jedyny produkt oferowany teraz dla cg.

Numery dedykowane OTP Route to produkt dla Stanów Zjednoczonych i Kanady, od $1.95/miesiąc, z przychodzącymi i wychodzącymi SMS-ami oraz połączeniami w przeglądarce. Jeśli zespół naprawdę potrzebuje trwałej kongijskiej linii, napisz na [email protected]; to, czy da się cokolwiek ustalić, zależy od lokalnych przepisów, więc traktuj to jako pytanie, a nie obietnicę. Kompromisy podsumowuje wpis o numerach tymczasowych i dedykowanych.

Jak rozliczany i bezpiecznie testowany jest kongijski routing OTP?

Rozliczenie idzie z jednego przedpłaconego portfela w USD, bez subskrypcji i poziomów planu. Zasilasz go kartą lub stablecoinami USDT/USDC, a każde doładowanie generuje e-mailem fakturę w PDF dla Twojego działu finansów.

Zanim wpniesz prawdziwe pieniądze w potok, poproś wsparcie o przełączenie konta deweloperskiego w tryb sandbox. Zwraca on symulowane numery i kody, więc możesz przećwiczyć całą ścieżkę API weryfikacji SMS od początku do końca bez wydawania czegokolwiek. Używaj OTP Route tylko na własnych produktach i kontach, którymi masz prawo zarządzać; nadal obowiązują regulaminy usług i nasze Zasady dopuszczalnego użytkowania. W cenniku zobaczysz, jak opłaty i zwroty pojawiają się w portfelu.

Najczęstsze pytania

Jaki jest identyfikator kraju dla Republiki Konga w API OTP Route?

To cg. Demokratyczna Republika Konga jest osobnym krajem z własnym identyfikatorem, więc sprawdź dwa razy, do którego odwołuje się Twoja konfiguracja.

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

Tak. Zamów numer +242 do testów w OTP Gateway, wpisz go w aplikacji i odczytaj kod w panelu lub przez API.

Czy przy zapisie numeru +242 usuwać początkowe zero?

Nie. W Republice Konga 0 należy do dziewięciocyfrowego numeru abonenta, więc zachowaj wartość E.164 dokładnie taką, jaką zwraca API.

W jakim języku będą kongijskie wiadomości weryfikacyjne?

Większość przychodzi po francusku, czasem po angielsku w przypadku międzynarodowych aplikacji. Cyfry wyodrębniaj wzorcem, zamiast dopasowywać konkretne słowa.

Czy zapłacę, jeśli kod się nie pojawi?

Nie. Jeśli okno zamknie się bez SMS-a albo wcześniej anulujesz, pełna kwota automatycznie wraca do portfela.

Ile kosztuje odebranie kongijskiego SMS-a OTP?

Od $0.20 za kod; cena +242 dla każdej aplikacji jest podawana na żywo, więc zapytaj o nią przed zamówieniem.

Czy jest sandbox do budowania integracji?

Tak, na prośbę. Wsparcie może przełączyć konto deweloperskie w tryb sandbox, który zwraca symulowane numery i kody bez ruszania środków z portfela.

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.