Коды подтверждения из Ангильи (+1 264): чек-лист, шаги API и решения проблем

Чек-лист перед запуском: что должно быть готово до первого заказа для Ангильи?

Пройдитесь по этому списку один раз, и первый боевой тест обычно проходит чисто:

• API-ключ. Создайте его в консоли разработчика; ключи имеют префикс or_live_, в аккаунте их может быть до 10, поэтому выделите отдельные ключи для staging и CI.
• Средства на кошельке. Быстрый GET /api/v1/balance в начале набора тестов останавливает прогон сразу, а не на полпути.
• Правильный идентификатор страны. Ангилья в API — это ai. Этот двухбуквенный код легко спутать с меткой «AI» в другом месте конфигурации, поэтому храните его в именованной константе.
• Идентификатор сервиса. Берите его из GET /api/v1/services, а не угадывайте слаг.
• Эндпоинт вебхука (необязательно). Зарегистрируйте его в консоли, сохраните секрет и решите, как обработчик находит ожидающий тест.
• Поле телефона, принимающее +1 за пределами США. Именно это команды чаще всего обнаруживают слишком поздно; следующий раздел объясняет почему.

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

Почему номер +1 264 ломает валидацию телефона?

Ангилья входит в Североамериканский план нумерации (NANP), поэтому её номера используют общий код страны +1 вместе с США, Канадой и длинным списком карибских территорий. Остров определяет код региона 264: номер Ангильи — это +1, затем 264, затем семь цифр, то есть всего десять цифр после «плюс-единицы». Внутри NANP внутренний префикс — 1, поэтому в местных материалах ту же линию могут записывать как 1-264-xxx-xxxx.

Из-за общего кода возникает знакомый набор ошибок:

• формы, которые считают любой номер +1 американским и пытаются сопоставить его со штатом США;
• выбор страны, сохраняющий «US» для всего, что начинается с +1, что искажает аналитику и проверки правил SMS;
• валидаторы, отклоняющие незнакомые им коды регионов.

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

Шаг за шагом: заказ номера Ангильи через API

Все вызовы идут на https://otproute.com/api/v1 с ключом в заголовке Bearer.

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

Полный справочник по запросам и ответам находится в документации API.

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

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

Считайте этот список отправной точкой, а не обещанием: наличие в любой сети OTP-маршрутизации меняется в течение дня, и именно поэтому эндпоинт цен возвращает актуальную доступность для каждой пары «сервис — страна».

Как специалисты без навыков разработки проводят такой же тест в панели?

Продакт-менеджерам и сотрудникам поддержки API не нужен. После входа откройте OTP Gateway, выберите Ангилью и сервис, проверьте цену, показанную перед заказом, и подтвердите. Номер появится с обратным отсчётом; вставьте его в приложение, и на том же экране отобразится код, когда придёт SMS. Рядом с заказом есть кнопка отмены, если планы изменились. Для повторяемой регрессии в нашем руководстве по QA-тестированию показано, как команды разделяют ручные и автоматизированные проверки.

Устранение неполадок: код из Ангильи не пришёл

Пройдите по этим пунктам, прежде чем создавать обращение:

• Дайте окну отработать. Активация остаётся открытой 20 минут. Заказ второго номера через минуту после первого только распыляет внимание.
• Проверьте, принимает ли сервис такие номера. Некоторые сервисы отказываются от виртуальных номеров или применяют собственные правила риска к новым номерам. Если форма регистрации сразу отклоняет номер, отмените заказ и выберите другой маршрут.
• Повторите позже или смените маршрут. Наличие на маршруте небольшого острова меняется; повторная попытка позже или тот же сценарий в другой стране часто решают проблему.
• Избегайте плотных циклов. Повторные заказы в цикле расходуют лимит запросов и могут вызвать у целевого сервиса больше подозрений, а не меньше.
• Проверьте вебхук. Убедитесь, что обработчик проверяет X-OTPRoute-Signature и возвращает успешный ответ; руководство по проверке HMAC описывает сравнение за постоянное время и проверку меток времени.

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

Долгосрочные линии, кошелёк и счета

Хотя Ангилья набирается с кодом +1, она не входит в продукт «Выделенные номера». Самостоятельно оформляемые долгосрочные линии предлагаются только в США и Канаде, от $1.95/month, со входящими SMS, пересылкой на вебхук и звонками из браузера; см. виртуальные номера. Если вам нужна постоянная линия Ангильи, напишите на [email protected]; возможность зависит от местных правил.

Оплата идёт с одного предоплаченного кошелька в USD без абонентской платы и без выбора тарифа. Пополняйте картой или через USDT/USDC, а на почту приходит PDF-счёт за каждое пополнение. Актуальные цены — на странице тарифов. OTP Route предназначен для тестирования и работы с вашими собственными продуктами и аккаунтами в рамках условий каждого сервиса и нашей политики допустимого использования (Acceptable Use Policy).

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

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

Да. Закажите одноразовый номер +1 264 в OTP Gateway, введите его в приложении и прочитайте код в панели или через API.

Какой идентификатор страны использует API OTP Route для Ангильи?

Ангилья — это ai. Передавайте его как значение country в запросах цен и активаций.

Считается ли номер +1 264 американским?

Не должен. Он использует общий код +1, но код региона 264 принадлежит Ангилье, поэтому определение региона должно опираться на полный префикс.

Сколько стоит код подтверждения для Ангильи?

Коды стоят от $0.20 за код. Точная сумма зависит от сервиса и показывается в панели и в ответе эндпоинта цен до заказа.

Что будет, если SMS не придёт на номер?

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

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

Самостоятельно нельзя. Долгосрочные номера — продукт только для США и Канады; по любым другим вопросам напишите команде.

Можно ли настроить тесты для Ангильи до пополнения кошелька?

Да. По запросу тестовый аккаунт можно перевести в песочницу, которая возвращает имитированные номера и коды для сквозных тестов.

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