API de numéro virtuel
pour les revendeurs
Fournissez des numéros de téléphone virtuels mensuels et annuels dédiés par programmation, définissez votre propre prix de revente et créez votre propre marque de vérification SMS, sans posséder une seule carte SIM.
Pourquoi s'appuyer sur l'API VRNUM plutôt que sur vos propres offres d'opérateur
L'obtention de vrais numéros d'opérateur de téléphonie mobile signifie directement des contrats SIM, du matériel, des frais de conformité et des mois de délai avant de pouvoir vendre une seule vérification. L'API VRNUM ignore tout cela.
Vous bénéficiez d'un accès instantané à un inventaire en direct de numéros virtuels mensuels et annuels dans plus de 50 pays, avec votre propre marge intégrée à chaque prix renvoyé par l'API. Vos clients ne voient que votre marque et votre prix.
De la clé API à votre première vente
Quatre étapes pour une intégration de revendeur fonctionnelle.
Générer une clé API
Créez un compte VRNUM gratuit et générez une clé depuis l'onglet Développeurs. Une clé active par compte.
Financez votre portefeuille
Rechargez avec de la crypto. Chaque commande est déduite de votre solde — pas de factures, pas de facturation manuelle.
Lire le catalogue
Appelez GET/catalog pour connaître les pays en direct, les conditions d’abonnement et les prix. Ajoutez votre balisage avant de les afficher.
Mise à disposition sur demande
POSTez /numéros avec une clé d'idempotence pour attribuer un numéro instantanément, puis interrogez ou utilisez des webhooks pour la livraison.
Provisionner un numéro en une seule requête
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/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"
}'Tout ce dont vous avez besoin pour exécuter le cycle de vie complet des commandes
Catalogue, approvisionnement, récupération de SMS, renouvellement, renouvellement automatique et webhooks : une API JSON cohérente.
/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/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 numéro virtuel
Toute entreprise qui a besoin de numéros de téléphone réels sans posséder d’infrastructure de télécommunications.
Revendeurs de télécommunications
Lancez votre propre marque de numéros en tant que service en plus de l'inventaire réel des opérateurs, sans un seul contrat SIM.
Fondateurs de SaaS et d'applications
Ajoutez la fourniture de numéros de téléphone au flux d'intégration ou de vérification de votre produit avec quelques appels API.
Agences de développement
Expédiez des fonctionnalités de fourniture de numéros pour les applications client sans négocier vos propres accords avec le transporteur.
Équipes d'assurance qualité et d'automatisation
Fournissez à la demande des numéros jetables mais réels pour les suites de tests automatisés d’enregistrement et de vérification.
Conçu pour la production, pas pour une démo
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 number.provisioned, number.provisioning_failed et sms.received, signés avec X-VRNUM-Signature (HMAC-SHA256).
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, afin que vous puissiez reculer de manière prévisible.
Facturation financée par le portefeuille
Pas de factures ni d'abonnements pour l'accès à l'API : les commandes sont déduites de votre solde dès qu'elles réussissent.
Codes d'erreur stables
Chaque erreur renvoie un code JSON normalisé que votre intégration peut activer de manière fiable, pas seulement un statut HTTP.
Questions fréquemment posées
Puis-je revendre des numéros virtuels VRNUM sous ma propre marque ?
Oui. L'API renvoie uniquement votre prix de revente : vos clients ne voient jamais le coût interne de VRNUM ni la source du transporteur sous-jacent. Vous définissez votre propre majoration par pays et par service.
Comment puis-je accéder à l'API des numéros virtuels ?
Créez un compte VRNUM gratuit, ouvrez l'onglet Développeurs et générez une clé API. Pas d'attente d'approbation, pas de frais API mensuels : vous ne payez qu'à partir du solde de votre portefeuille lorsque vous fournissez un numéro.
Quelle authentification l'API utilise-t-elle ?
Authentification du jeton du porteur. Envoyez votre clé API sous forme d'en-tête Authorization : Bearer ou d'en-tête X-API-Key à chaque demande.
Les commandes en double constituent-elles un risque si une demande expire ?
Non. Chaque point de terminaison d'achat accepte un en-tête Idempotency-Key : réessayez la même demande avec la même clé et vous récupérez la commande d'origine au lieu de frais en double.
Comment puis-je être averti lorsqu'un numéro est prêt ou qu'un SMS arrive ?
Enregistrez une URL de webhook à partir de l'onglet Développeurs. VRNUM POST signe les événements (number.provisioned, number.provisioning_failed, sms.received) sur votre point de terminaison, réessayant automatiquement les livraisons ayant échoué.
Quelles sont les limites de débit de l'API ?
60 requêtes par clé et par minute. Chaque réponse comprend les en-têtes X-RateLimit-Limit, X-RateLimit-Remaining et X-RateLimit-Reset afin que vous puissiez reculer proprement.
Commencez à revendre des numéros virtuels dès aujourd'hui
Créez un compte gratuit, générez votre clé API et provisionnez votre premier numéro virtuel en quelques minutes.