Odbieranie kodów SMS OTP z Nowej Zelandii przez API lub panel

Numer tymczasowy +64 czy linia długoterminowa: czego potrzebuję?

Dobór właściwego produktu na początku oszczędza późniejsze poprawki.

Wybierz OTP Gateway, gdy test lub krok onboardingu wymaga dokładnie jednego kodu: świeże konto QA, test dymny ekranu rejestracji dla Nowej Zelandii, sprawdzenie, czy proces użytkownika z Nowej Zelandii działa od początku do końca. Dostajesz numer, jeden kod i sesja się zamyka.

Wybierz numer dedykowany (Dedicated Number), gdy to samo konto musi zalogować się ponownie za kilka tygodni albo zespół współdzieli numer odzyskiwania. Takie linie długoterminowe są oferowane wyłącznie w Stanach Zjednoczonych i Kanadzie, od $1.95/month, a przychodzące SMS-y są przekazywane jako zdarzenia number.sms_received.

Dla samej Nowej Zelandii nie ma samoobsługowego numeru długoterminowego. Jeśli Twój przypadek tego wymaga, napisz na [email protected]; odpowiedź zależy od lokalnych przepisów i może być odmowna. Połączenia, wychodzące SMS-y i zasady odnowienia tych północnoamerykańskich linii opisuje strona numerów wirtualnych.

Dlaczego zespoły produktowe testują rejestrację w Nowej Zelandii?

Nowa Zelandia to częsty rynek na miękki start aplikacji anglojęzycznych: mniejsza grupa odbiorców, znajomy język i wczesna strefa czasowa sprawiają, że to praktyczne miejsce, by obserwować prawdziwy onboarding przed szerszą premierą. Oznacza to, że krok weryfikacji +64 bywa pierwszą produkcyjną ścieżką, którą widzi nowy rynek, i zasługuje na własne przypadki testowe.

Warto uwzględnić kilka rzeczy:

• Język. Urzędowymi językami są angielski, maoryski (te reo Māori) i nowozelandzki język migowy. Większość usług wysyła kody po angielsku, ale jeśli Twoje szablony zawierają słowa maoryskie z makronami (ā, ō, ū), te znaki leżą poza GSM-7 i przełączają SMS na UCS-2, co skraca każdy segment.
• Granice doby. Nowa Zelandia należy do pierwszych miejsc, w których zaczyna się nowy dzień kalendarzowy, więc logika wygasania i limitów oparta na datach może zachowywać się inaczej dla lokalnych użytkowników.
• Dopasowanie do rynku. Konto QA zweryfikowane lokalnym numerem sprawdza tę samą logikę kraju, na którą trafią Twoi użytkownicy z Nowej Zelandii.

Wzorzec bramki wydaniowej oparty na takich kontrolach znajdziesz w naszych notatkach o testach QA.

Jak przechowywać i normalizować numery komórkowe +64?

Nowa Zelandia używa prefiksu krajowego 0. Numer komórkowy zapisany krajowo jako 021 123 4567 w formacie E.164 przyjmuje postać +64211234567: usuń początkowe 0, potem dodaj +64. Zakresy komórkowe zaczynają się od 2 po odjęciu zera, a ich długość bywa różna, więc nigdy nie wpisuj na sztywno jednej liczby cyfr.

Praktyczne zasady dla Twojego schematu:

• Przechowuj jeden kanoniczny ciąg E.164; formatuj go tylko w momencie wyświetlania.
• Akceptuj dane ze spacjami, myślnikami lub zerem wiodącym, a potem normalizuj je za pomocą utrzymywanej biblioteki do parsowania numerów telefonów.
• Dodaj dane testowe zarówno dla zapisu krajowego, jak i międzynarodowego, a także dla numeru wklejonego z +64 oraz pozostawionym 0.

Które aplikacje wysyłają kody na numery nowozelandzkie w OTP Route?

Trasa +64 obsługuje ponad 800 usług. Według bieżącego zrzutu często używane to m.in. Google (Gmail i YouTube), WhatsApp, Telegram, Facebook, Instagram, TikTok, ChatGPT (OpenAI), Claude, Microsoft & Outlook, Amazon, Discord, Snapchat, LinkedIn, Uber i Netflix.

Ponieważ dostępność jest na żywo, na początku każdego przebiegu odpytaj GET /api/v1/countries i GET /api/v1/services, zamiast przechowywać listę w pamięci podręcznej przez tygodnie. Jeśli jakiejś usługi brakuje na trasie +64, zwykłym rozwiązaniem zastępczym do porównania anglojęzycznego jest sąsiednia trasa Australii.

Jak wygląda sekwencja wywołań OTP API dla Nowej Zelandii?

Każde wywołanie +64 trafia na https://otproute.com/api/v1 z kluczem Bearer or_live_ wydanym w konsoli deweloperskiej. Sekwencja:

1. Odczytaj aktualną cenę przez GET /api/v1/prices?country=nz&service=uber.
2. Utwórz aktywację przez POST /api/v1/activations z treścią {"service": "uber", "country": "nz"}.
3. Pobierz kod, odpytując GET /api/v1/activations/{id}, albo pozwól, by activation.sms_received dotarło na Twój webhook. Zdarzenia activation.expired i activation.cancelled informują, kiedy posprzątać.
4. Anuluj niewykorzystane zamówienia przez POST /api/v1/activations/{id}/cancel i kontroluj środki przez GET /api/v1/balance.

W przypadku webhooków zweryfikuj X-OTPRoute-Signature, obliczając HMAC-SHA256 z <t>.<raw body> przy użyciu sekretu endpointu, odrzucaj stare znaczniki czasu i zadbaj o idempotentność handlera względem identyfikatora aktywacji, aby ponowione dostarczenie nie wyrządziło szkody. Pełniejszy opis znajdziesz w przewodniku integracji; limit wynosi 300 żądań na minutę na konto.

Czy osoba niebędąca programistą może zamówić numer weryfikacyjny z Nowej Zelandii?

Oczywiście. W panelu wybierz Nową Zelandię, wskaż usługę, sprawdź wyświetloną cenę i potwierdź. Numer +64 pojawi się w zamówieniu; wpisz go w aplikacji, poproś o SMS, a kod ukaże się na tej samej karcie, gdy dotrze. Wszystko odbywa się w oknie 20 minut, więc przed zamówieniem miej otwartą docelową aplikację.

Co zrobić, gdy kod +64 nie przychodzi?

Najpierw daj oknu pełne 20 minut, bo niektórzy nadawcy opóźniają lub grupują SMS-y. Jeśli nadal jest pusto, usługa mogła odrzucić numery wirtualne albo trasa jest zajęta; spróbuj później lub przetestuj inną trasę usługi, zamiast wysyłać kolejne zamówienia jedno po drugim. Zamówienia bez odpowiedzi oraz anulowane są zwracane do portfela automatycznie. Rozliczenia działają w modelu pay as you go z przedpłaconego portfela w USD: doładowania kartą lub USDT/USDC, faktura PDF do każdego, bez opłaty miesięcznej, a tryb sandbox na życzenie do prób. OTP Route służy do Twoich własnych, legalnych kont i produktów, zgodnie z regulaminami usług i naszą Polityką Dopuszczalnego Użytkowania.

Najczęstsze pytania

Czy mogę przetestować proces rejestracji mojej aplikacji w Nowej Zelandii bez lokalnej karty SIM?

Tak. Zamów numer +64 w OTP Gateway, użyj go w formularzu rejestracji i odczytaj kod w panelu lub przez API.

Czy przy zapisie nowozelandzkiego numeru komórkowego zachowuję 0?

Nie. W E.164 prefiks krajowy 0 jest pomijany, więc 021 123 4567 zapisuje się jako +64211234567.

Jaki jest identyfikator kraju w API dla Nowej Zelandii?

To nz, używany w zapytaniach o ceny i w treści żądania aktywacji.

Ile kosztuje kod weryfikacyjny z Nowej Zelandii?

Ceny zaczynają się od $0.20 za kod i zależą od usługi; panel oraz GET /api/v1/prices pokazują dokładną kwotę przed zamówieniem.

Czy mogę wynająć numer nowozelandzki na kilka miesięcy?

Nie ma samoobsługowej linii długoterminowej +64. Numery dedykowane to produkt dla USA i Kanady; o inne kraje możesz zapytać, pisząc na [email protected].

Co lepsze do odbierania kodów +64: odpytywanie czy webhook?

Odpytywanie jest prostsze dla pojedynczego skryptu; podpisany webhook lepiej się skaluje, gdy równolegle działa wiele zadań testowych. Oba zwracają ten sam kod.

Czy każda aplikacja zaakceptuje nowozelandzki numer OTP Route?

Niekoniecznie. Niektóre usługi odrzucają numery wirtualne, dlatego zamówienie bez SMS-a jest zwracane automatycznie.

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.