Номера подтверждения Фарерских островов для разработчиков и QA-команд

Что выбрать для Фарерских островов: разовый код или постоянную линию?

Начните с вопроса, который определяет всё остальное: нужно ли вашему аккаунту или тестовому случаю получить один код или тот же номер понадобится и через месяц?

• Один код — и всё. Регистрация QA-аккаунта, проверка, что фарерский экран регистрации принимает номер +298, подтверждение того, что локализованный шаблон OTP отображается правильно. Это закрывает OTP Gateway.
• Один и тот же номер на месяцы. Тестовый вход, который требует повторной проверки, общий операционный ящик, линия поддержки. Здесь нужен Dedicated Number, а они продаются самостоятельно только в США и Канаде, от $1.95/месяц.

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

Какие сервисы могут присылать коды на маршрут +298?

Фарерский маршрут сейчас показывает более 300 сервисов. Среди популярных в актуальном срезе WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, X (Twitter), ChatGPT (OpenAI), Microsoft & Outlook, Amazon, Discord, LinkedIn, Signal и Airbnb.

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

Как работает поток Faroe Islands OTP API от запроса до кода?

Создайте Bearer-ключ в консоли разработчика; боевые ключи имеют префикс or_live_, а все вызовы идут на https://otproute.com/api/v1. Типичный прогон состоит из четырёх шагов:

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

Вызовы вебхука подписаны заголовком X-OTPRoute-Signature: t=<unix>,v1=<hex>. Ваш приёмник должен воссоздать HMAC-SHA256 от <t>.<raw body> с секретом этого эндпоинта, сопоставить его с v1 сравнением за постоянное время и игнорировать любую доставку со слишком старой меткой времени. Аккаунт допускает 10 ключей, 5 эндпоинтов вебхука и 300 запросов в минуту; все поля перечислены в справочнике API.

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

Да. Сотрудники операционных отделов и поддержки могут сделать всё в браузере:

1. Войдите и откройте страницу OTP Gateway.
2. Выберите Faroe Islands, затем сервис, который проверяете.
3. Подтвердите показанную цену перед заказом и нажмите, чтобы зарезервировать номер.
4. Вставьте номер +298 на экран регистрации или входа в приложении.
5. Следите за карточкой заказа: код появится там, когда придёт SMS.

Номер принадлежит именно этой активации, поэтому завершите шаг в пределах 20-минутного окна, а не откладывайте на потом.

Что необычного в хранении и проверке номеров +298?

Фарерский план нумерации закрытый и короткий. Абонентские номера состоят из шести цифр, префикса для внутренних звонков нет — ни добавлять, ни убирать нечего, а каноническая форма E.164 — просто +298 и эти шесть цифр. Такая краткость ломает больше форм, чем можно подумать: валидаторы, рассчитанные на национальные номера из восьми–десяти цифр, отвергают вполне корректный фарерский ввод, а некоторые базы данных дополняют или обрезают короткие значения. Храните полную строку E.164, проверяйте по правилам с учётом страны и включите в набор тестов случай из шести цифр.

На островах широко используются и фарерский, и датский языки, а многие глобальные приложения всё же присылают коды на английском или следуют локали устройства. Если вы локализуете собственные сообщения на фарерский, буквы вроде ð и á не входят в стандартный алфавит GSM-7, поэтому сообщение переключается на UCS-2 и в сегмент помещается меньше символов. Проверьте это на реальном маршруте до запуска.

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

Что делать, если фарерский код не приходит?

Отсутствие кода обычно связано с маршрутом или приёмом сервисом, а не с ошибкой в вашей интеграции. Разберитесь спокойно:

• Дайте отработать 20-минутному окну; некоторые сервисы ставят SMS в очередь перед отправкой.
• Проверьте, принимает ли сервис виртуальные номера: некоторые нет и просто ничего не отправляют.
• Повторите позже или попробуйте другой маршрут сервиса для того же сценария.
• Не заказывайте повторно в быстром цикле; разреженные попытки бережнее и к маршруту, и к истории вашего кошелька.

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

Как оплачивается проверка для Faroe Islands?

Фарерские заказы списываются с того же предоплаченного кошелька в USD, что и любые другие покупки в OTP Route, без подписки и ежемесячных платежей. Пополняйте картой либо стейблкоинами USDT/USDC, и на каждое пополнение или покупку номера по почте приходит PDF-счёт. Цены на коды начинаются от $0.20 за код и зависят от сервиса и страны; страница цен и эндпоинт цен всегда показывают актуальную сумму. Для работы над интеграцией аккаунт разработки по запросу можно переключить в песочницу, чтобы имитированные номера и коды проходили через ваш обработчик без расхода средств кошелька. Используйте это для собственных продуктов и аккаунтов, соблюдайте правила каждого сервиса и помните, что действует Политика допустимого использования.

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

Можно ли протестировать регистрацию с +298 без фарерской SIM-карты?

Да. Закажите номер Faroe Islands в OTP Gateway, введите его в форму регистрации и прочитайте код в дашборде или через вебхук.

Какой идентификатор страны использует API для Faroe Islands?

Используйте fo как значение country в POST /api/v1/activations и в запросах цен.

Сколько цифр в фарерском телефонном номере?

Шесть, без префикса для внутренних звонков. В формате E.164 это +298 и эти шесть цифр.

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

Не как самостоятельный продукт: долгосрочные Dedicated Numbers существуют только для США и Канады. Можно написать на [email protected] и спросить, но доступность не гарантируется.

Плачу ли я, если сервис так и не отправил SMS?

Нет. Если сообщение не пришло за 20 минут или вы отменили раньше, сумма автоматически возвращается в кошелёк.

Можно ли попробовать интеграцию, не пополняя кошелёк?

Запросите режим песочницы для аккаунта разработки. Он возвращает имитированные номера и коды, так что весь поток можно проверить от начала до конца.

Почему список сервисов для +298 меняется в течение дня?

Наличие на каждом маршруте меняется по мере использования и пополнения номеров, поэтому API сообщает то, что доступно в момент вашего запроса.

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