API de vérification OTP
pour les revendeurs
Revendez des numéros de vérification SMS à usage unique à partir de 0,10 $ via une API REST. Approvisionnement instantané, remboursement complet des activations inutilisées et webhooks signés : créez votre propre plate-forme OTP en plus des numéros d'opérateur réels.
Une API pour chaque vérification SMS unique dont vous avez besoin
Les boîtes de réception SMS publiques gratuites sont lisibles publiquement et déjà signalées par toutes les principales plateformes. Construire vos propres relations avec un opérateur pour des numéros à usage unique est coûteux à mettre en place pour quelque chose que les clients utilisent une fois et jettent.
L'API VRNUM OTP vous offre un pool privé et en direct de numéros d'opérateur réels à la demande. Achetez-en un, recevez le code et le numéro n'est jamais montré à personne d'autre - votre majoration étant déjà appliquée à chaque prix que vous affichez.
De la commande au code vérifié
Quatre appels couvrent l’intégralité du cycle de vie d’OTP.
Consultez le catalogue
OBTENEZ /otp-catalog pour les services en direct, les pays et les prix : appliquez votre majoration avant de montrer aux clients.
Commander un numéro
POST /otp-numbers avec un service, un pays et une clé d'idempotence. Un numéro revient immédiatement.
Obtenez le code
GET /otp-numbers/:id vérifie en direct le SMS ou attendez l'événement webhook otp.completed.
Renvoyer ou rembourser
Pas encore de code ? Essayez /renvoyez ou /annulez pour un remboursement complet instantané sur votre portefeuille.
Commandez un numéro OTP en une seule demande
clientReference est votre propre identifiant opaque — joignez-le pour rapprocher les commandes avec vos enregistrements clients internes.
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"
}'Un cycle de vie complet des commandes OTP
Catalogue, commande, renvoi, annulation/remboursement et webhooks : une API JSON cohérente.
/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/balanceLes documents complets de demande/réponse et vos clés se trouvent dans votretableau de bordaprès vous être connecté.
Qui s'appuie sur l'API de vérification OTP ?
Tout produit nécessitant un vrai numéro de téléphone pour une seule étape de vérification.
Plateformes de vérification par SMS
Revendez des numéros OTP à vos propres clients sous votre marque, avec votre propre majoration sur chaque service.
Assurance qualité et automatisation des tests
Créez des comptes de test jetables sur les services de production sans graver de numéros de téléphone personnels.
Outils de bot et d'agence
Provisionnez les numéros par programmation pour les workflows de création de comptes conçus pour les clients.
Outils de développement
Proposez la fonctionnalité « vérifier par SMS » dans votre propre application ou SDK sans posséder d'infrastructure de télécommunications.
Suffisamment fiable pour facturer vos propres clients
Clés d'idempotence
Réessayez en toute sécurité en cas d'expiration du délai - la même clé d'idempotence renvoie toujours l'ordre d'origine, jamais un doublon.
Webhooks signés
Événements otp.completed, number.provisioned et number.provisioning_failed, signés avec X-VRNUM-Signature.
Nouvelles tentatives automatiques
Les livraisons de webhooks ayant échoué réessayent selon un calendrier d'attente (5 min, 30 min, 2 h, 6 h, 24 h) avant d'abandonner.
Limites de taux transparentes
60 requêtes/minute par clé avec des en-têtes X-RateLimit-* sur chaque réponse.
Facturation financée par le portefeuille
Pas de factures ni d'abonnements : les commandes et les remboursements sont comptabilisés sur votre solde dès qu'ils surviennent.
Codes d'erreur stables
Chaque erreur renvoie un code JSON normalisé que votre intégration peut activer de manière fiable.
Questions fréquemment posées
Puis-je revendre des numéros OTP via l'API VRNUM ?
Oui. Les points de terminaison otp-catalog et otp-numbers renvoient uniquement votre prix de revente. Définissez votre propre marge par service et par pays : vos clients ne voient jamais le coût interne de VRNUM.
Que se passe-t-il si le code OTP n'arrive jamais ?
Appelez POST /otp-numbers/:id/cancel lors d'une activation toujours en attente pour un remboursement complet sur votre portefeuille. Vous pouvez également appeler d’abord le point de terminaison de renvoi.
Combien de temps une activation OTP reste-t-elle valable via l'API ?
Chaque activation reste active pendant 20 minutes à compter de sa création. Annulez avant son expiration pour un remboursement complet si aucun code n'arrive.
Comment puis-je éviter de facturer deux fois un client lors d’une nouvelle tentative ?
Envoyez un en-tête Idempotency-Key sur POST /otp-numbers. Réessayer la même requête avec la même clé renvoie la commande d'origine au lieu d'en créer une nouvelle.
Puis-je obtenir des événements de livraison en temps réel au lieu d’interroger ?
Oui. Enregistrez un point de terminaison webhook et recevez les événements otp.completed signés au moment où ils se produisent, au lieu d'une interrogation.
Quels services sont pris en charge via l'API ?
Plus de 80 services, dont WhatsApp, Telegram, Google, Instagram, Facebook, Discord et bien plus encore. Appelez GET /otp-catalog pour la liste en direct.
Commencez à revendre des numéros OTP dès aujourd'hui
Créez un compte gratuit, générez votre clé API et provisionnez votre premier numéro OTP en quelques minutes.