API виртуальных номеров
для реселлеров
Программно предоставляйте выделенные виртуальные номера на месяц или год, устанавливайте собственную цену перепродажи и создавайте свой собственный бренд SMS-верификации — без необходимости владеть ни одной SIM-картой.
Зачем строить на API VRNUM вместо собственных сделок с операторами
Получение настоящих номеров мобильных операторов напрямую означает заключение SIM-контрактов, закупку оборудования, соблюдение нормативных требований и месяцы подготовки, прежде чем вы сможете продать хотя бы одну проверку. API VRNUM позволяет обойти все это.
Вы получаете мгновенный доступ к актуальному ассортименту виртуальных номеров на месяц и на год в более чем 50 странах, с вашей собственной наценкой, уже заложенной в каждую цену, которую возвращает API. Ваши клиенты видят только ваш бренд и ваши цены.
От ключа API до первой продажи
Четыре шага к работающей интеграции реселлера.
Создайте API-ключ
Создайте бесплатный аккаунт VRNUM и сгенерируйте ключ на вкладке Developers. Один активный ключ на аккаунт.
Пополните кошелек
Пополните баланс криптовалютой. Каждый заказ списывается с вашего баланса — никаких счетов, никакой ручной выставки.
Просмотрите каталог
Вызовите GET /catalog для получения актуальных стран, условий подписки и цен. Добавьте свою наценку перед отображением.
Выдача на запрос
POST /numbers с Idempotency-Key для мгновенного назначения номера, затем опрашивайте или используйте вебхуки для доставки.
Выдайте номер одним запросом
clientReference — это ваш собственный непрозрачный идентификатор — прикрепляйте его для сверки заказов с вашими внутренними учетными записями клиентов.
curl -X POST https://vrnum.com/api/v1/numbers \
-H "Authorization: Bearer vrnum_live_..." \
-H "Content-Type: application/json" \
-H "Idempotency-Key: order-8841" \
-d '{
"route": "<from catalog>",
"countryCode": "US",
"subscriptionOption": "month",
"clientReference": "order-8841"
}'Все, что вам нужно для полного жизненного цикла заказа
Каталог, предоставление услуг, получение SMS, продление, автопродление и вебхуки — одно единое JSON API.
/api/v1/catalog/api/v1/numbers/api/v1/numbers/api/v1/numbers/:id/api/v1/numbers/:id/sms/api/v1/numbers/:id/renew/api/v1/numbers/:id/autorenew/api/v1/webhook/api/v1/balanceПолная документация по запросам/ответам и ваши ключи находятся на вашейпанели управленияпосле входа в систему.
Кто использует API виртуальных номеров
Любой бизнес, которому требуется запас реальных телефонных номеров без необходимости владеть телекоммуникационной инфраструктурой.
Телеком-реселлеры
Запускайте свой собственный бренд номеров как услуги на основе живого инвентаря операторов без единого контракта на SIM-карты.
Основатели SaaS и приложений
Добавьте предоставление телефонных номеров в процесс регистрации или проверки вашего продукта с помощью нескольких API-вызовов.
Разработческие агентства
Внедряйте функции предоставления номеров для клиентских приложений без необходимости заключения собственных соглашений с операторами.
Команды QA и автоматизации
Предоставляйте одноразовые, но настоящие номера по запросу для автоматизированных тестов регистрации и проверки.
Создано для продакшена, а не для демо
Ключи идемпотентности
Повторяйте попытки безопасно при тайм-ауте — один и тот же Idempotency-Key всегда возвращает исходный заказ, никогда не создавая дубликат.
Подписанные вебхуки
события number.provisioned, number.provisioning_failed и sms.received, подписанные с помощью X-VRNUM-Signature (HMAC-SHA256).
Автоматические повторные попытки
Неудачные доставки webhook повторяются по графику с увеличением интервала (5 мин, 30 мин, 2 ч, 6 ч, 24 ч) до тех пор, пока мы не сдаемся.
Прозрачные ограничения скорости
60 запросов/минуту на ключ с заголовками X-RateLimit-* в каждом ответе, чтобы вы могли предсказуемо снижать скорость.
Оплата с кошелька
Нет счетов или подписок для доступа к API — заказы списываются с вашего баланса в момент успешного выполнения.
Стабильные коды ошибок
Каждая ошибка возвращает нормализованный JSON-код, на который ваша интеграция может надежно реагировать, а не только HTTP-статус.
Часто задаваемые вопросы
Могу ли я перепродавать виртуальные номера VRNUM под своим брендом?
Да. API возвращает только вашу цену перепродажи — ваши клиенты никогда не видят внутреннюю стоимость VRNUM или исходного оператора. Вы устанавливаете собственную наценку для каждой страны и услуги.
Как получить доступ к API виртуальных номеров?
Создайте бесплатный аккаунт VRNUM, откройте вкладку «Разработчики» и сгенерируйте API-ключ. Нет ожидания одобрения, нет ежемесячной платы за API — вы платите только со своего баланса, когда активируете номер.
Какую аутентификацию использует API?
Аутентификация с токеном Bearer. Отправляйте ваш API-ключ в заголовке Authorization: Bearer или в заголовке X-API-Key при каждом запросе.
Существует ли риск дублирования заказов, если запрос истек по времени?
Нет. Каждая конечная точка покупки принимает заголовок Idempotency-Key — повторите тот же запрос с тем же ключом, и вы получите оригинальный заказ вместо двойного списания.
Как получить уведомление, когда номер готов или приходит SMS?
Зарегистрируйте URL вебхука во вкладке «Разработчики». VRNUM отправляет подписанные события (number.provisioned, number.provisioning_failed, sms.received) на ваш эндпоинт, автоматически повторяя неудачные доставки.
Каковы ограничения скорости API?
60 запросов на ключ в минуту. Каждый ответ содержит заголовки X-RateLimit-Limit, X-RateLimit-Remaining и X-RateLimit-Reset, чтобы вы могли корректно регулировать нагрузку.
Начните перепродажу виртуальных номеров уже сегодня
Создайте бесплатный аккаунт, сгенерируйте свой API-ключ и получите первый виртуальный номер за считанные минуты.