Kody weryfikacyjne z Republiki Zielonego Przylądka (+238) w Twoim środowisku testowym

Których endpointów dotyka aktywacja +238?

Integracja API OTP dla Cabo Verde wymaga tylko krótkiej listy wywołań pod adresem https://otproute.com/api/v1. Każde żądanie niesie klucz Bearer zaczynający się od or_live_, wygenerowany w konsoli deweloperskiej. Identyfikator kraju dla Cabo Verde to cv; identyfikator usługi to wartość api_service aplikacji, którą testujesz.

1. GET /api/v1/services i GET /api/v1/countries pobierają katalogi; przechowuj je w pamięci podręcznej na dobę.
2. GET /api/v1/prices?country=cv&service=<id> odczytuje aktualną cenę i mówi, czy trasa jest teraz otwarta. Pula zmienia się w ciągu dnia, więc pytaj przed każdym zamówieniem, zamiast cokolwiek wpisywać na sztywno.
3. POST /api/v1/activations z {"service": "whatsapp", "country": "cv"} zwraca identyfikator aktywacji oraz numer +238 do wpisania w formularzu rejestracji.
4. GET /api/v1/activations/{id} pozwala odpytywać o kod, jeśli nie używasz webhooków.
5. POST /api/v1/activations/{id}/cancel zwalnia numer, gdy test zostanie przerwany, a blokada wraca na portfel.

Wywołanie GET /api/v1/balance przed przebiegiem pozwala zestawowi testów zatrzymać się wcześniej, zamiast zawieść w połowie. Limit to 300 żądań na minutę na konto, a dokumentacja API wylicza każde pole.

Jak przyjąć podpisany webhook z kodem z Cabo Verde?

Odpytywanie wystarcza dla jednego skryptu; gdy równolegle działa kilka zadań, wygodniejszy jest webhook. Zarejestruj endpoint w konsoli deweloperskiej (konto może mieć pięć) i zasubskrybuj activation.sms_received, activation.expired i activation.cancelled.

Każdy POST przychodzi z nagłówkiem X-OTPRoute-Signature w postaci t=<unix>,v1=<hex>. Zbuduj ciąg <t>.<raw body>, podpisz go HMAC-SHA256 sekretem tego endpointu i porównaj wynik z v1 sprawdzeniem w stałym czasie. Odrzucaj wszystko, czego znacznik czasu jest starszy niż kilka minut, aby przechwycone żądanie nie mogło zostać odtworzone. Potem przetwarzaj zdarzenia według identyfikatora aktywacji: jeśli to samo zdarzenie dotrze dwa razy, druga kopia nie powinna nic zmienić. Nasz artykuł o zabezpieczaniu webhooków OTP przez HMAC omawia przypadki brzegowe.

Które aplikacje mogą dziś wysyłać kody na numer z Republiki Zielonego Przylądka?

Aktualny katalog dla cv obejmuje ponad 800 usług. Wśród popularnych, otwartych w tej chwili, są WhatsApp, Facebook, Instagram, TikTok, Google (Gmail & YouTube), Microsoft & Outlook, Amazon, Airbnb, Uber, Viber, Telegram i Netflix. Traktuj to jako migawkę: trasy otwierają się i zamykają zależnie od mocy partnerów, i na tym polega sens routingu OTP przez API raportujące dostępność w czasie rzeczywistym, a nie przez stronę, która ją obiecuje.

Jeśli nikt w zespole nie pisze kodu, to samo robi panel. Wybierz usługę, wybierz Cabo Verde, potwierdź cenę na ekranie i skopiuj numer. Kod pojawi się na karcie aktywacji, gdy dotrze.

Jak wygląda numer +238 przy zapisie w bazie?

Cabo Verde ma zamknięty plan numeracyjny: siedmiocyfrowe numery krajowe i brak prefiksu międzymiastowego, więc nie ma wiodącego zera do usunięcia. W E.164 numer to po prostu +238 i siedem cyfr. Normalizacja jest więc banalna, ale krótka długość myli walidatory zakładające, że każdy numer abonencki jest dłuższy, co bywa częstą przyczyną odrzucenia przez formularz zupełnie poprawnego numeru z Zielonego Przylądka. Zapisuj ciąg E.164, formatuj go w interfejsie jak wolisz i dodaj przypadek +238 do testów jednostkowych pola telefonu.

Językiem urzędowym jest portugalski, ale na co dzień większość ludzi mówi kreolskim kabowerdyjskim, więc sprawdź, jak portugalski szablon OTP wyświetla się na tamtejszym telefonie. Zespoły zwykle sięgają po numer +238 do testów z powodu diaspory: społeczności z Zielonego Przylądka w Stanach Zjednoczonych, Portugalii i innych krajach Europy trzymają konta powiązane z numerami z kraju, a produkty do przekazów, podróży i komunikacji chcą, by te rejestracje działały.

Co dzieje się z portfelem, gdy SMS nie dotrze w 20 minut?

Każda aktywacja pozostaje otwarta przez 20 minut. Jeśli kod dotrze w tym oknie, opłata zostaje; jeśli okno zamknie się puste albo wcześniej anulujesz, pełna kwota wraca na portfel bez zgłoszenia do wsparcia. Gdy nic nie przychodzi:

• Pozwól oknu dobiec końca, zamiast wysyłać nowe zamówienie co kilka sekund; ciasna pętla ponowień tylko blokuje środki.
• Spróbuj później albo przetestuj ten sam przepływ przez inną trasę usługi.
• Sprawdź, czy aplikacja w ogóle akceptuje numery wirtualne; niektóre odrzucają je z zasady, i zwrot istnieje właśnie na taki przypadek.
• Upewnij się, że formularz wysłał pełny numer +238, a nie jego obcięty fragment.

Poradnik o ograniczaniu nieudanych dostaw OTP szerzej omawia diagnostykę.

Czy mogę zachować numer z Cabo Verde do wielokrotnych logowań?

Nie w trybie samoobsługowym. Numery dedykowane OTP Route, czyli długoterminowe linie z przychodzącymi i wychodzącymi SMS-ami, połączeniami w przeglądarce i przekazywaniem na webhook, to produkt dostępny w Stanach Zjednoczonych i Kanadzie, od $1.95/month. Nie ma samoobsługowej, długoterminowej linii +238. Jeśli Twój zespół naprawdę jej potrzebuje, napisz na [email protected]; to, czy da się ją zorganizować, zależy od lokalnych przepisów i nie jest pewne. Dla konta stagingowego, które musi logować się wielokrotnie, praktycznym rozwiązaniem bywa amerykański lub kanadyjski numer wirtualny.

Jak rozliczane jest użycie i jak testować przed uruchomieniem?

Rozliczenia działają z jednego przedpłaconego portfela w USD, bez opłaty miesięcznej i bez poziomów abonamentu. Doładowuj kartą lub stablecoinami USDT/USDC; każde doładowanie dostaje e-mailem fakturę PDF, co upraszcza uzgodnienia w finansach. Zanim klucze produkcyjne dotkną portfela, poproś o przełączenie konta deweloperskiego na sandbox: zwraca symulowane numery i kody, więc ścieżka zamówienia, webhooka i anulowania w Twoim kliencie API weryfikacji SMS może działać w CI bez wydawania środków. Zobacz cennik i przegląd testów QA. Przez cały czas przestrzegaj warunków każdej usługi oraz Regulaminu dopuszczalnego użycia OTP Route.

Najczęstsze pytania

Czy mogę przetestować rejestrację w mojej aplikacji z Cabo Verde bez lokalnej karty SIM?

Tak. Zamów numer +238 w OTP Gateway, wpisz go w formularzu rejestracji i odczytaj kod w panelu, przez API lub webhook. Nikt z zespołu nie musi być na wyspach.

Jaki jest identyfikator kraju dla Cabo Verde w API OTP Route?

To cv. Przekaż go jako country w POST /api/v1/activations oraz w zapytaniu o ceny.

Czy muszę dodać 0 przed numerem z Zielonego Przylądka?

Nie. Cabo Verde nie ma prefiksu międzymiastowego, więc forma międzynarodowa to po prostu +238 i siedmiocyfrowy numer krajowy.

Ile kosztuje numer weryfikacyjny z Cabo Verde?

Ceny OTP Gateway zaczynają się od $0.20 za kod i różnią się zależnie od usługi; API i panel pokazują dokładną cenę przed zamówieniem. Płacisz tylko wtedy, gdy kod dotrze.

Czy każda aplikacja wyśle kody na wirtualny numer z Zielonego Przylądka?

Nie. Niektóre usługi odrzucają numery wirtualne, a trasy zmieniają się w ciągu dnia. Jeśli w 20 minut nie dotrze żaden kod, kwota wraca na portfel.

Czy jest sandbox do testowania integracji +238?

Tak, na prośbę. Konto deweloperskie można przełączyć w tryb sandbox, który zwraca symulowane numery i kody, więc integracja działa od początku do końca bez wydatkó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.