Направляем албанские (+355) OTP в ваш тестовый конвейер

Какие REST-вызовы возвращают албанский номер и его код?

API OTP для Албании — это тот же API SMS-верификации, что и для любого другого рынка; меняется только идентификатор страны. Запросы идут на https://otproute.com/api/v1 с Bearer-ключом с префиксом or_live_, созданным в консоли разработчика. Идентификатор Албании — al, поэтому типичный прогон выглядит так:

1. GET /api/v1/services определяет нужный идентификатор сервиса, например telegram или google. Кэшируйте список между прогонами.
2. GET /api/v1/prices?country=al&service=<id> читает актуальную цену и подтверждает, что маршрут сейчас открыт.
3. POST /api/v1/activations с телом {"service": "telegram", "country": "al"} возвращает идентификатор активации и номер +355.
4. Ваш тест вводит этот номер на экране регистрации или входа тестируемого приложения.
5. Код приходит через вебхук или при опросе GET /api/v1/activations/{id}; если тест прерван, вызовите POST /api/v1/activations/{id}/cancel.

В аккаунте может быть до 10 ключей, так что staging, CI и ноутбук коллеги могут получить собственные и отзываться по отдельности. Лимит 300 запросов в минуту оставляет запас для нескольких параллельных наборов тестов. Подробности по полям — в справочнике API.

Что выбрать для тестов по Албании — опрос или вебхуки?

Опрос проще всего подключить: обращайтесь к эндпоинту активации каждые несколько секунд, пока не изменится статус. Когда наборы тестов выполняются параллельно, удобнее вебхук. Зарегистрируйте до 5 эндпоинтов и подпишитесь на activation.sms_received, activation.expired и activation.cancelled.

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

Как нормализовать номера +355 перед сохранением в базу?

Албания использует код страны +355 и внутренний префикс 0. Локально мобильный номер обычно пишут с этим 0 впереди — 06X XXX XXXX, а в международной форме он отбрасывается: +355 6X XXX XXXX. Храните версию E.164 (+3556…, без пробелов), а локальное форматирование применяйте только при отображении.

Какие проверки стоит добавить при валидации номера +355 для тестирования:

• Убирайте ведущий 0, когда пользователь вводит национальную форму после того, как уже выбрал +355.
• Отклоняйте двойной префикс вроде +355 0 6X, который появляется, когда форма вслепую приклеивает код страны к местному номеру.
• Не допускайте пробелов, дефисов и скобок в сохраняемом значении.

Формулировка вокруг кода зависит от отправляющего сервиса и языка аккаунта; распространены и албанский, и английский. Ориентируйтесь в парсере на цифры, а не на фиксированную фразу. Команды тестируют этот рынок при запуске в Албании, при локализации приложения для албаноговорящих в регионе и за рубежом или чтобы убедиться, что региональный операционный аккаунт по-прежнему проходит верификацию.

Что можно подтвердить на албанском маршруте?

Албанский маршрут сейчас включает более 1500 сервисов. Среди популярных в актуальном срезе — WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, Viber, Signal, Microsoft & Outlook, ChatGPT (OpenAI), Uber, LinkedIn и Discord.

Наличие меняется в течение дня, поэтому доступность берётся из API, а не из статического списка. Привязывайте каждый тест к запросу цены для al и помечайте его как пропущенный, а не упавший, если маршрут случайно закрыт. Так шум маршрутизации OTP не попадёт в результаты ваших настоящих регрессионных тестов.

Сможет ли нетехнический коллега заказать номер +355?

Да. Панель покрывает тот же процесс без единой строки кода:

1. Зарегистрируйтесь по электронной почте и 6-значному коду из письма или через вход Google, затем включите двухфакторную аутентификацию TOTP.
2. Пополните кошелёк картой или в USDT/USDC.
3. Выберите Албанию и сервис, проверьте показанную цену и подтвердите заказ.
4. Введите албанский номер подтверждения в приложение; код появится на странице активации, когда придёт SMS.

Этим путём обычно пользуются агентства, ведущие клиентские профили, и операционные сотрудники, настраивающие региональные бизнес-аккаунты. Заказы отсюда и через API используют один кошелёк и одно правило возврата.

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

Активация остаётся открытой 20 минут. Вы платите, только если код пришёл; если окно закрылось пустым или вы отменили заказ раньше, вся сумма сама возвращается в кошелёк, а вебхук отправляет activation.expired или activation.cancelled.

Если кода нет:

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

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

Есть ли долгосрочная албанская линия и как устроена оплата?

Самостоятельно оформить долгосрочный номер для Албании нельзя. Dedicated Virtual Numbers продаются мгновенно только в США и Канаде, от $1.95 в месяц, со входящими SMS, пересылкой на вебхук, исходящими SMS и звонками из браузера. Если вам нужна постоянная албанская линия, напишите на [email protected]; возможность зависит от местных правил и не гарантируется.

Оплата идёт через один предоплаченный кошелёк в долларах США без абонентской платы и без выбора тарифа. Пополняйте картой или в USDT/USDC, и к каждому пополнению по электронной почте приходит PDF-счёт. Актуальные цены — на странице тарифов. Для интеграционной работы попросите перевести аккаунт разработки в режим песочницы: он возвращает симулированные номера и коды, так что конвейер можно проверить, не расходуя средства кошелька.

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

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

Да. Закажите номер OTP Gateway со страной al, введите его на экране регистрации и читайте код в панели или в вебхуке. SIM-карта и договор с местным оператором не нужны.

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

Коды стоят от $0.20, а точная цена для конкретного сервиса возвращается через GET /api/v1/prices до заказа. Если за 20-минутное окно ничего не пришло, сумма возвращается в кошелёк.

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

Нет. Сохраняйте их в E.164: +355 и национальный номер без внутреннего 0; 0 возвращайте только для локального отображения.

Можно ли использовать один и тот же номер +355 для последующего входа?

Номер OTP Gateway обслуживает один код подтверждения. Для аккаунтов, которым нужно входить и дальше, используйте Dedicated Number в США или Канаде либо спросите поддержку об Албании.

Есть ли у OTP Route песочница для интеграционных тестов по Албании?

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

Почему приложение отклонило мой албанский номер?

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

Какой идентификатор API использовать для Албании?

Используйте al как значение country в запросах цен и активаций, а идентификатор сервиса берите из GET /api/v1/services.

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