Приём исландских проверочных кодов +354 через API

Какие вызовы API нужны для проверочного номера Исландии?

Начните с Bearer-ключа из консоли разработчика OTP Route; боевые ключи начинаются с or_live_, и в одном аккаунте их может быть до 10. Все вызовы идут на https://otproute.com/api/v1, лимит — 300 запросов в минуту, чего с запасом хватает для параллельной матрицы тестов.

• GET /api/v1/countries возвращает список стран; Исландия указана как is.
• GET /api/v1/services возвращает id сервисов, например telegram.
• GET /api/v1/prices?country=is&service=telegram даёт актуальную цену для этой пары.
• POST /api/v1/activations с {"service": "telegram", "country": "is"} резервирует номер и возвращает id активации.
• GET /api/v1/activations/{id} показывает статус и, после доставки, код.
• POST /api/v1/activations/{id}/cancel возвращает неиспользованный заказ +354 и оформляет возврат.
• GET /api/v1/balance позволяет задаче остановиться заранее, когда средства на исходе.

Пошаговое описание с примерами запросов и ответов есть в руководстве по интеграции.

Как получать код +354 вебхуком вместо опроса?

В аккаунте можно зарегистрировать до 5 HTTPS-эндпоинтов; направьте один из них на ваш исландский тест-раннер и подпишитесь на события activation.sms_received, activation.expired и activation.cancelled. События привязаны к id активации, так что обработчик может сопоставить каждое с тестом, разместившим заказ.

Каждый запрос содержит X-OTPRoute-Signature: t=<unix>,v1=<hex>. Пересчитайте HMAC-SHA256 от "<t>.<raw body>" с секретом эндпоинта, сравните за постоянное время и отклоняйте метки времени за пределами короткого допуска. Сделайте обработчик идемпотентным, ведь повторная доставка не должна дважды помечать тест как пройденный. Материал о защите вебхуков OTP разбирает пограничные случаи.

Какие сервисы работают на исландском маршруте?

Сейчас в Исландии доступно более 1 400 сервисов. В последнем срезе — WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, Snapchat, Discord, ChatGPT (OpenAI), Claude, Microsoft & Outlook, Amazon, Uber, Airbnb, Netflix и Signal.

Доступность меняется в течение дня. Запрашивайте актуальный список непосредственно перед заказом, а не полагайтесь на вчерашние результаты.

Что особенного в исландских телефонных номерах?

В Исландии нет ни транковой приставки, ни кодов региона. Абонентские номера состоят из семи цифр, а мобильные обычно начинаются с 6, 7 или 8. Это упрощает нормализацию: формат E.164 — это +354 и сразу семь цифр, а номер, который местный житель пишет в форме, — те же цифры без кода страны.

Короткая длина сбивает валидаторы, рассчитанные на более длинные национальные форматы. Если ваше поле телефона требует минимум восемь или девять цифр, исландские клиенты вообще не смогут зарегистрироваться, поэтому добавьте случай +354 в тесты ввода. Храните строку E.164, а местную группировку из семи цифр отображайте только на экране.

Зачем продуктовым командам тестировать номера +354?

Исландия часто входит в скандинавский запуск вместе с Норвегией, Данией, Швецией и Финляндией, а приложениями для путешествий, бронирования и мобильности активно пользуются как приезжие, так и местные жители. Команды тестируют там, чтобы до запуска убедиться, что шаг регистрации работает для местных клиентов, и провести QA локализации исландского интерфейса.

В исландском есть такие буквы, как þ, ð и æ. Придёт ли SMS с кодом на исландском или английском, зависит от сервиса, а текст с диакритикой может изменить кодировку сообщения. Пусть ваш парсер извлекает цифры по шаблону, чтобы переведённый шаблон никогда не ломал тест. Руководство по CI-конвейерам показывает, где в нём место этой проверке.

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

У каждой активации 20-минутное окно. Вы платите, только если код пришёл; истёкший или отменённый заказ полностью возвращается на кошелёк без каких-либо запросов с вашей стороны.

• Дождитесь конца окна, прежде чем решать, что попытка не удалась.
• Проверьте, принимает ли сервис виртуальные номера; некоторые отказывают.
• Повторите позже или через другой маршрут сервиса.
• Ограничивайте частоту повторов, а не заказывайте снова в плотном цикле.

Нетехнические сотрудники могут сделать всё это из панели: создайте аккаунт с email и 6-значным кодом из письма или через вход Google, включите TOTP, пополните баланс, выберите Исландию и сервис, подтвердите показанную цену и прочитайте код на экране.

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

Долгосрочного номера по самообслуживанию в Исландии нет. Выделенные линии — продукт для США и Канады от $1.95/месяц, с входящими и исходящими SMS и звонками из браузера. Чтобы узнать про постоянную линию +354, напишите на [email protected]; доступность зависит от местных правил и не гарантируется.

Использование списывается с единого предоплаченного кошелька в USD: по факту использования, без абонентской платы и тарифного плана. Пополняйте его картой или USDT/USDC, и за каждое пополнение на email приходит PDF-счёт. Режим песочницы для аккаунтов разработчика, доступный по запросу, возвращает имитированные номера и коды для сквозных тестов без расходов с кошелька.

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

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

Используется ли в исландских телефонных номерах ведущий ноль?

Нет. У исландских номеров нет транковой приставки, поэтому формат E.164 — это просто +354 и семизначный абонентский номер.

Какой id должен отправлять мой код для Исландии?

Используйте is как id страны, например GET /api/v1/prices?country=is&service=discord.

Сколько стоит проверочный SMS-код из Исландии?

От $0.20 за код. Точная цена зависит от сервиса, возвращается в реальном времени через GET /api/v1/prices и показывается в панели.

Можно ли запускать мои скандинавские тесты регистрации из CI с номерами +354?

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

Что будет с моими деньгами, если исландский код истечёт?

Они автоматически вернутся на кошелёк. Вы платите, только когда SMS пришло в течение 20-минутного окна.

Есть ли месячный исландский номер для входа в тестовые окружения?

Не по самообслуживанию. Выделенные номера есть только в США и Канаде; если нужно уточнить про Исландию, напишите на [email protected].

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

Да. Кошелёк принимает оплату картой и USDT/USDC, а за каждое пополнение на email приходит PDF-счёт.

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