API віртуальних номерів
для реселерів
Програмно надавайте виділені щомісячні та щорічні віртуальні телефонні номери, встановлюйте власну ціну перепродажу та створюйте власний бренд SMS-верифікації — без необхідності мати жодної SIM-карти.
Чому будувати на API VRNUM замість власних угод з операторами
Отримання справжніх номерів мобільного оператора безпосередньо означає контракти на SIM-карти, обладнання, витрати на дотримання вимог і місяці очікування перед тим, як ви зможете продати хоч одну перевірку. API VRNUM дозволяє обійти все це.
Ви отримуєте миттєвий доступ до актуального списку щомісячних і річних віртуальних номерів у понад 50 країнах, з вашою власною націнкою в кожній ціні, яку повертає API. Ваші клієнти бачать лише ваш бренд і вашу ціну.
Від ключа API до вашого першого продажу
Чотири кроки до працюючої інтеграції реселера.
Згенеруйте API-ключ
Створіть безкоштовний обліковий запис VRNUM і згенеруйте ключ на вкладці Розробники. Одна активна ключ на обліковий запис.
Поповніть свій гаманець
Поповнюйте криптовалютою. Кожне замовлення віднімається з вашого балансу — жодних рахунків, жодного ручного виставлення рахунків.
Перегляньте каталог
Викличте 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Повні документи запитів/відповідей та ваші ключі доступні на вашійdashboardпісля входу в систему.
Хто використовує API віртуального номера
Будь-який бізнес, який потребує постачання реальних телефонних номерів без володіння телекомунікаційною інфраструктурою.
Телеком-реселери
Запустіть власний бренд "номери як послуга" на основі активного інвентарю операторів без єдиного SIM-контракту.
Засновники SaaS та додатків
Додайте надання телефонного номера до процесу онбордингу або перевірки вашого продукту за допомогою кількох API викликів.
Розробницькі агентства
Впроваджуйте функції надання номерів для клієнтських додатків без укладання власних угод з операторами.
Команди QA та автоматизації
Надавайте одноразові, але реальні номери на вимогу для автоматизованих тестів реєстрації та перевірки.
Створено для продуктивного використання, а не для демонстрації
Ключі ідемпотентності
Безпечно повторюйте спроби при тайм-аутах — той самий Idempotency-Key завжди повертає оригінальне замовлення, ніколи дублікат.
Підписані вебхуки
Події number.provisioned, number.provisioning_failed та sms.received, підписані за допомогою X-VRNUM-Signature (HMAC-SHA256).
Автоматичні повторні спроби
Невдалі доставки вебхуків повторюються за графіком зворотного відліку (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 у кожному запиті.
Чи є ризик дублікатів замовлень, якщо запит таймаутнув?
Ні. Кожен endpoint покупки приймає заголовок Idempotency-Key — повторіть той самий запит з тим самим ключем, і ви отримаєте оригінальне замовлення замість подвійного списання.
Як дізнатися, коли номер готовий або надходить SMS?
Зареєструйте URL вебхука у вкладці Розробники. VRNUM надсилає підписані події (number.provisioned, number.provisioning_failed, sms.received) на ваш endpoint, автоматично повторюючи спроби доставки у разі невдачі.
Які обмеження швидкості API?
60 запитів на ключ за хвилину. Кожна відповідь включає заголовки X-RateLimit-Limit, X-RateLimit-Remaining та X-RateLimit-Reset, щоб ви могли плавно зменшувати навантаження.
Почніть перепродаж віртуальних номерів сьогодні
Створіть безкоштовний акаунт, згенеруйте свій API-ключ і виділіть свій перший віртуальний номер за кілька хвилин.