Virtual Number API
voor Resellers
Voorzie maandelijks en jaarlijks toegewezen virtuele telefoonnummers programmatief, stel je eigen wederverkoopprijs in en bouw je eigen SMS-verificatie merk — zonder een enkele SIM te bezitten.
Waarom bouwen op de VRNUM API in plaats van je eigen providerdeals
Het rechtstreeks verkrijgen van echte mobiele nummers van aanbieders betekent SIM-contracten, hardware, nalevingsverplichtingen en maanden voorbereidingstijd voordat je ook maar één verificatie kunt verkopen. De VRNUM API slaat dat allemaal over.
Je krijgt direct toegang tot een live voorraad van maandelijkse en jaarlijkse virtuele nummers in meer dan 50 landen, met je eigen marge verwerkt in iedere prijs die de API teruggeeft. Je klanten zien alleen jouw merk en jouw prijs.
Van API-sleutel tot je eerste verkoop
Vier stappen naar een werkende wederverkoperintegratie.
Genereer een API-sleutel
Maak een gratis VRNUM-account aan en genereer een sleutel via het tabblad Developers. Eén actieve sleutel per account.
Voeg saldo toe aan je portemonnee
Stort crypto. Elke bestelling wordt afgetrokken van je saldo — geen facturen, geen handmatige facturering.
Lees de catalogus
Roep GET /catalog op voor actuele landen, abonnementstermijnen en prijzen. Voeg je opslag toe voordat je ze weergeeft.
Voorzie op aanvraag
POST /numbers met een Idempotency-Key om direct een nummer toe te wijzen, en poll of gebruik webhooks voor levering.
Voorzie een nummer in één verzoek
clientReference is uw eigen niet-transparante ID — koppel het om bestellingen af te stemmen op uw interne klantgegevens.
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"
}'Alles wat u nodig hebt om de volledige orderlevenscyclus te beheren
Catalogus, provisioning, SMS-ophaling, verlenging, automatische verlenging en webhooks — één consistente 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/balanceVolledige request/response-documentatie en uw sleutels zijn te vinden in uwdashboardafter u zich aanmeldt.
Wie bouwt op de virtuele nummer-API
Elk bedrijf dat een voorraad echte telefoonnummers nodig heeft zonder telecominfrastructuur te bezitten.
Telecom-resellers
Start uw eigen nummers-als-een-service merk bovenop de inventaris van bestaande carriers zonder een enkel SIM-contract.
SaaS- en app-oprichters
Voeg telefoonnummervoorziening toe aan het onboarding- of verificatieproces van je product met een paar API-aanroepen.
Ontwikkelingsbureaus
Lever nummervoorzieningsfuncties voor klant-apps zonder je eigen providerovereenkomsten te hoeven onderhandelen.
QA- en automatiseringsteams
Voorzie op aanvraag wegwerpnummers die wel echt zijn voor geautomatiseerde registratie- en verificatietestsuites.
Gemaakt voor productie, niet voor een demo
Idempotentiesleutels
Herprobeer veilig bij time-outs — dezelfde idempotentiesleutel retourneert altijd de originele bestelling, nooit een duplicaat.
Ondertekende webhooks
number.provisioned, number.provisioning_failed, en sms.received gebeurtenissen, ondertekend met X-VRNUM-Signature (HMAC-SHA256).
Automatische herhalingen
Mislukte webhook-lieveringen worden opnieuw geprobeerd volgens een backoff-schema (5 min, 30 min, 2 u, 6 u, 24 u) voordat we opgeven.
Transparante snelheidslimieten
60 verzoeken/minuut per sleutel met X-RateLimit-* headers bij elke respons, zodat je voorspelbaar kunt terugschakelen.
Door wallet gefinancierde facturering
Geen facturen of abonnementen voor API-toegang — bestellingen worden onmiddellijk afgetrokken van je balans zodra ze slagen.
Stabiele foutcodes
Elke fout retourneert een genormaliseerde JSON-code waarop je integratie betrouwbaar kan schakelen, niet slechts een HTTP-status.
Veelgestelde vragen
Kan ik VRNUM virtuele nummers onder mijn eigen merk doorverkopen?
Ja. De API geeft alleen uw verkoopprijs terug — uw klanten zien nooit de interne kosten van VRNUM of de onderliggende aanbiederbron. U stelt uw eigen opslag per land en dienst in.
Hoe krijg ik toegang tot de virtuele nummer API?
Maak een gratis VRNUM-account aan, open het tabblad Developers en genereer een API-sleutel. Geen goedkeuringswacht, geen maandelijkse API-kosten — u betaalt alleen vanaf uw wallet-saldo wanneer u een nummer activeert.
Welke authenticatie gebruikt de API?
Bearer token authenticatie. Stuur uw API-sleutel als een Authorization: Bearer header of een X-API-Key header bij elk verzoek.
Zijn dubbele bestellingen een risico als een verzoek een time-out heeft?
Nee. Elk aankoopendpoint accepteert een Idempotency-Key header — probeer hetzelfde verzoek opnieuw met dezelfde sleutel en u ontvangt de originele bestelling terug in plaats van een dubbele kostenberekening.
Hoe word ik op de hoogte gebracht wanneer een nummer klaar is of een SMS aankomt?
Registreer een webhook-URL vanuit het tabblad Developers. VRNUM POSTt ondertekende evenementen (number.provisioned, number.provisioning_failed, sms.received) naar uw endpoint en probeert automatisch mislukte afleveringen opnieuw.
Wat zijn de API-snelheidslimieten?
60 verzoeken per sleutel per minuut. Elke reactie bevat de headers X-RateLimit-Limit, X-RateLimit-Remaining en X-RateLimit-Reset zodat je netjes kunt terugschakelen.
Begin vandaag met het doorverkopen van virtuele nummers
Maak een gratis account aan, genereer je API-sleutel en voorzien je eerste virtuele nummer binnen enkele minuten.