Чек-лист для получения SMS-кодов TikTok в тестах и операционной работе

Для чего TikTok отправляет SMS-коды?

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

Виртуальный номер для TikTok подходит для этих случаев, а SMS-подтверждение TikTok для тестирования — самый частый из них. Все они законны, если аккаунт принадлежит вам или вашему клиенту и не нарушает условия TikTok.

Предполётный чек-лист перед заказом

Десять минут на эти пункты до первого заказа TikTok сэкономят часы поисков пропавших кодов:

• Выберите рынок. Страна номера должна соответствовать региону аккаунта или тестовому сценарию, который вы воспроизводите.
• Проверьте цену и наличие. GET /api/v1/prices?country=<id>&service=tiktok возвращает и то и другое в реальном времени.
• Пополните кошелёк. GET /api/v1/balance в начале прогона даёт быстрый отказ, а не сбой посреди теста.
• Определитесь со способом доставки. Вебхук — для CI и параллельных задач, опрос — для быстрых ручных проверок.
• Подумайте наперёд о повторном входе. Если аккаунту придётся входить снова в следующем месяце, одноразовый номер — неподходящий инструмент (см. последний раздел).
• Знайте правила. Один аккаунт на реального человека или компанию, условия TikTok и политика допустимого использования OTP Route.

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

Маршрут TikTok открыт в 202 странах. Часто выбирают США, Канаду, Великобританию, Германию, Францию, Бразилию, Мексику, Индонезию, Филиппины, Вьетнам, Таиланд, Турцию, Саудовскую Аравию, Пакистан, Нигерию и Кению.

Выбор страны — не формальность. TikTok адаптирует контент, функции и проверки при регистрации по регионам, поэтому QA-сценарий для запуска в Бразилии должен использовать номер +55, а тест локализации для Филиппин — +63. Несовпадение номера и рынка аккаунта — частая причина того, что процесс ведёт себя не так, как его видят пользователи.

Шаг за шагом: API кодов подтверждения TikTok

Авторизуйтесь на https://otproute.com/api/v1 ключом Bearer, начинающимся с or_live_, из консоли разработчика.

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

Лимит аккаунта — 300 запросов в минуту, этого с запасом хватает, чтобы опрашивать сразу несколько активаций. Полные формы запросов и ответов перечислены в документации API.

Создание приёмника вебхуков

Зарегистрируйте HTTPS-эндпоинт в консоли разработчика (до 5 на аккаунт) и подпишитесь на activation.sms_received, activation.expired и activation.cancelled. Затем укрепите его:

• Разберите X-OTPRoute-Signature на t и v1, вычислите HMAC-SHA256 от <t>.<raw body> с секретом эндпоинта и сравните за постоянное время.
• Отклоняйте метки времени старше нескольких минут, чтобы блокировать повторные воспроизведения.
• Используйте идентификатор активации как ключ идемпотентности, чтобы повторно доставленное событие ничего не обновляло дважды.
• Быстро отвечайте 2xx, а медленную работу передавайте в очередь.

Оставьте опрос как запасной вариант для локальной разработки, где нет публичного URL. Наше руководство по защите вебхуков OTP разбирает код проверки.

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

У молчания TikTok обычно будничная причина:

1. Дождитесь конца окна. Активация остаётся открытой 20 минут; если ничего не пришло, вся сумма возвращается автоматически.
2. Примите, что некоторые номера отклоняются. TikTok может отказывать виртуальным номерам в отдельных регионах или ситуациях, и правило возврата покрывает такой случай.
3. Меняйте одну переменную. Повторите позже или попробуйте другую страну, которая всё ещё подходит вашему тесту.
4. Не торопитесь. Многократный запрос кодов за короткое время может задействовать собственные ограничения TikTok; разносите попытки по времени.
5. Проверьте свою сторону. Убедитесь, что номер введён в полном международном формате и что ваш вебхук вернул 2xx.

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

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

Все расходы идут с одного предоплаченного кошелька в USD, который пополняется картой или в USDT/USDC, с PDF-счётом на каждое пополнение. Для интеграционных тестов с симулированными кодами по запросу можно включить sandbox-аккаунт.

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

Как автоматически доставлять код TikTok на мой бэкенд?

Закажите активацию с идентификатором сервиса tiktok, затем получите код через подписанный вебхук activation.sms_received или опросом GET /api/v1/activations/{id}.

Можно ли протестировать SMS-подтверждение TikTok для конкретной страны?

Да. Выберите страну при создании активации; маршрут TikTok сейчас охватывает 202 страны, а актуальную доступность возвращает эндпоинт цен.

Сколько стоит OTP TikTok?

От $0.20 за код, в зависимости от страны. Точная сумма отображается в панели и в GET /api/v1/prices до заказа.

Что происходит, если TikTok отклоняет виртуальный номер?

SMS не приходит, поэтому активация истекает через 20 минут или вы отменяете её, и вся сумма возвращается на ваш кошелёк.

Достаточно ли одноразового номера для бренд-аккаунта, которым мы управляем долгое время?

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

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

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

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