Przewodnik API-first po szwedzkich kodach weryfikacyjnych +46

Jakie endpointy wywołać, aby odebrać szwedzki SMS OTP?

Zacznij od klucza API z konsoli deweloperskiej. Klucze mają prefiks or_live_ i trafiają do nagłówka Bearer w żądaniach do https://otproute.com/api/v1; możesz mieć ich do 10, co ułatwia rozdzielenie CI, stagingu i laptopa programisty. Identyfikator kraju dla Szwecji to se.

1. GET /api/v1/services i GET /api/v1/countries dają identyfikatory. Buforuj je na czas przebiegu.
2. GET /api/v1/prices?country=se&service=discord zwraca dzisiejszą cenę i dostępność dla tej pary.
3. POST /api/v1/activations z {"service": "discord", "country": "se"} tworzy zamówienie i zwraca identyfikator aktywacji oraz numer +46.
4. Twój test wpisuje numer na ekranie weryfikacji produktu.
5. Kod dociera przez webhook lub przez GET /api/v1/activations/{id}.
6. POST /api/v1/activations/{id}/cancel zwalnia zamówienie, którego test już nie potrzebuje.

Wywołanie GET /api/v1/balance przed zestawem testów pozwala zadaniu zatrzymać się wcześniej, gdy w portfelu jest mało środków. Limit to 300 żądań na minutę, czyli aż nadto przy interwale odpytywania rzędu kilku sekund. Pełniejszy opis tego API do weryfikacji SMS znajdziesz w przewodniku integracji OTP API.

Jak zweryfikować webhook, zanim zaufam kodowi +46?

Zarejestruj endpoint w konsoli deweloperskiej (do 5 na konto) i zasubskrybuj activation.sms_received, activation.expired oraz activation.cancelled.

Każde dostarczenie zawiera X-OTPRoute-Signature: t=<unix>,v1=<hex>. Twój handler powinien:

• odtworzyć ciąg "<t>.<raw body>" z nietkniętej treści żądania;
• obliczyć HMAC-SHA256 z sekretem tego endpointu i porównać z v1 w stałym czasie;
• odrzucać znaczniki czasu spoza krótkiej tolerancji, aby blokować ataki powtórzeniowe;
• opierać swoją pracę na identyfikatorze aktywacji, aby ponowione dostarczenie nie przetworzyło tego samego kodu dwa razy.

Odpytywanie pozostaje dobrym rozwiązaniem zapasowym, gdy zapora blokuje połączenia przychodzące. Przypadki brzegowe opisuje wpis o bezpieczeństwie webhooków z HMAC.

Jakie usługi może zweryfikować numer +46?

Szwedzka trasa obejmuje obecnie ponad 1700 usług. Aktualne przykłady to WhatsApp, Telegram, Discord, Snapchat, LinkedIn, Microsoft & Outlook, Google (Gmail i YouTube), Uber, Netflix, Amazon, Signal, ChatGPT (OpenAI), Claude, eBay i X (Twitter).

Liczby i zasoby zmieniają się w ciągu dnia, więc pozwól endpointowi cen decydować, co zamawia Twój test, zamiast wpisywać listę na sztywno.

Jak normalizować i parsować szwedzkie numery?

Szwecja używa prefiksu krajowego 0. Numer komórkowy zapisany lokalnie jako 07 i osiem kolejnych cyfr przyjmuje w E.164 postać +46 7 i te osiem cyfr, z pominiętym zerem. Przechowuj tę formę międzynarodową i zadbaj, aby obsługa wejścia usuwała spacje, łączniki i zero wiodące przed dodaniem +46. Numer +46 do testów to dobry przykład dla właśnie tej kontroli, bo Szwedzi z przyzwyczajenia często wpisują formę lokalną.

Szwedzkie szablony SMS mogą zawierać litery å, ä i ö. Jeśli Twój pipeline loguje surową wiadomość, sprawdź, czy poprawnie obsługuje tekst Unicode, a kod wyodrębniaj wzorcem cyfr, a nie angielskim zwrotem w rodzaju „your code is". Ten sam parser działa wtedy, niezależnie od tego, czy usługa pisze po szwedzku, czy po angielsku.

Zespoły testują tu przy premierach w krajach nordyckich, przy przeglądzie szwedzkich tekstów onboardingu oraz w regionalnych zespołach wsparcia, które obsługują konta w imieniu firmy.

Czy osoby niebędące programistami mogą używać panelu dla Szwecji?

Tak. Wybierz Szwecję i usługę, sprawdź aktualną cenę i potwierdź. Numer +46 pojawi się na liście zamówień; wklej go do aplikacji, a kod ukaże się obok, gdy usługa go wyśle. Product managerowie i pracownicy wsparcia korzystają z tej ścieżki, by sprawdzić pojedynczy proces na szwedzkim numerze weryfikacyjnym bez dotykania API. Konto zakładasz za pomocą e-maila i 6-cyfrowego kodu podczas rejestracji.

Dlaczego kod +46 może nie dotrzeć i co wtedy?

Każda aktywacja jest otwarta przez 20 minut, a płacisz tylko wtedy, gdy kod dotrze. Zamówienia wygasłe lub anulowane zwracają pełną kwotę do portfela bez konieczności zgłoszenia.

Jeśli kodu brakuje, daj oknu czas, a potem spróbuj później lub przetestuj przez inną trasę usługi. Niektóre usługi odrzucają numery wirtualne, a odmowa na ekranie rejestracji zwykle oznacza właśnie to, a nie usterkę dostarczania. Rób przerwy między próbami zamiast zamawiać w ciasnej pętli; dobra logika routingu OTP traktuje brak kodu jako sygnał, by poczekać lub przełączyć trasę, a nie by walić w endpoint.

Linie dedykowane, portfel i sandbox do testów w Szwecji

Samoobsługowy numer długoterminowy w Szwecji nie jest dziś częścią oferty OTP Route. Numery dedykowane są dostępne wyłącznie w Stanach Zjednoczonych i Kanadzie, od $1.95/month; po trwałą linię szwedzką napisz na [email protected], a zespół powie, czy lokalne przepisy na to pozwalają.

Finansowanie odbywa się z przedpłaconego portfela w USD bez opłaty miesięcznej, zasilanego kartą lub USDT/USDC, a po każdym doładowaniu wysyłana jest faktura PDF. Poproś o przełączenie konta deweloperskiego na sandbox, jeśli chcesz mieć symulowane numery i kody do CI. Szczegóły kosztów są na stronie cennika.

Testuj tylko własne produkty, przestrzegaj regulaminów usług i stosuj się do Polityki Dopuszczalnego Użytkowania OTP Route.

Najczęstsze pytania

Jaki jest identyfikator kraju dla Szwecji w API OTP Route?

To se, używany w zapytaniu o ceny i w treści aktywacji.

Czy szwedzkie numery przechowywać z zerem z przodu?

Nie. Usuń zero prefiksu krajowego i zapisz formę E.164 zaczynającą się od +46; formę lokalną pokazuj tylko wtedy, gdy wymaga tego Twój interfejs.

Czy mogę przetestować szwedzki proces rejestracji w mojej aplikacji bez szwedzkiej karty SIM?

Tak. Zamów numer +46 dla usługi, wpisz go w aplikacji i odbierz kod przez webhook, odpytywanie lub panel.

Czy szwedzkie znaki zepsują mój parser OTP?

Nie powinny, jeśli dopasowujesz cyfry zamiast słów i traktujesz wiadomość jako tekst Unicode.

Ile kosztuje nieudane zamówienie +46?

Nic. Bez SMS-a w ciągu 20 minut lub po anulowaniu cała kwota wraca do portfela.

Czy mogę dostać szwedzki numer, który zostaje mój?

Nie jako produkt samoobsługowy. Numery długoterminowe są oferowane w USA i Kanadzie; o Szwecję zapytaj, pisząc na [email protected].

Jak uruchamiać testy integracyjne bez prawdziwych środków?

Poproś o tryb sandbox dla konta deweloperskiego, który zwraca symulowane numery i kody 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.