OTP Verification API
für Wiederverkäufer
Verkaufen Sie Einweg-SMS-Verifizierungsnummern ab 0,10 $ über eine einzige REST-API weiter. Sofortige Bereitstellung, vollständige Erstattung für ungenutzte Aktivierungen und signierte Webhooks – bauen Sie Ihre eigene OTP-Plattform auf echten Netzbetreibernummern auf.
Eine API für jede Einmal-SMS-Verifizierung, die Sie benötigen
Kostenlose öffentliche SMS-Postfächer sind öffentlich lesbar und bereits von jeder großen Plattform markiert. Eigene Netzwerkbetreiberbeziehungen für Einwegnummern aufzubauen ist teuer, für etwas, das Kunden einmal verwenden und dann wegwerfen.
Die VRNUM OTP-API bietet Ihnen einen Live-Privatpool echter Netzbetreibernummern auf Abruf. Stellen Sie eine bereit, empfangen Sie den Code, und die Nummer wird niemals jemand anderem angezeigt – mit Ihrem Aufschlag bereits auf jeden angezeigten Preis angewendet.
Von der Bestellung bis zum verifizierten Code
Vier Aufrufe decken den gesamten OTP-Lebenszyklus ab.
Überprüfen Sie den Katalog
GET /otp-catalog für aktuelle Dienste, Länder und Preise – wenden Sie Ihre Aufschläge an, bevor Sie sie Kunden anzeigen.
Eine Nummer bestellen
POST /otp-numbers mit einem Service, Land und Idempotency-Key. Eine Nummer wird sofort zurückgegeben.
Den Code abrufen
GET /otp-numbers/:id prüft live auf die SMS oder warten Sie auf das otp.completed Webhook-Ereignis.
Erneut senden oder zurückerstatten
Noch kein Code? Versuchen Sie /resend oder /cancel für eine sofortige vollständige Rückerstattung auf Ihr Wallet.
Eine OTP-Nummer in einer Anfrage bestellen
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/otp-numbers \
-H "Authorization: Bearer vrnum_live_..." \
-H "Content-Type: application/json" \
-H "Idempotency-Key: otp-5521" \
-d '{
"service": "whatsapp",
"countryCode": "us",
"clientReference": "otp-5521"
}'Ein vollständiger OTP-Bestelllebenszyklus
Katalog, Bestellung, erneut senden, stornieren/rückerstatten und Webhooks — eine konsistente JSON-API.
/api/v1/otp-catalog/api/v1/otp-numbers/api/v1/otp-numbers/api/v1/otp-numbers/:id/api/v1/otp-numbers/:id/resend/api/v1/otp-numbers/:id/cancel/api/v1/webhook/api/v1/balanceVollständige Anfrage-/Antwortdokumentation und Ihre Schlüssel befinden sich in IhremDashboard, nachdem Sie sich angemeldet haben.
Wer baut auf der OTP-Verifizierungs-API auf
Jedes Produkt, das eine echte Telefonnummer für einen einmaligen Verifizierungsschritt benötigt.
SMS-Verifizierungsplattformen
Verkaufen Sie OTP-Nummern unter Ihrer eigenen Marke an Ihre Kunden weiter, mit Ihrem eigenen Aufschlag auf jeden Service.
QA- und Testautomatisierung
Erstellen Sie einmalige Testkonten auf Produktionsdiensten, ohne persönliche Telefonnummern zu verwenden.
Bot- und Agentur-Tools
Bereitstellungsnummern programmatisch für Workflows zur Kontoerstellung bereitstellen, die für Kunden erstellt wurden.
Entwicklertools
Bieten Sie 'Über SMS verifizieren' als Funktion in Ihrer eigenen App oder SDK an, ohne eigene Telekommunikationsinfrastruktur zu besitzen.
Zuverlässig genug, um Ihre eigenen Kunden abzurechnen
Idempotenz-Schlüssel
Sicher bei Zeitüberschreitungen erneut versuchen – derselbe Idempotenz-Schlüssel gibt immer die ursprüngliche Bestellung zurück, niemals ein Duplikat.
Signierte Webhooks
otp.completed, number.provisioned und number.provisioning_failed Ereignisse, signiert mit X-VRNUM-Signature.
Automatische Wiederholungen
Fehlgeschlagene Webhook-Zustellungen werden nach einem Backoff-Zeitplan erneut versucht (5min, 30min, 2h, 6h, 24h), bevor wir aufgeben.
Transparente Ratenbegrenzungen
60 Anfragen/Minute pro Schlüssel mit X-RateLimit-* Headern in jeder Antwort.
Wallet-finanziertes Abrechnungssystem
Keine Rechnungen oder Abonnements – Bestellungen und Rückerstattungen werden sofort nach ihrer Ausführung Ihrem Guthaben gutgeschrieben.
Stabile Fehlercodes
Jeder Fehler gibt einen normierten JSON-Code zurück, auf den Ihre Integration zuverlässig reagieren kann.
Häufig gestellte Fragen
Kann ich OTP-Nummern über die VRNUM API weiterverkaufen?
Ja. Die Endpunkte otp-catalog und otp-numbers geben nur Ihren Wiederverkaufspreis zurück. Legen Sie Ihre eigene Marge pro Dienstleistung und Land fest – Ihre Kunden sehen nie die internen Kosten von VRNUM.
Was passiert, wenn der OTP-Code nie ankommt?
Rufen Sie POST /otp-numbers/:id/cancel bei einer noch wartenden Aktivierung auf, um eine vollständige Rückerstattung auf Ihre Wallet zu erhalten. Sie können auch zuerst den Resend-Endpunkt aufrufen.
Wie lange bleibt eine OTP-Aktivierung über die API gültig?
Jede Aktivierung bleibt 20 Minuten ab Erstellung aktiv. Stornieren Sie sie vor Ablauf, um eine vollständige Rückerstattung zu erhalten, falls kein Code ankommt.
Wie vermeide ich eine doppelte Belastung eines Kunden bei einem erneuten Versuch?
Senden Sie einen Idempotency-Key-Header bei POST /otp-numbers. Ein erneutes Senden derselben Anfrage mit demselben Key liefert die ursprüngliche Bestellung zurück, anstatt eine neue zu erstellen.
Kann ich Echtzeit-Lieferereignisse erhalten, anstatt abzufragen?
Ja. Registrieren Sie einen Webhook-Endpunkt und erhalten Sie signierte otp.completed-Ereignisse sofort, wenn sie auftreten, anstatt abzufragen.
Welche Dienste werden über die API unterstützt?
Über 80 Dienste, darunter WhatsApp, Telegram, Google, Instagram, Facebook, Discord und mehr. Rufen Sie GET /otp-catalog für die aktuelle Liste auf.
Beginnen Sie noch heute mit dem Weiterverkauf von OTP-Nummern.
Erstellen Sie ein kostenloses Konto, generieren Sie Ihren API-Schlüssel und stellen Sie Ihre erste OTP-Nummer in wenigen Minuten bereit.