Jak odbierać kody SMS OTP z Kosowa przez API lub panel

Dlaczego zespół produktowy w ogóle potrzebuje numeru +383?

Kosowo to mały rynek o nieproporcjonalnie dużej obecności za granicą: duża diaspora mieszka w Niemczech, Szwajcarii i innych częściach Europy Zachodniej, a wielu z tych ludzi zachowuje kosowski numer do kontaktów z rodziną i bankowości. Aplikacje obsługujące tę grupę, od podróży po przekazy pieniężne, muszą zobaczyć, czego doświadcza użytkownik +383 przy rejestracji.

Drugim czynnikiem jest lokalizacja. Albański i serbski są językami urzędowymi, więc proces przetłumaczony na któryś z nich zasługuje na prawdziwy test od początku do końca, a nie na przegląd zrzutów ekranu. Kosowski numer weryfikacyjny z OTP Gateway pozwala QA wykonać tę kontrolę z dowolnego biura.

Zespoły operacyjne z siedzibą w Prisztinie lub obsługujące szerszy region Bałkanów Zachodnich mają trzeci powód: profile firmowe zarejestrowane z lokalnym kontaktem czasem wymagają nowego kodu, a przekazywanie tego przez wspólne, audytowalne narzędzie jest lepsze niż podawanie z rąk do rąk telefonu pracownika.

Jakie aplikacje są teraz na kosowskiej trasie?

Dzisiejsze zestawienie pokazuje ponad 400 usług dla Kosowa. Do popularnych, obecnie oferowanych należą WhatsApp, Viber, Telegram, Facebook, Instagram, TikTok, Google (Gmail & YouTube), Microsoft & Outlook, Amazon, Snapchat, Netflix, Airbnb, Uber i Flipkart.

Lista jest krótsza niż na większych rynkach europejskich i zmienia się częściej, więc traktuj każdą spisaną listę jako wskazówkę. Rozstrzygające jest to, co GET /api/v1/countries i panel zwracają w chwili zamówienia.

Praca z Kosovo OTP API w praktyce

Identyfikator kraju to xk. Typowa integracja pobiera identyfikatory usług z GET /api/v1/services, sprawdza koszt przez GET /api/v1/prices?country=xk&service=<id>, a następnie otwiera aktywację przez POST /api/v1/activations z ciałem takim jak {"service": "telegram", "country": "xk"}. Odpowiedź zawiera numer i identyfikator aktywacji, który zachowujesz na później.

Potem kod dociera do Ciebie jako webhook activation.sms_received, podpisany w nagłówku X-OTPRoute-Signature za pomocą HMAC-SHA256 z "<t>.<raw body>". Odrzucaj stare znaczniki czasu i opieraj handler na identyfikatorze aktywacji, aby ponowione dostarczenie zostało przetworzone tylko raz. Odpytywanie GET /api/v1/activations/{id} też działa, gdy zadanie CI nie ma publicznego adresu URL. Pełne przykłady znajdziesz w przewodniku integracji.

Co zmieniło się, gdy Kosowo dostało +383, i jak przechowywać numery?

Kosowo otrzymało własny numer kierunkowy +383 dopiero pod koniec drugiej dekady XXI wieku. Wcześniej jego sieci komórkowe używały pożyczonych kodów, w tym Monako i Słowenii, a niektóre starsze rekordy klientów nadal zawierają numery w tych formatach. Jeśli importujesz stare dane, oznaczaj takie wpisy zamiast przepisywać je automatycznie.

Numery krajowe zaczynają się od prefiksu 0; numer komórkowy pokazywany lokalnie jako 044 123 456 to w E.164 +383 44 123 456. Zapisuj formę międzynarodową, usuwaj zero przy wprowadzaniu i formatuj tylko przy wyświetlaniu. Tekst albański używa liter takich jak ë, które leżą poza podstawowym alfabetem GSM, więc zlokalizowana wiadomość może zostać wysłana w UCS-2 z krótszymi segmentami.

Co powinno się stać, gdy kosowski kod jest spóźniony lub go brakuje?

Daj aktywacji pełne 20 minut. Gdy okno zamknie się bez SMS-a albo anulujesz, opłata zostaje cofnięta do portfela automatycznie i wysyłane jest activation.expired lub activation.cancelled. Rozsądne kolejne kroki:

• spróbuj ponownie po przerwie albo wybierz sąsiednią trasę, taką jak Albania, jeśli Twój test na to pozwala;
• sprawdź, czy docelowa usługa w ogóle przyjmuje numery wirtualne;
• dodaj backoff do automatycznych ponowień zamiast zamawiać w pętli.

Linie długoterminowe, portfel i sandbox w projektach dla Kosowa

OTP Route nie ma samoobsługowego numeru długoterminowego dla Kosowa. Linia Numerów dedykowanych, od $1.95/month, obejmuje tylko dwa kraje: Stany Zjednoczone i Kanadę. W sprawie trwałej linii +383 napisz na [email protected]; to, czy da się ją zorganizować, zależy od lokalnych przepisów.

Wydatki schodzą z jednego przedpłaconego portfela w USD, w modelu pay as you go, zasilanego kartą lub USDT/USDC, a po każdym doładowaniu na e-mail przychodzi faktura PDF. Deweloperzy mogą poprosić o tryb sandbox na koncie deweloperskim, aby otrzymywać symulowane numery i kody podczas podłączania webhooków. Szczegóły w cenniku.

Najczęstsze pytania

Czy mogę sprawdzić albańskojęzyczną rejestrację w mojej aplikacji z prawdziwym numerem kosowskim?

Tak. Zamów numer +383 do testów w OTP Gateway, rozpocznij rejestrację po albańsku, a kod pojawi się w panelu i na Twoim webhooku.

Jakiego identyfikatora używa Kosowo w API weryfikacji SMS?

Kosowo to xk w każdym endpoincie przyjmującym kraj, w tym GET /api/v1/prices i POST /api/v1/activations.

Ile kosztuje kosowski numer weryfikacyjny?

Od $0.20 za kod; dokładna stawka zależy od usługi i jest pokazywana przed zamówieniem lub zwracana przez endpoint cen.

Dlaczego dla Kosowa widzę mniej usług niż dla Niemiec?

Pokrycie wynika z tego, co nasi partnerzy operatorscy mogą skierować do danego kraju, a mniejsze rynki mają krótsze listy. Sprawdź listę na żywo, zanim zaplanujesz przebieg testów.

Co dzieje się z moimi pieniędzmi, jeśli kosowskie kody OTP nie dotrą?

Wracają w całości do portfela po upływie 20-minutowego okna bez SMS-a albo od razu po anulowaniu.

Czy stare numery +377 lub +386 nadal należą do użytkowników z Kosowa?

Niektóre starsze rekordy mogą je zawierać, ale nowe numery używają +383. Traktuj starsze formaty jako dane do przeglądu, a nie coś do ślepej konwersji.

Czy mogę zachować numer +383 do powtarzanych logowań?

Nie w modelu samoobsługowym. Każdy numer z bramki obsługuje jeden kod, a linie długoterminowe to produkt dla USA i Kanady; napisz na [email protected], by zapytać o Kosowo.

Czy obowiązują zasady korzystania z numerów OTP Route?

Tak. Używaj OTP Route wyłącznie do własnych legalnych produktów i kont firmowych, przestrzegaj regulaminów usług i Zasad dopuszczalnego użytkowania. Załóż konto, aby zacząć.

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.