OTP Verification API
для перепродавців
Перепродавайте одноразові номери для 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 — це ваш власний непрозорий ідентифікатор — прикріпіть його для зіставлення замовлень з вашими внутрішніми записами про клієнтів.
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/balanceПовна документація запитів/відповідей та ваші ключі знаходяться у вашійdashboardпісля входу.
Хто створює на основі API перевірки OTP
Будь-який продукт, що потребує реального номера телефону для одного кроку перевірки.
Платформи перевірки SMS
Перепродавайте OTP-номери своїм клієнтам під власним брендом, із власною націнкою на кожну послугу.
QA та автоматизація тестування
Створюйте одноразові тестові акаунти на продакшн-сервісах без використання особистих номерів телефону.
Інструменти для ботів та агентств
Надавайте номери програмно для робочих процесів створення облікових записів, створених для клієнтів.
Інструменти для розробників
Пропонуйте «перевірку через SMS» як функцію у вашому власному додатку або SDK без необхідності володіти телекомунікаційною інфраструктурою.
Достатньо надійно, щоб виставляти рахунок власним клієнтам
Ключі ідемпотентності
Повторюйте безпечно при таймаутах — той самий Idempotency-Key завжди повертає оригінальне замовлення, ніколи не дублікат.
Підписані вебхуки
Події otp.completed, number.provisioned та number.provisioning_failed, підписані за допомогою X-VRNUM-Signature.
Автоматичні повторні спроби
Невдалі доставки вебхуків повторюються за графіком із затримкою (5 хв, 30 хв, 2 год, 6 год, 24 год), перш ніж ми здаємося.
Прозорі обмеження швидкості
60 запитів/хв на ключ з заголовками X-RateLimit-* у кожній відповіді.
Оплата через гаманець
Жодних рахунків чи підписок — замовлення та повернення коштів відображаються на вашому балансі миттєво.
Стабільні коди помилок
Кожна помилка повертає нормалізований JSON-код, на який ваша інтеграція може надійно реагувати.
Поширені запитання
Чи можу я перепродавати OTP-номери через VRNUM API?
Так. Ендпоінти otp-catalog та otp-numbers повертають лише ціну для перепродажу. Встановлюйте власну маржу за сервіс та країну — ваші клієнти ніколи не бачать внутрішню вартість VRNUM.
Що станеться, якщо OTP-код ніколи не надійде?
Викличте POST /otp-numbers/:id/cancel для активації, яка ще очікує, щоб отримати повне відшкодування на ваш гаманець. Ви також можете спершу викликати endpoint повторної відправки.
Як довго активація OTP залишається дійсною через API?
Кожна активація залишається активною протягом 20 хвилин від моменту створення. Скасуйте перед тим, як вона закінчиться, щоб отримати повне відшкодування, якщо код не надійде.
Як уникнути подвійного списання коштів з клієнта при повторній спробі?
Надішліть заголовок Idempotency-Key у POST /otp-numbers. Повторення тієї ж заявки з тим же ключем повертає оригінальне замовлення замість створення нового.
Чи можу я отримувати події доставки в реальному часі замість опитування?
Так. Зареєструйте webhook endpoint і отримуйте підписані події otp.completed у момент їх виникнення замість опитування.
Які сервіси підтримуються через API?
Понад 80 сервісів, включаючи WhatsApp, Telegram, Google, Instagram, Facebook, Discord та інші. Викличте GET /otp-catalog для актуального списку.
Почніть перепродаж OTP-номерів сьогодні
Створіть безкоштовний акаунт, згенеруйте свій API-ключ і налаштуйте свій перший номер OTP за лічені хвилини.