Virtuellt nummer-API
för återförsäljare
Tilldela dedikerade månatliga och årliga virtuella telefonnummer programmässigt, sätt ditt eget återförsäljarpris och bygg ditt eget SMS-verifieringsvarumärke — utan att äga ett enda SIM.
Varför bygga på VRNUM API istället för dina egna operatörsavtal
Att skaffa riktiga mobiloperatörsnummer direkt innebär SIM-kontrakt, hårdvara, efterlevnadsöverhead och månader av ledtid innan du kan sälja en enda verifiering. VRNUM API hoppar över allt detta.
Du får omedelbar tillgång till ett levande lager av virtuella nummer med månads- och årsabonnemang i över 50 länder, med din egen marginal inbakad i varje pris som API:et returnerar. Dina kunder ser endast ditt varumärke och ditt pris.
Från API-nyckel till din första försäljning
Fyra steg till en fungerande återförsäljarintegration.
Generera en API-nyckel
Skapa ett gratis VRNUM-konto och generera en nyckel från fliken Developers. En aktiverad nyckel per konto.
Fyll på ditt plånbok
Toppa upp med kryptovaluta. Varje beställning dras från ditt saldo — inga fakturor, ingen manuell fakturering.
Läs katalogen
Anropa GET /catalog för aktuella länder, prenumerationsvillkor och priser. Lägg till din pålägg innan du visar dem.
Provisionera vid behov
POST /numbers med en Idempotency-Key för att tilldela ett nummer direkt, sedan pollar du eller använder webhooks för leverans.
Provisionera ett nummer i en förfrågan
clientReference är ditt eget ogenomskinliga ID — bifoga det för att stämma av beställningar mot dina interna kundregister.
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"
}'Allt du behöver för att hantera hela ordercykeln
Katalog, tilldelning, SMS-hämtning, förlängning, automatisk förlängning och webhooks — ett konsekvent 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/balanceFullständig dokumentation för förfrågan/svar och dina nycklar finns i dindashboardefter att du loggat in.
Vem bygger på det virtuella nummer-API:et
Alla företag som behöver tillgång till riktiga telefonnummer utan att äga telekominfrastruktur.
Telekomåterförsäljare
Starta ditt eget nummer-som-en-tjänst-varumärke ovanpå live-operatörers lagersaldo utan ett enda SIM-kontrakt.
SaaS- och appgrundare
Lägg till telefonnummerhantering i din produkts onboarding- eller verifieringsflöde med några API-anrop.
Utvecklingsbyråer
Leverera funktioner för nummerhantering till kundappar utan att förhandla om egna operatörsavtal.
QA- och automatiseringsteam
Tillhandahåll engångsmen- ändå riktiga nummer vid behov för automatiserade registrerings- och verifieringstestsviter.
Byggt för produktion, inte en demo
Idempotensnycklar
Försök igen säkert vid timeout — samma Idempotency-Key returnerar alltid den ursprungliga beställningen, aldrig en kopia.
Signerade webhooks
number.provisioned, number.provisioning_failed och sms.received händelser, signerade med X-VRNUM-Signature (HMAC-SHA256).
Automatiska försök
Misslyckade webhook-leveranser försöker igen enligt ett backoff-schema (5 min, 30 min, 2 h, 6 h, 24 h) innan vi ger upp.
Transparanta hastighetsbegränsningar
60 förfrågningar per minut per nyckel med X-RateLimit-* rubriker på varje svar, så att du kan avvika förutsägbart.
Plånboksfinansierad fakturering
Inga fakturor eller abonnemang för API-åtkomst — beställningar dras från ditt saldo i samma ögonblick som de lyckas.
Stabila felkoder
Varje fel returnerar en normaliserad JSON-kod som din integration kan växla på pålitligt, inte bara en HTTP-status.
Vanliga frågor
Kan jag sälja vidare VRNUM virtuella nummer under mitt eget varumärke?
Ja. API:et returnerar endast ditt återförsäljningspris — dina kunder ser aldrig VRNUM:s interna kostnad eller den underliggande operatörskällan. Du bestämmer din egen påslag per land och tjänst.
Hur får jag tillgång till API:t för virtuella nummer?
Skapa ett gratis VRNUM-konto, öppna fliken Utvecklare och generera en API-nyckel. Ingen väntetid för godkännande, ingen månatlig API-avgift — du betalar bara från ditt plånbokssaldo när du tilldelar ett nummer.
Vilken autentisering använder API:t?
Bearer token-autentisering. Skicka din API-nyckel som en Authorization: Bearer-header eller en X-API-Key-header i varje förfrågan.
Är dubblettbeställningar en risk om en förfrågan tidsgräns slår ut?
Nej. Varje kö-endpunkt accepterar en Idempotency-Key-header — försök med samma förfrågan och samma nyckel och du får tillbaka den ursprungliga beställningen istället för en dubbelavgift.
Hur blir jag meddelad när ett nummer är klart eller när SMS anländer?
Registrera en webhook-URL från fliken Utvecklare. VRNUM POST-ar signerade händelser (number.provisioned, number.provisioning_failed, sms.received) till din slutpunkt och försöker automatiskt skicka om misslyckade leveranser.
Vad är API-gränserna?
60 förfrågningar per nyckel per minut. Varje svar innehåller X-RateLimit-Limit, X-RateLimit-Remaining och X-RateLimit-Reset headers så att du kan minska belastningen på ett korrekt sätt.
Börja återförsälja virtuella nummer idag
Skapa ett gratis konto, generera din API-nyckel och tilldela ditt första virtuella nummer på några minuter.