API Numeri Virtuali
per Rivenditori
Fornisci numeri di telefono virtuali dedicati mensili e annuali in modo programmato, imposta il tuo prezzo di rivendita e costruisci il tuo marchio di verifica SMS — senza possedere una singola SIM.
Perché costruire sull'API VRNUM invece che sui propri accordi con gli operatori
Acquisire numeri reali di operatori mobili direttamente significa contratti SIM, hardware, oneri di conformità e mesi di tempo prima di poter vendere anche una sola verifica. L'API VRNUM salta tutto questo.
Ottieni accesso immediato a un inventario live di numeri virtuali mensili e annuali in oltre 50 paesi, con il tuo margine già incluso in ogni prezzo che l'API restituisce. I tuoi clienti vedono solo il tuo marchio e il tuo prezzo.
Dalla chiave API alla tua prima vendita
Quattro passaggi per un'integrazione funzionante per rivenditori.
Genera una chiave API
Crea un account VRNUM gratuito e genera una chiave dalla scheda Sviluppatori. Una chiave attiva per account.
Ricarica il tuo portafoglio
Ricarica con criptovaluta. Ogni ordine viene detratto dal tuo saldo — nessuna fattura, nessuna fatturazione manuale.
Leggi il catalogo
Chiama GET /catalog per vedere i paesi disponibili, le condizioni di abbonamento e i prezzi. Aggiungi il tuo margine prima di mostrarli.
Provisiona su richiesta
POST /numbers con un Idempotency-Key per assegnare un numero istantaneamente, quindi effettua polling o usa webhook per la consegna.
Provisiona un numero in una sola richiesta
clientReference è il tuo ID opaco — allegalo per riconciliare gli ordini con i tuoi record dei clienti interni.
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"
}'Tutto ciò di cui hai bisogno per gestire l'intero ciclo di vita dell'ordine
Catalogo, provisioning, recupero SMS, rinnovo, rinnovo automatico e webhook — un'unica API JSON coerente.
/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/balanceTutta la documentazione delle richieste/risposte e le tue chiavi sono disponibili nella tuadashboarddopo aver effettuato l'accesso.
Chi sviluppa sull'API del numero virtuale
Qualsiasi azienda che ha bisogno di una fornitura di numeri di telefono reali senza possedere infrastruttura di telecomunicazioni.
Rivenditori di telecomunicazioni
Avvia il tuo marchio di numeri come servizio sfruttando l'inventario live degli operatori senza un singolo contratto SIM.
Fondatori di SaaS e app
Aggiungi la fornitura di numeri di telefono al flusso di onboarding o verifica del tuo prodotto con poche chiamate API.
Agenzie di sviluppo
Rilascia funzionalità di fornitura di numeri per le app dei clienti senza negoziare i tuoi accordi con gli operatori.
Team di QA e automazione
Fornisci numeri usa e getta ma reali su richiesta per suite di test automatizzati di registrazione e verifica.
Progettato per la produzione, non per una demo
Chiavi di idempotenza
Riprova in sicurezza in caso di timeout — la stessa Idempotency-Key restituisce sempre l'ordine originale, mai un duplicato.
Webhooks firmati
eventi number.provisioned, number.provisioning_failed e sms.received, firmati con X-VRNUM-Signature (HMAC-SHA256).
Ritenti automatici
Le consegne dei webhook fallite vengono ritentate secondo un programma di backoff (5 min, 30 min, 2 h, 6 h, 24 h) prima di abbandonare.
Limiti di velocità trasparenti
60 richieste/minuto per chiave con intestazioni X-RateLimit-* in ogni risposta, così puoi ridurre le richieste in modo prevedibile.
Fatturazione con saldo wallet
Niente fatture o abbonamenti per l’accesso all’API — gli ordini vengono dedotti dal tuo saldo nel momento in cui riescono.
Codici di errore stabili
Ogni errore restituisce un codice JSON normalizzato su cui la tua integrazione può fare affidamento, non solo uno stato HTTP.
Domande frequenti
Posso rivendere numeri virtuali VRNUM sotto il mio marchio?
Sì. L'API restituisce solo il prezzo di rivendita — i tuoi clienti non vedono mai il costo interno di VRNUM o la fonte del carrier sottostante. Puoi impostare il tuo ricarico per paese e servizio.
Come posso ottenere l'accesso all'API dei numeri virtuali?
Crea un account VRNUM gratuito, apri la scheda Sviluppatori e genera una chiave API. Nessuna attesa di approvazione, nessuna tariffa mensile sull'API — paghi solo dal saldo del tuo portafoglio quando provvedi a un numero.
Che tipo di autenticazione utilizza l'API?
Autenticazione tramite token Bearer. Invia la tua chiave API come header Authorization: Bearer o come header X-API-Key in ogni richiesta.
Ci sono rischi di ordini duplicati se una richiesta va in timeout?
No. Ogni endpoint di acquisto accetta un header Idempotency-Key — ripeti la stessa richiesta con la stessa chiave e riceverai l'ordine originale invece di un addebito duplicato.
Come faccio a essere notificato quando un numero è pronto o arriva un SMS?
Registra un URL webhook dalla scheda Sviluppatori. VRNUM invia in POST eventi firmati (number.provisioned, number.provisioning_failed, sms.received) al tuo endpoint, ritentando automaticamente le consegne non riuscite.
Quali sono i limiti di richiesta API?
60 richieste per chiave al minuto. Ogni risposta include gli header X-RateLimit-Limit, X-RateLimit-Remaining e X-RateLimit-Reset così puoi ridurre il flusso di richieste senza problemi.
Inizia a rivendere numeri virtuali oggi
Crea un account gratuito, genera la tua chiave API e assegna il tuo primo numero virtuale in pochi minuti.