Virtual-Number-API
für Wiederverkäufer
Stellen Sie dedizierte virtuelle Telefonnummern monatlich und jährlich programmatisch bereit, legen Sie Ihren eigenen Wiederverkaufspreis fest und bauen Sie Ihre eigene SMS-Verifizierungsmarke auf — ohne eine einzige SIM-Karte zu besitzen.
Warum auf der VRNUM-API aufbauen statt auf eigene Anbietervereinbarungen
Die direkte Beschaffung echter Mobilfunkanbieternummern bedeutet SIM-Verträge, Hardware, Compliance-Aufwand und mehrere Monate Vorlaufzeit, bevor Sie eine einzige Verifizierung verkaufen können. Die VRNUM-API umgeht all das.
Sie erhalten sofortigen Zugriff auf einen aktuellen Bestand monatlicher und jährlicher virtueller Nummern in über 50 Ländern, mit Ihrer eigenen Marge bereits in jedem vom API zurückgegebenen Preis enthalten. Ihre Kunden sehen nur Ihre Marke und Ihren Preis.
Vom API-Schlüssel bis zu Ihrem ersten Verkauf
Vier Schritte zu einer funktionierenden Reseller-Integration.
Erstellen Sie einen API-Schlüssel
Erstellen Sie ein kostenloses VRNUM-Konto und generieren Sie einen Schlüssel über die Registerkarte Entwickler. Ein aktiver Schlüssel pro Konto.
Ihr Wallet aufladen
Mit Krypto aufladen. Jede Bestellung wird von Ihrem Guthaben abgezogen – keine Rechnungen, keine manuelle Abrechnung.
Den Katalog lesen
Rufen Sie GET /catalog auf, um aktuelle Länder, Abonnementbedingungen und Preise zu erhalten. Fügen Sie Ihre Gewinnspanne hinzu, bevor Sie sie anzeigen.
Bereitstellung auf Abruf
POST /numbers mit einem Idempotency-Key, um sofort eine Nummer zuzuweisen, dann abfragen oder Webhooks für die Lieferung verwenden.
Eine Nummer in einer Anfrage bereitstellen
clientReference ist Ihre eigene undurchsichtige ID – hängen Sie sie an, um Bestellungen mit Ihren internen Kundendaten abzugleichen.
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, was Sie benötigen, um den gesamten Bestellzyklus zu betreiben
Katalog, Bereitstellung, SMS-Abruf, Verlängerung, automatische Verlängerung und Webhooks – eine konsistente 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/balanceVolle Anforderungs-/Antwortdokumentation und Ihre Schlüssel befinden sich in Ihremdashboard, nachdem Sie sich angemeldet haben.
Wer baut auf der virtuellen Nummern-API auf
Jedes Unternehmen, das einen Vorrat an echten Telefonnummern benötigt, ohne eigene Telekom-Infrastruktur zu besitzen.
Telekommunikations-Reseller
Starten Sie Ihre eigene Markenlösung für Nummern-als-Dienstleistung auf der Basis eines Live-Trägerbestands, ohne einen einzigen SIM-Vertrag.
SaaS- und App-Gründer
Fügen Sie der Onboarding- oder Verifizierungsstrecke Ihres Produkts die Bereitstellung von Telefonnummern mit nur wenigen API-Aufrufen hinzu.
Entwicklungsagenturen
Liefern Sie Funktionen zur Nummernprovisionierung für Kunden-Apps, ohne eigene Anbietervereinbarungen verhandeln zu müssen.
QA- & Automatisierungsteams
Stellen Sie bei Bedarf einmal verwendbare, aber echte Nummern für automatisierte Registrierungs- und Verifizierungstestumgebungen bereit.
Für den produktiven Einsatz gebaut, nicht für eine Demo
Idempotenz-Schlüssel
Sichere Wiederholungen bei Timeouts — derselbe Idempotenz-Schlüssel liefert immer die ursprüngliche Bestellung, niemals ein Duplikat.
Signierte Webhooks
number.provisioned, number.provisioning_failed und sms.received Ereignisse, signiert mit X-VRNUM-Signature (HMAC-SHA256).
Automatische Wiederholungen
Fehlgeschlagene Webhook-Zustellungen werden gemäß einem Backoff-Zeitplan (5 min, 30 min, 2 h, 6 h, 24 h) erneut versucht, bevor wir aufgeben.
Transparente Ratenbegrenzungen
60 Anfragen/Minute pro Schlüssel mit X-RateLimit-* Headers in jeder Antwort, sodass Sie planbar zurückfahren können.
Mit Wallet finanzierte Abrechnung
Keine Rechnungen oder Abonnements für den API-Zugriff — Bestellungen werden sofort von Ihrem Guthaben abgezogen, sobald sie erfolgreich sind.
Stabile Fehlercodes
Jeder Fehler gibt einen normalisierten JSON-Code zurück, auf den Ihre Integration zuverlässig reagieren kann, nicht nur einen HTTP-Status.
Häufig gestellte Fragen
Kann ich VRNUM-Virtualnummern unter meiner eigenen Marke weiterverkaufen?
Ja. Die API gibt nur Ihren Wiederverkaufspreis zurück — Ihre Kunden sehen niemals die internen Kosten von VRNUM oder die zugrunde liegende Betreiberquelle. Sie legen Ihren eigenen Aufschlag pro Land und Dienstleistung fest.
Wie bekomme ich Zugang zur Virtual Number API?
Erstellen Sie ein kostenloses VRNUM-Konto, öffnen Sie den Tab „Entwickler“ und generieren Sie einen API-Schlüssel. Keine Wartezeit auf Genehmigung, keine monatliche API-Gebühr — Sie bezahlen nur von Ihrem Guthaben, wenn Sie eine Nummer bereitstellen.
Welche Authentifizierung verwendet die API?
Bearer-Token-Authentifizierung. Senden Sie Ihren API-Schlüssel als Authorization: Bearer-Header oder als X-API-Key-Header bei jeder Anfrage.
Besteht ein Risiko von doppelten Bestellungen, wenn eine Anfrage zeitüberschreitet?
Nein. Jeder Endpoint für Käufe akzeptiert einen Idempotency-Key-Header — wiederholen Sie dieselbe Anfrage mit demselben Schlüssel, und Sie erhalten die ursprüngliche Bestellung zurück, anstatt eine doppelte Belastung.
Wie werde ich benachrichtigt, wenn eine Nummer bereit ist oder eine SMS eintrifft?
Registrieren Sie eine Webhook-URL im Tab „Entwickler“. VRNUM POSTet signierte Ereignisse (number.provisioned, number.provisioning_failed, sms.received) an Ihren Endpoint und versucht automatisch fehlgeschlagene Zustellungen erneut.
Was sind die API-Rate-Limits?
60 Anfragen pro Schlüssel pro Minute. Jede Antwort enthält die Header X-RateLimit-Limit, X-RateLimit-Remaining und X-RateLimit-Reset, sodass Sie sauber zurücksetzen können.
Beginnen Sie noch heute mit dem Wiederverkauf virtueller Nummern
Erstellen Sie ein kostenloses Konto, generieren Sie Ihren API-Schlüssel und stellen Sie Ihre erste virtuelle Nummer in wenigen Minuten bereit.