Собираем багамские OTP +1 242 через REST-вызовы и вебхуки

Какие запросы нужны для интеграции с API OTP для Багамских Островов?

Интеграция с API OTP для Багамских Островов — это короткая цепочка вызовов к https://otproute.com/api/v1, авторизованных Bearer-ключом с префиксом or_live_, который вы создаёте в консоли разработчика. Идентификатор страны для Багамских Островов — bs; идентификаторы сервисов вроде whatsapp или telegram берутся из каталога.

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

В аккаунте может быть до 10 ключей и 300 запросов в минуту, так что staging, CI и ноутбук коллеги могут получить отдельные ключи, которые вы отзываете независимо. Параметры и ответы этого API SMS-верификации перечислены в документации.

Как проверять подписанные вебхуки для кодов +1 242?

Опроса достаточно для одной ручной проверки; когда несколько наборов тестов работают одновременно, удобнее доставка по push. Зарегистрируйте до 5 эндпоинтов в консоли разработчика и подпишитесь на activation.sms_received, activation.expired и activation.cancelled.

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

Привязывайте обработчик к идентификатору активации и делайте его идемпотентным, потому что повторная доставка не должна дважды помечать тест как пройденный. В статье о защите вебхуков OTP с помощью HMAC рассматриваются расхождение часов и ротация секретов.

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

Багамский маршрут сейчас включает более 900 сервисов. Среди популярных — WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, X (Twitter), ChatGPT (OpenAI), Microsoft & Outlook, Amazon, Discord, LinkedIn, Uber, Airbnb и Signal. Воспринимайте этот список как срез; решающее значение имеет ответ API в момент заказа.

Коллеги, которые никогда не работают с ключами, получают тот же результат в браузере. Войдите, откройте OTP Gateway, выберите Багамские Острова и сервис, прочитайте показанную цену и оформите заказ. Номер подтверждения для Багамских Островов появляется с обратным отсчётом, и код отображается на том же экране, когда приходит.

Что происходит в 20-минутном окне и что делать, если ничего не пришло?

Каждая активация остаётся открытой 20 минут. Если за это время SMS пришло, вы платите указанную цену; если окно закрылось пустым или вы отменили заказ раньше, вся сумма автоматически возвращается в кошелёк.

Если багамский код не появился:

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

Другие шаблоны диагностики собраны в материале о снижении числа неудачных доставок OTP.

Как хранить и нормализовать номер +1 242?

Багамские Острова входят в Североамериканский план нумерации, поэтому их номера используют тот же код страны 1, что США и Канада. Полный номер — это 1, код зоны 242 и семизначный абонентский номер; в E.164 это +1242 и семь цифр, всего одиннадцать цифр. Местные жители часто называют только семь местных цифр, тогда как звонящие из других частей плана набирают 1 перед 242.

Из этого следуют два вывода для вашего кода. Валидатор, определяющий страну только по +1, пометит багамских пользователей как американских, поэтому проверяйте код зоны или используйте библиотеку нумерации, знающую территории NANP. И храните каждый номер в E.164, форматируя только для отображения, чтобы поиск и дедупликация оставались согласованными. Тексты подтверждения на багамские линии обычно приходят на английском, официальном языке, поэтому проверки локализации сосредоточены на форматировании номера и подписях стран, а не на переведённых текстах.

Зачем продуктовым командам тестировать регистрацию на Багамских Островах?

Туризм, гостиничный бизнес и финансовые услуги составляют значительную часть багамской экономики, поэтому платформам бронирования, приложениям для поездок и доставки, платёжным продуктам и банкам с клиентами в Карибском бассейне нужен рабочий путь для пользователей +1 242. Номер +1 242 для тестирования позволяет QA-инженеру убедиться, что форма принимает номер, что выбор страны показывает Багамские Острова, а не сливает их с США, и что формулировка согласия на SMS отображается корректно. Хорошая маршрутизация OTP означает и выбор правильной страны для каждого тест-кейса вместо номера по умолчанию с материка. В руководстве по QA-тестированию показано, как встроить это в автоматизированные наборы тестов. Ограничивайте все проверки аккаунтами, которыми владеет ваша организация, и соблюдайте условия каждого сервиса; ко всем заказам применяется Политика допустимого использования OTP Route.

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

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

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

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

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

Да. Закажите номер +1 242 для тестируемого сервиса в OTP Gateway, введите его в своём сценарии и читайте код в панели или по вебхуку. Вы платите от $0.20 за код, и только когда SMS пришло.

Какой идентификатор Багамских Островов в API?

Это bs. Передавайте его в GET /api/v1/prices и в теле POST /api/v1/activations.

Будет ли моя телефонная библиотека считать +1 242 американским номером?

Только если она определяет страну лишь по коду страны. Проверяйте код зоны или используйте библиотеку с данными о территориях NANP, чтобы багамские номера помечались правильно.

Спишутся ли деньги, если код так и не придёт?

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

Можно ли оставить багамский номер подтверждения для будущих входов?

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

Сколько запросов может отправлять набор тестов?

До 300 запросов в минуту на аккаунт, распределённых по не более чем 10 API-ключам. Опрос раз в несколько секунд или переход на вебхуки удерживает вас в этих пределах.

Можно ли пополнять кошелёк стейблкоинами?

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

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