OTP Verification API
för återförsäljare
Återförsälj engångs-SMS-verifieringsnummer från $0,10 via ett REST API. Omedelbar tilldelning, full återbetalning för oanvända aktiveringar och signerade webhooks — bygg din egen OTP-plattform ovanpå riktiga operatörsnummer.
Ett API för alla engångs-SMS-verifieringar du behöver
Gratis publika SMS-inkorgar är offentligt läsbara och redan flaggade av alla större plattformar. Att bygga egna operatörsrelationer för engångsnummer är dyrt att sätta upp för något som kunderna bara använder en gång och sedan kastar.
VRNUM OTP API ger dig en live, privat pool av riktiga operatörsnummer på begäran. Tilldela ett, ta emot koden, och numret visas aldrig för någon annan — med din påslag redan applicerad på varje pris du visar.
Från beställning till verifierad kod
Fyra anrop täcker hela OTP-livscykeln.
Kolla katalogen
GET /otp-catalog för aktuella tjänster, länder och priser — applicera din påslag innan du visar kunderna.
Beställ ett nummer
POST /otp-numbers med en tjänst, land och Idempotency-Key. Ett nummer returneras omedelbart.
Hämta koden
GET /otp-numbers/:id kontrollerar live för SMS, eller vänta på otp.completed webhook-händelsen.
Skicka om eller återbetala
Ingen kod än? Prova /resend, eller /cancel för en omedelbar full återbetalning till din plånbok.
Beställ ett OTP-nummer i en förfrågan
clientReference är ditt eget ogenomskinliga ID — bifoga det för att stämma av order mot dina interna kundregister.
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"
}'En komplett OTP-ordercykel
Katalog, beställning, skicka om, avboka/återbetala och webhooks — ett konsekvent 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/balanceFullständiga dokument för förfrågningar/respons och dina nycklar finns i dindashboardefter att du loggat in.
Vem bygger på OTP-verifierings-API:t
Alla produkter som behöver ett riktigt telefonnummer för ett enda verifieringssteg.
SMS-verifieringsplattformar
Sälj OTP-nummer vidare till dina egna kunder under ditt varumärke, med din egen påslag på varje tjänst.
QA- och testautomation
Skapa engångstestkonton på produktionsservrar utan att använda personliga telefonnummer.
Bot- och agenturverktyg
Tilldela nummer programmässigt för konto-skapande arbetsflöden byggda för kunder.
Utvecklarverktyg
Erbjud 'verifiera med SMS' som en funktion i din egen app eller SDK utan att äga telekominfrastruktur.
Tillförlitlig nog för att fakturera dina egna kunder på
Idempotensnycklar
Försök igen säkert vid timeout — samma Idempotens-Key returnerar alltid den ursprungliga beställningen, aldrig en kopia.
Signerade webhooks
otp.completed, number.provisioned och number.provisioning_failed händelser, signerade med X-VRNUM-Signature.
Automatiska omfö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.
Transparenta hastighetsgränser
60 förfrågningar/minut per nyckel med X-RateLimit-* headers i varje svar.
Plånboksfinansierad fakturering
Inga fakturor eller prenumerationer — beställningar och återbetalningar bokförs på ditt saldo direkt när de sker.
Stabila felkoder
Varje fel returnerar en normaliserad JSON-kod som din integration kan lita på.
Vanliga frågor
Kan jag sälja vidare OTP-nummer via VRNUM API?
Ja. otp-catalog och otp-numbers-endpunkterna returnerar endast ditt vidareförsäljningspris. Sätt din egen marginal per tjänst och land — dina kunder ser aldrig VRNUM:s interna kostnad.
Vad händer om OTP-koden aldrig kommer?
Ring POST /otp-numbers/:id/cancel på en fortfarande väntande aktivering för full återbetalning till din plånbok. Du kan också ringa återutsändnings-endpointen först.
Hur länge är en OTP-aktivering giltig via API:et?
Varje aktivering är aktiv i 20 minuter från skapandet. Avbryt innan den går ut för full återbetalning om ingen kod kommer.
Hur undviker jag dubbeldebitering av en kund vid omförsök?
Skicka en Idempotency-Key-header på POST /otp-numbers. Att försöka samma begäran med samma nyckel returnerar den ursprungliga beställningen istället för att skapa en ny.
Kan jag få realtidsleveranshändelser istället för att polka?
Ja. Registrera en webhook-endpoint och ta emot signerade otp.completed-händelser i samma ögonblick som de inträffar, istället för att polka.
Vilka tjänster stöds via API:et?
80+ tjänster inklusive WhatsApp, Telegram, Google, Instagram, Facebook, Discord och fler. Ring GET /otp-catalog för den aktuella listan.
Börja sälja OTP-nummer idag
Skapa ett gratis konto, generera din API-nyckel och tilldela ditt första OTP-nummer på bara några minuter.