Получайте новозеландские SMS-коды OTP через API или панель

Временный номер +64 или долгосрочная линия: что мне нужно?

Правильный выбор продукта в самом начале избавит от переделок.

Выбирайте OTP Gateway, когда для теста или онбординга нужен ровно один код: свежий QA-аккаунт, дымовой тест экрана регистрации для Новой Зеландии, проверка того, что сценарий киви-клиента работает от начала до конца. Вы получаете номер, один код, и сессия закрывается.

Выбирайте Dedicated Number, когда в тот же аккаунт нужно снова войти через несколько недель или когда команде нужен общий номер для восстановления доступа. Такие долгосрочные линии предлагаются только в США и Канаде, от $1.95/month, а входящие SMS пересылаются как события number.sms_received.

Для самой Новой Зеландии самостоятельно оформить долгосрочный номер нельзя. Напишите на [email protected], если вашему сценарию он нужен; ответ зависит от местных правил и может быть отрицательным. Звонки, исходящие SMS и условия продления для североамериканских линий описаны на странице виртуальных номеров.

Зачем продуктовым командам тестировать регистрацию в Новой Зеландии?

Новая Зеландия — популярный рынок для мягкого запуска англоязычных приложений: небольшая аудитория, знакомый язык и ранний часовой пояс делают её удобной площадкой, чтобы понаблюдать за реальным онбордингом до более широкого релиза. Поэтому шаг подтверждения +64 нередко становится первым боевым сценарием, с которым сталкивается новый рынок, и для него стоит завести отдельные тест-кейсы.

Стоит проверить несколько вещей:

• Язык. Официальными являются английский, te reo маори и новозеландский жестовый язык. Большинство сервисов отправляют коды по-английски, но если в ваших шаблонах встречаются слова маори с макронами (ā, ō, ū), эти символы не входят в GSM-7 и переводят SMS в UCS-2, из-за чего каждый сегмент становится короче.
• Границы суток. Новая Зеландия одной из первых встречает новый календарный день, поэтому логика срока действия и лимитов, привязанная к датам, у местных пользователей может вести себя иначе.
• Соответствие рынку. QA-аккаунт, подтверждённый местным номером, проходит ту же страновую логику, с которой столкнутся ваши новозеландские пользователи.

Шаблон релизного контроля на основе подобных проверок — в наших заметках о QA-тестировании.

Как хранить и нормализовать мобильные номера +64?

В Новой Зеландии используется магистральный префикс 0. Мобильный номер, записанный в национальном формате как 021 123 4567, в E.164 превращается в +64211234567: отбросьте ведущий 0 и добавьте +64. Мобильные диапазоны начинаются с 2 после отбрасывания нуля, а их длина варьируется, поэтому не фиксируйте жёстко одно количество цифр.

Практические правила для вашей схемы данных:

• Храните одну каноническую строку E.164, а форматируйте её только при отображении.
• Принимайте ввод с пробелами, дефисами или магистральным нулём, затем нормализуйте его поддерживаемой библиотекой разбора телефонных номеров.
• Добавьте тестовые фикстуры для национальной и международной записи, а также для номера, который пользователь вставил с +64 и с оставленным 0.

Какие приложения отправляют коды на новозеландские номера в OTP Route?

Маршрут +64 обслуживает более 800 сервисов. По текущему снимку, к часто используемым относятся Google (Gmail & YouTube), WhatsApp, Telegram, Facebook, Instagram, TikTok, ChatGPT (OpenAI), Claude, Microsoft & Outlook, Amazon, Discord, Snapchat, LinkedIn, Uber и Netflix.

Поскольку доступность меняется в реальном времени, в начале каждого прогона обращайтесь к GET /api/v1/countries и GET /api/v1/services, а не кэшируйте список на недели. Если у сервиса мало номеров +64, обычный запасной вариант для сравнения в англоязычной среде — соседний маршрут Австралии.

Как выглядит последовательность вызовов OTP API для Новой Зеландии?

Каждый вызов для +64 отправляется на https://otproute.com/api/v1 с Bearer-ключом or_live_, выпущенным в консоли разработчика. Последовательность такая:

1. Узнайте актуальную цену через GET /api/v1/prices?country=nz&service=uber.
2. Создайте активацию через POST /api/v1/activations с телом {"service": "uber", "country": "nz"}.
3. Получите код, опрашивая GET /api/v1/activations/{id}, либо дождитесь события activation.sms_received на вебхуке. События activation.expired и activation.cancelled подскажут, когда пора убирать за собой.
4. Отменяйте неиспользованные заказы через POST /api/v1/activations/{id}/cancel и следите за средствами через GET /api/v1/balance.

Для вебхуков проверяйте X-OTPRoute-Signature, вычисляя HMAC-SHA256 от <t>.<raw body> с секретом конечной точки, отклоняйте старые метки времени и делайте обработчик идемпотентным по идентификатору активации, чтобы повторная доставка не причинила вреда. Более подробный разбор есть в руководстве по интеграции; лимит — 300 запросов в минуту на аккаунт.

Может ли не разработчик заказать новозеландский номер для подтверждения?

Конечно. В панели выберите Новую Зеландию, укажите сервис, проверьте показанную цену и подтвердите заказ. Номер +64 появится в заказе; введите его в приложении, запросите SMS, и код отобразится на той же карточке, как только придёт. Всё происходит в пределах 20-минутного окна, поэтому откройте нужное приложение до оформления заказа.

Что делать, если код +64 так и не пришёл?

Сначала дайте окну отработать полные 20 минут: некоторые отправители задерживают или группируют SMS. Если пусто и после этого, возможно, сервис отказывается от виртуальных номеров или маршрут перегружен; повторите позже или проверьте другой маршрут сервиса, а не отправляйте новые заказы один за другим. Заказы без ответа, а также отменённые вами возвращаются на кошелёк автоматически. Оплата — по мере использования с предоплаченного кошелька в USD: пополнение картой или USDT/USDC, PDF-счёт на каждое пополнение, без абонентской платы, а по запросу доступен режим песочницы для пробных прогонов. OTP Route предназначен для ваших собственных законных аккаунтов и продуктов, с соблюдением условий каждого сервиса и нашей Политики допустимого использования.

Частые вопросы

Можно ли проверить новозеландскую регистрацию в моём приложении без местной SIM-карты?

Да. Закажите номер +64 в OTP Gateway, используйте его в своей форме регистрации и прочитайте код в панели или через API.

Нужно ли сохранять 0 при записи новозеландского мобильного номера?

Нет. Магистральный 0 в E.164 отбрасывается, поэтому 021 123 4567 хранится как +64211234567.

Какой идентификатор страны в API у Новой Зеландии?

Это nz; он используется в запросах цены и в теле запроса на активацию.

Сколько стоит код подтверждения для Новой Зеландии?

Цены начинаются от $0.20 за код и зависят от сервиса; точную сумму до заказа показывают панель и GET /api/v1/prices.

Можно ли арендовать новозеландский номер на несколько месяцев?

Самостоятельно оформить долгосрочную линию +64 нельзя. Dedicated Numbers доступны только в США и Канаде, а про другие страны можно спросить, написав на [email protected].

Что лучше для получения кодов +64: опрос или вебхук?

Опрос проще для одного скрипта; подписанный вебхук лучше масштабируется, когда параллельно идёт много тестовых задач. Оба способа возвращают один и тот же код.

Примет ли любое приложение новозеландский номер OTP Route?

Не обязательно. Некоторые сервисы отклоняют виртуальные номера, поэтому заказ без SMS автоматически возвращается.

Названия сервисов являются товарными знаками их владельцев. OTP Route не связан с ними. Используйте номера законно, соблюдайте условия каждого сервиса и нашу Политику допустимого использования.