Kierowanie albańskich kodów OTP (+355) do Twojego środowiska testowego

Jakie wywołania REST zwracają albański numer i jego kod?

API OTP dla Albanii to ten sam interfejs API do weryfikacji SMS, którego używasz na każdym rynku; zmienia się tylko identyfikator kraju. Żądania trafiają na https://otproute.com/api/v1 z kluczem Bearer z prefiksem or_live_, wygenerowanym w konsoli deweloperskiej. Identyfikator Albanii to al, więc typowy przebieg wygląda tak:

1. GET /api/v1/services zwraca identyfikator potrzebnej usługi, na przykład telegram lub google. Zapisz listę w pamięci podręcznej między uruchomieniami.
2. GET /api/v1/prices?country=al&service=<id> odczytuje aktualną cenę i potwierdza, że trasa jest teraz otwarta.
3. POST /api/v1/activations z {"service": "telegram", "country": "al"} zwraca identyfikator aktywacji i numer +355.
4. Twój test wpisuje ten numer na ekranie rejestracji lub logowania testowanej aplikacji.
5. Kod przychodzi webhookiem albo przez polling GET /api/v1/activations/{id}; jeśli test zostanie przerwany, wywołaj POST /api/v1/activations/{id}/cancel.

Konto może mieć do 10 kluczy, więc staging, CI i laptop kolegi mogą dostać osobne klucze, które unieważnisz niezależnie. Limit 300 żądań na minutę zostawia miejsce na kilka równoległych zestawów testów. Szczegóły pól znajdziesz w dokumentacji API.

Czy moje testy dla Albanii mają odpytywać API, czy nasłuchiwać webhooków?

Polling najszybciej podłączyć: odpytuj endpoint aktywacji co kilka sekund, aż zmieni się status. Gdy zestawy testów działają równolegle, porządniejszy jest webhook. Zarejestruj do 5 endpointów i zasubskrybuj activation.sms_received, activation.expired oraz activation.cancelled.

Każda dostawa jest podpisana. Nagłówek X-OTPRoute-Signature ma postać t=<unix>,v1=<hex>, gdzie v1 to HMAC-SHA256 z "<t>.<raw body>" obliczony sekretem endpointu. Oblicz go ponownie z nietkniętych bajtów żądania, porównaj w stałym czasie i odrzucaj wszystko z nieaktualnym znacznikiem czasu. Traktuj zdarzenia jako kluczowane identyfikatorem aktywacji, aby ponowiona dostawa nigdy nie zapisała danych dwa razy. Nasz artykuł o przechwytywaniu OTP przez webhooki pokazuje kompletny handler.

Jak normalizować numery +355, zanim trafią do mojej bazy?

Albania używa kodu kraju +355 i krajowego prefiksu 0. Lokalnie numer komórkowy zwykle zapisuje się z tym 0 na początku, jako 06X XXX XXXX, a w formie międzynarodowej zero znika: +355 6X XXX XXXX. Zapisuj wersję E.164 (+3556…, bez spacji), a lokalne formatowanie stosuj dopiero przy wyświetlaniu.

Kontrole warte dodania przy walidacji numeru +355 do testów:

• Usuwaj początkowe 0, gdy użytkownik wpisze format krajowy po wybraniu +355.
• Odrzucaj podwojony prefiks, np. +355 0 6X, który pojawia się, gdy formularz ślepo dokleja kod kraju do numeru lokalnego.
• Nie zapisuj w wartości spacji, myślników ani nawiasów.

Treść wokół kodu zależy od usługi wysyłającej i ustawienia języka konta; powszechne są zarówno albański, jak i angielski. Celuj w parserze w cyfry, a nie w stałe zdanie. Zespoły testują ten rynek przy starcie w Albanii, lokalizacji aplikacji dla osób mówiących po albańsku w regionie i za granicą albo przy sprawdzaniu, czy regionalne konto operacyjne nadal przechodzi weryfikację.

Co mogę zweryfikować na trasie albańskiej?

Trasa albańska wymienia obecnie ponad 1500 usług. Popularne pozycje w bieżącym zrzucie to WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, Viber, Signal, Microsoft & Outlook, ChatGPT (OpenAI), Uber, LinkedIn i Discord.

Zasoby zmieniają się w ciągu dnia, dlatego dostępność pochodzi z API, a nie ze statycznej listy. Uzależnij każdy test od sprawdzenia ceny dla al i oznacz go jako pominięty, a nie nieudany, gdy trasa akurat jest zamknięta. Dzięki temu szum związany z routingiem OTP nie zaśmieca prawdziwych wyników regresji.

Czy osoba nietechniczna może zamówić numer +355?

Tak. Panel obsługuje ten sam przepływ bez pisania kodu:

1. Zarejestruj się adresem e-mail i 6-cyfrowym kodem z e-maila albo przez Google, a następnie włącz uwierzytelnianie dwuskładnikowe TOTP.
2. Doładuj portfel kartą lub USDT/USDC.
3. Wybierz Albanię i usługę, sprawdź wyświetlaną cenę i potwierdź zamówienie.
4. Wpisz numer weryfikacyjny z Albanii w aplikacji; kod pojawi się na stronie aktywacji, gdy dotrze SMS.

Z tej ścieżki zwykle korzystają agencje zarządzające profilami klientów i pracownicy operacyjni zakładający regionalne konta firmowe. Zamówienia składane tutaj i przez API współdzielą jeden portfel i tę samą zasadę zwrotu.

Co zrobić, jeśli albański SMS nie dotrze?

Aktywacja pozostaje otwarta przez 20 minut. Płacisz tylko wtedy, gdy kod dotrze; jeśli okno zamknie się puste albo wcześniej anulujesz, cała kwota sama wraca do portfela, a webhook wysyła activation.expired lub activation.cancelled.

Gdy kodu brakuje:

• Daj oknu czas, zanim zareagujesz, bo niektóre usługi wysyłają powoli.
• Sprawdź, czy usługa w ogóle akceptuje numery wirtualne; niektóre odrzucają je z zasady.
• Spróbuj później albo przez inną trasę usługi, jeśli test na to pozwala.
• Unikaj ponownego zamawiania w ciasnej pętli. Rób przerwy między próbami, aby skrypt nie bombardował trasy.

Nasz tekst o ograniczaniu nieudanych dostaw OTP zawiera dalsze wzorce ponowień dla tras bałkańskich i nie tylko. Używaj tych numerów wyłącznie do własnych produktów i kont, przestrzegaj regulaminu każdej usługi i pamiętaj, że obowiązuje Regulamin dopuszczalnego użytkowania OTP Route.

Czy istnieje długoterminowa linia albańska i jak wygląda rozliczanie?

Dla Albanii nie ma samoobsługowego numeru długoterminowego. Numery wirtualne dedykowane są sprzedawane natychmiast wyłącznie w Stanach Zjednoczonych i Kanadzie, od $1.95/month, z SMS-ami przychodzącymi, przekazywaniem na webhook, SMS-ami wychodzącymi i połączeniami w przeglądarce. Jeśli potrzebujesz trwałej linii albańskiej, napisz na [email protected]; to, czy da się ją załatwić, zależy od lokalnych przepisów i nie jest gwarantowane.

Rozliczenia opierają się na jednym przedpłaconym portfelu w USD, bez opłaty miesięcznej i bez wyboru planu. Doładuj go kartą lub USDT/USDC, a do każdego doładowania dostaniesz fakturę PDF e-mailem. Aktualne stawki są na stronie z cennikiem. Do prac integracyjnych poproś o przełączenie konta deweloperskiego w tryb sandbox, który zwraca symulowane numery i kody, dzięki czemu można przetestować pipeline bez wydawania środków z portfela.

Najczęstsze pytania

Czy mogę przetestować albański proces rejestracji w mojej aplikacji bez lokalnej karty SIM?

Tak. Zamów numer z OTP Gateway z krajem al, wpisz go na ekranie rejestracji i odczytaj kod w panelu lub z webhooka. Nie jest potrzebna karta SIM ani lokalna umowa z operatorem.

Ile kosztuje albański kod weryfikacyjny?

Kody zaczynają się od $0.20, a dokładną cenę dla danej usługi zwraca GET /api/v1/prices przed zamówieniem. Jeśli nic nie dotrze w 20-minutowym oknie, opłata wraca do portfela.

Czy zapisywać albańskie numery z początkowym 0?

Nie. Zapisuj je w E.164, czyli +355 i numer krajowy bez prefiksu 0, a zero dodawaj z powrotem tylko do lokalnego wyświetlania.

Czy ten sam numer +355 można użyć do późniejszego logowania?

Numer z OTP Gateway obsługuje jeden kod weryfikacyjny. Dla kont, które muszą się logować dalej, użyj numeru dedykowanego w USA lub Kanadzie albo zapytaj support o Albanię.

Czy OTP Route ma sandbox do testów integracji dla Albanii?

Tryb sandbox można włączyć dla konta deweloperskiego na prośbę. Zwraca symulowane numery i kody, więc przebiegi CI sprawdzają cały przepływ bez ruszania środków z portfela.

Dlaczego aplikacja odrzuciła mój albański numer?

Niektóre usługi odrzucają numery wirtualne. Anuluj aktywację lub poczekaj, aż wygaśnie, aby dostać automatyczny zwrot, a potem spróbuj o innej porze albo inną trasą.

Jakiego identyfikatora API użyć dla Albanii?

Użyj al jako wartości kraju w zapytaniach o cenę i żądaniach aktywacji, a identyfikator usługi pobierz z GET /api/v1/services.

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.