Получение SMS-кодов X (Twitter): чек-лист для продуктовых и QA-команд

Для чего X запрашивает номер телефона?

X использует номера телефонов в нескольких известных случаях: как альтернативу электронной почте при регистрации, при добавлении номера в существующий аккаунт, при проверках входа, вызванных необычной активностью, для сброса пароля и для двухфакторной аутентификации по SMS. За прошедшие годы X сузил круг аккаунтов, которым доступна SMS-аутентификация, и предлагает приложения-аутентификаторы, поэтому проверьте актуальные настройки тестируемого аккаунта. Каждый из этих сценариев отправляет короткий цифровой код, и каждый стоит покрыть, если ваш продукт интегрируется с аккаунтами X или управляет ими. Типичные случаи — инструмент для соцсетей, подключающий бренд-аккаунты, агентство, ведущее клиентские профили с общего командного входа, и QA-набор, проверяющий поведение вашего приложения после того, как пользователь привязал профиль X.

Предполётный чек-лист для тестирования SMS-подтверждения X (Twitter)

• Принадлежность. Аккаунт принадлежит вам, вашей компании или клиенту, который поручил вам им управлять. Один аккаунт на реального человека или компанию.
• Условия. Прочитайте правила X о номерах телефонов и автоматизации; они действуют поверх нашей политики допустимого использования.
• Страна. Решите, какой рынок представляет аккаунт, до заказа.
• Идентификатор сервиса. В OTP Route идентификатор сервиса X — twitter.
• Обвязка. Ключ Bearer (or_live_) и либо цикл опроса, либо эндпоинт вебхука.
• Срок жизни. Понадобится ли аккаунту войти снова через месяц? Если да, прочитайте раздел о выделенной линии до начала.

Из какой из 198 стран должен быть номер?

Маршрут X охватывает 198 стран, включая США, Канаду, Великобританию, Германию, Францию, Индию, Индонезию, Филиппины, Японию, Бразилию, Мексику, Турцию, Саудовскую Аравию, Кению, Нигерию и Гану. Подбирайте номер под рынок, который обслуживает аккаунт, или под тестовый сценарий, который вы доказываете: региональный бренд-аккаунт должен иметь номер из своего региона, а тест локализации требует языка и формата номера этой страны. Несоответствие номера, геопозиции IP и профиля — как раз тот сигнал, который может вызвать дополнительные проверки со стороны X.

Шаги: заказ номера для X через API

Базовый URL: https://otproute.com/api/v1.

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

Идентификаторы стран берутся из GET /api/v1/countries; формы запросов и ответов показаны в документации API.

Как построить приёмник вебхуков?

Подпишитесь на activation.sms_received, activation.expired и activation.cancelled. Каждая доставка несёт X-OTPRoute-Signature: t=<unix>,v1=<hex>; вычислите HMAC-SHA256 от метки времени, точки и необработанного тела с секретом эндпоинта, сравните за постоянное время и отклоняйте старые метки времени. Поскольку доставки могут повторяться, храните обработанные идентификаторы активаций и игнорируйте дубликаты. Опрос — хороший запасной вариант для небольших наборов тестов, он с запасом укладывается в 300 запросов в минуту. Пример реализации есть в руководстве по HMAC.

Предпочитаете кликать? В панели откройте OTP Gateway, выберите X и страну, подтвердите показанную цену, вставьте номер в X и наблюдайте, как код появляется рядом с заказом.

Диагностика: X не прислал код

• Номер отклонён. X может отказывать виртуальным номерам, иногда с сообщением, что номер использовать нельзя. Отмените активацию, затем повторите позже или в другой стране.
• Пока ничего не пришло. Оставьте 20-минутное окно открытым, а не заказывайте сразу заново.
• X ограничивает частоту. Повторные запросы с одного аккаунта могут задействовать собственные лимиты X; разносите попытки по времени.
• Ваш обработчик его потерял. Проверьте в логах ошибки подписи и другие сбои.
• Аккаунт помечен. Если X ограничил сам аккаунт, новый номер этого не изменит; решайте вопрос через собственные каналы поддержки X.

Правило возврата снимает стоимость неудачи: вы платите, только если код пришёл, а истёкшие или отменённые активации возвращают всю сумму на кошелёк.

Когда лучше подходит выделенная линия в США или Канаде?

Одноразовая активация подходит для единичного подтверждения. Корпоративному аккаунту, которому через месяцы придётся проходить проверки входа или восстанавливать доступ, нужен номер, который никуда не денется. Dedicated Numbers дают это в США и Канаде от $1.95/месяц: входящие SMS в панели и на вашем вебхуке через number.sms_received, исходящие SMS и звонки из браузера. Сравните оба варианта на странице виртуальных номеров. OTP Route списывает всё с одного предоплаченного кошелька, который пополняется картой или в USDT/USDC, с PDF-счетами.

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

Какой идентификатор сервиса X (Twitter) в API OTP Route?

Это twitter. Используйте его в запросе цен и в теле активации.

Можно ли получить OTP X без SIM-карты?

Да, на номер OTP Gateway в любой из 198 стран: код отображается в панели или отправляется на ваш вебхук.

Почему X сообщил, что мой номер телефона нельзя использовать?

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

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

От $0.20 за код; точная цена зависит от страны и показывается до заказа.

Можно ли позже снова использовать тот же номер для входа в X?

Одноразовая активация принимает один код. Для повторных входов используйте выделенный номер в США или Канаде.

Можно ли использовать OTP Route для создания множества аккаунтов X?

Нет. Сервис предназначен для тестирования и работы ваших собственных законных аккаунтов и продуктов в рамках условий X.

Есть ли sandbox для разработки интеграции?

Да. По запросу тестовый аккаунт можно переключить в sandbox, и он будет возвращать симулированные номера и коды.

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