Получаем чешские SMS-коды OTP через эндпоинты, вебхуки или панель

На какие эндпоинты опирается Czech Republic OTP API?

Все запросы идут на https://otproute.com/api/v1 с Bearer-ключом с префиксом or_live_. Ключи создаются в консоли разработчика, в аккаунте их может быть до 10, так что staging, CI и локальный ноутбук легко получают отдельные учётные данные, которые можно отзывать независимо. Лимит — 300 запросов в минуту на аккаунт.

Типичный прогон с номером +420 выглядит так:

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

Вызов GET /api/v1/balance перед большим набором тестов — дешёвый способ быстро упасть, если на кошельке мало средств. Полный справочник — в документации.

Как проверять вебхуки для активаций +420?

Вебхуки избавляют от опроса и хорошо подходят для параллельных тестовых раннеров. Направьте один из ваших эндпоинтов (в консоли разработчика их можно держать 5 на аккаунт) на чешский сценарий и подпишите его на activation.sms_received, activation.expired и activation.cancelled.

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

Считайте события привязанными к идентификатору активации и делайте обработчик идемпотентным: повторная доставка должна находить активацию уже завершённой и просто возвращать успех. Опрос GET /api/v1/activations/{id} остаётся допустимым запасным вариантом для скриптов, которые работают там, где нет публичного эндпоинта.

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

Чешский маршрут сейчас охватывает более 1 700 сервисов. В последнем срезе среди популярных — WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, Microsoft & Outlook, LinkedIn, Discord, Uber, Airbnb, Signal, Viber и ChatGPT (OpenAI).

Этот список не заморожен. Наличие меняется в течение дня, поэтому код должен читать доступность из API во время выполнения, а не из жёстко прописанной таблицы. Если нужного сервиса в какой-то момент нет, он может появиться позже, а для вашего тест-кейса может подойти соседний центральноевропейский маршрут.

Как хранить и разбирать чешский проверочный номер?

Нумерация в Чехии закрытая: национальные номера состоят из девяти цифр, а префикса междугородной связи нет, поэтому внутренняя и международная форма отличаются только +420 впереди. Из-за этого нормализация проще, чем на многих рынках, но в формы всё равно попадают пробелы, международный префикс 00420 или просто девять цифр. Уберите разделители, замените 00 на +, добавьте +420, если его нет, и сохраните результат в формате E.164.

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

Команды используют номер +420 для тестов, когда запускают продукт для чешских клиентов, проверяют чешские тексты онбординга или убеждаются, что региональная регистрация принимает номера без ведущего нуля. Страница QA-тестирования описывает, как команды выстраивают такие прогоны.

Что делать, если чешский код так и не пришёл?

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

• Дождитесь конца окна, прежде чем считать попытку неудачной.
• Проверьте, принимает ли тестируемый сервис виртуальные номера вообще.
• Повторите позже или попробуйте другой маршрут страны, который поддерживает сервис.
• Делайте паузы между попытками: повторные заказы в плотном цикле расходуют лимит запросов и редко помогают.
• Записывайте идентификатор активации при каждой неудаче, чтобы закономерности были видны по всем прогонам.

Могут ли не-разработчики пользоваться маршрутом +420 из панели?

Да. После того как вы зарегистрируетесь по электронной почте и 6-значному коду из письма (или через вход Google), откройте OTP Gateway, выберите сервис и Чехию, проверьте показанную цену и закажите номер. Проверочный номер Чехии появится сразу; вставьте его в приложение, и код отобразится на том же экране, когда придёт. Отмена из панели возвращает сумму в кошелёк так же, как вызов API.

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

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

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

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

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

Да. Закажите в OTP Gateway номер +420 для нужного сервиса, введите его в приложение и прочитайте код в панели, через API или вебхук.

Какой идентификатор страны у Чехии в API OTP Route?

Используйте cz в поле country запроса POST /api/v1/activations и в запросах цен.

Сколько стоит чешский проверочный код?

Коды стоят от $0.20 за код, точную цену для каждого сервиса возвращает GET /api/v1/prices, и она показывается до заказа. Платите вы только за пришедший код.

Нужен ли чешским номерам ведущий ноль?

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

Как долго открыта активация +420?

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

Подходит ли OTP-маршрутизация в Чехию для массового создания аккаунтов?

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

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

Как самостоятельный продукт — нет. Долгосрочные выделенные номера есть только в США и Канаде, а по другим рынкам можно написать в поддержку.

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