Чек-лист получения SMS-кодов Twitch на номера OTP Route

Чек-лист перед первым заказом для Twitch

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

• Цель законна: вы тестируете собственную интеграцию, расширение или ведёте аккаунт канала, принадлежащий вашей организации.
• API-ключ готов: Bearer-ключ (префикс or_live_) из консоли разработчика.
• Вебхук-эндпоинт зарегистрирован, а его секрет хранится на сервере.
• Страна выбрана в соответствии с аудиторией аккаунта или тестовым случаем.
• Кошелёк пополнен либо запрошена песочница для пробного прогона.
• Долгосрочная потребность проверена: если аккаунту позже придётся подтверждаться снова, сначала прочитайте последний раздел.

Где Twitch запрашивает номер телефона?

Twitch может использовать номер телефона при регистрации как альтернативу электронной почте, для подтверждения аккаунта, для восстановления пароля и при включении двухфакторной аутентификации. Каналы, которые стримят, модерируют или запускают расширения, часто включают двухэтапный вход, и тогда доступный номер становится частью повседневного доступа, а не разовым шагом.

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

Из какой страны брать номер для Twitch?

Twitch доступен на маршрутах в 197 странах, включая США, Канаду, Великобританию, Германию, Бразилию, Японию, Мексику, Францию, Испанию, Польшу, Южную Корею, Турцию, Филиппины и Австралию.

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

Пошагово: OTP Twitch через API

1. Убедитесь, что идентификатор сервиса — twitch, через GET /api/v1/services и выберите идентификатор страны из GET /api/v1/countries.
2. Проверьте стоимость: GET /api/v1/prices?country=<id>&service=twitch.
3. Закажите номер: POST /api/v1/activations с телом {"service": "twitch", "country": "<id>"}.
4. Введите полученный номер в телефонное поле Twitch.
5. Дождитесь activation.sms_received или опрашивайте GET /api/v1/activations/{id}.
6. Отправьте код и завершите тест.

Базовый адрес — https://otproute.com/api/v1, лимит — 300 запросов в минуту на аккаунт. В CI-задаче оберните шаги 3–6 в одну тестовую фикстуру, которая отменяет активацию при завершении, чтобы прерванный прогон не оставлял висящий заказ; подход показан в материале о тестировании SMS OTP в CI-конвейерах.

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

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

Шаги в панели для менеджеров сообществ и каналов

API нужен не всем. В панели откройте OTP Gateway, выберите Twitch и страну, проверьте показанную цену и закажите номер. Введите номер в Twitch; код появится рядом с заказом, как только будет доставлен. Это подходит менеджеру канала, настраивающему один брендовый аккаунт. Кроме того, так личный номер стримера не попадает в профиль, принадлежащий компании, а это важно, когда сотрудники меняются и доступ нужно передать аккуратно.

Устранение проблем: нет кода, номер отклонён, окно истекло

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

Когда лучше выделенный номер США или Канады

Номер шлюза принимает один код и исчезает. Если аккаунту Twitch снова понадобятся коды — для двухэтапного входа или восстановления на общем командном логине, — лучшим инструментом будет выделенный номер (Dedicated Number). Они продаются мгновенно только для США и Канады, от $1.95/мес., и пересылают входящие SMS на ваш вебхук.

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

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

Можно ли получить OTP Twitch без личного телефона?

Да. Команда может заказать номер для twitch в OTP Gateway и прочитать код в панели, не привязывая телефоны сотрудников к брендовым аккаунтам.

Сколько стоит код Twitch?

От $0.20 за код, в зависимости от страны. Актуальную цену до заказа возвращает GET /api/v1/prices.

Почему Twitch не прислал код на мой номер?

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

Подходит ли виртуальный номер для Twitch для двухфакторного входа?

Здесь имеет смысл только долгосрочная линия. Используйте выделенный номер в США или Канаде, так как номера шлюза принимают единственный код.

Можно ли запускать проверку по SMS Twitch для тестирования в CI?

Да. Запускайте заказы из конвейера через API и обрабатывайте вебхук; песочница позволяет не тратить средства кошелька во время разработки.

Связан ли OTP Route с Twitch?

Нет. Twitch — товарный знак его владельца, и OTP Route никак с ним не связан.

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