API проверки OTP
для перепродавцов
Перепродавайте одноразовые номера для SMS-подтверждения от $0,10 через один REST API. Мгновенное предоставление, полный возврат за неиспользованные активации и подписанные вебхуки — создавайте свою собственную платформу OTP на базе реальных номеров операторов.
Один API для каждого одноразового SMS-подтверждения, которое вам необходимо
Бесплатные публичные SMS-ящики общедоступны и уже отмечены всеми крупными платформами. Создание собственных отношений с операторами для одноразовых номеров дорогостоящее для чего-то, что клиенты используют один раз и выбрасывают.
VRNUM OTP API предоставляет вам живой, приватный пул реальных номеров операторов по требованию. Предоставьте один номер, получите код, и номер больше никому не показывается — с вашей наценкой, уже примененной ко всем отображаемым ценам.
От заказа до проверенного кода
Четыре вызова покрывают весь жизненный цикл OTP.
Проверьте каталог
GET /otp-catalog для актуальных сервисов, стран и цен — применяйте наценку до показа клиентам.
Заказать номер
POST /otp-numbers с указанием сервиса, страны и Idempotency-Key. Номер возвращается сразу.
Получить код
GET /otp-numbers/:id выполняет прямую проверку SMS, или дождитесь события otp.completed через вебхук.
Переслать или вернуть
Кода все еще нет? Попробуйте /resend, или /cancel для мгновенного полного возврата на ваш кошелек.
Заказать OTP-номер одним запросом
clientReference — это ваш собственный непрозрачный ID, прикрепите его для сопоставления заказов с вашими внутренними данными о клиентах.
curl -X POST https://vrnum.com/api/v1/otp-numbers \
-H "Authorization: Bearer vrnum_live_..." \
-H "Content-Type: application/json" \
-H "Idempotency-Key: otp-5521" \
-d '{
"service": "whatsapp",
"countryCode": "us",
"clientReference": "otp-5521"
}'Полный жизненный цикл заказа OTP
Каталог, заказ, повторная отправка, отмена/возврат и вебхуки — один единый JSON API.
/api/v1/otp-catalog/api/v1/otp-numbers/api/v1/otp-numbers/api/v1/otp-numbers/:id/api/v1/otp-numbers/:id/resend/api/v1/otp-numbers/:id/cancel/api/v1/webhook/api/v1/balanceFull request/response docs and your keys live in your dashboard after you sign in.
Who builds on the OTP verification API
Any product that needs a real phone number for a single verification step.
SMS verification platforms
Resell OTP numbers to your own customers under your brand, with your own markup on every service.
QA & test automation
Create disposable test accounts on production services without burning personal phone numbers.
Bot & agency tooling
Программное предоставление номеров для рабочих процессов создания аккаунтов, созданных для клиентов.
Инструменты для разработчиков
Предлагайте «проверку через SMS» как функцию в вашем собственном приложении или SDK без необходимости владеть телекоммуникационной инфраструктурой.
Достаточно надежно для выставления счетов вашим собственным клиентам
Ключи идемпотентности
Безопасно повторяйте при таймаутах — один и тот же Idempotency-Key всегда возвращает исходный заказ, никогда не создавая дубликат.
Подписанные вебхуки
otp.completed, number.provisioned и number.provisioning_failed события, подписанные с помощью X-VRNUM-Signature.
Автоматические повторы
Неудачные доставки вебхуков повторяются по графику с увеличением интервала (5 мин, 30 мин, 2 ч, 6 ч, 24 ч) перед тем, как мы сдаёмся.
Прозрачные лимиты запросов
60 запросов в минуту на ключ с заголовками X-RateLimit-* в каждом ответе.
Оплата через кошелек
Никаких счетов или подписок — заказы и возвраты мгновенно отражаются на вашем балансе.
Стабильные коды ошибок
Каждая ошибка возвращает нормализованный JSON-код, на который ваша интеграция может надежно ориентироваться.
Часто задаваемые вопросы
Могу ли я перепродавать OTP-коды через API VRNUM?
Да. Эндпоинты otp-catalog и otp-numbers возвращают только вашу цену перепродажи. Устанавливайте собственную наценку по каждому сервису и стране — ваши клиенты никогда не видят внутреннюю стоимость VRNUM.
Что происходит, если OTP-код никогда не приходит?
Вызовите POST /otp-numbers/:id/cancel для активации, которая всё ещё ожидает, чтобы получить полный возврат средств на ваш кошелёк. Вы также можете сначала вызвать конечную точку повторной отправки.
Как долго активация OTP остаётся действительной через API?
Каждая активация активна в течение 20 минут с момента создания. Отмените до истечения времени, чтобы получить полный возврат средств, если код не придёт.
Как избежать двойного списания с клиента при повторной попытке?
Отправьте заголовок Idempotency-Key при POST /otp-numbers. Повторная отправка того же запроса с тем же ключом вернёт исходный заказ вместо создания нового.
Могу ли я получать события доставки в реальном времени вместо опроса?
Да. Зарегистрируйте конечную точку вебхука и получайте подписанные события otp.completed в момент их появления, вместо опроса.
Какие сервисы поддерживаются через API?
Более 80 сервисов, включая WhatsApp, Telegram, Google, Instagram, Facebook, Discord и другие. Вызовите GET /otp-catalog для актуального списка.
Начните перепродавать OTP-номера уже сегодня
Создайте бесплатную учетную запись, сгенерируйте ваш API-ключ и получите свой первый номер OTP за считанные минуты.