OTP Verification API
dla Odsprzedawców
Odsprzedawaj jednorazowe numery weryfikacyjne SMS już od 0,10 USD za pomocą jednego REST API. Natychmiastowe udostępnianie, pełny zwrot za nieużywane aktywacje i podpisane webhooki — stwórz własną platformę OTP w oparciu o prawdziwe numery operatorów.
Jedno API do każdej jednorazowej weryfikacji SMS, której potrzebujesz
Darmowe publiczne skrzynki SMS są publicznie czytelne i już oznaczone przez każdą dużą platformę. Tworzenie własnych relacji z operatorami dla jednorazowych numerów jest kosztowne do wdrożenia na coś, czego klienci używają tylko raz i wyrzucają.
VRNUM OTP API daje ci na żądanie żywą, prywatną pulę numerów od prawdziwych operatorów. Udostępnij jeden, otrzymaj kod, a numer nigdy nie jest pokazywany nikomu innemu — z twoją marżą już zastosowaną do każdej ceny, którą wyświetlasz.
Od zamówienia do zweryfikowanego kodu
Cztery wywołania obejmują cały cykl życia OTP.
Sprawdź katalog
GET /otp-catalog, aby zobaczyć aktualne usługi, kraje i ceny — zastosuj swoją marżę przed pokazaniem klientom.
Zamów numer
POST /otp-numbers z usługą, krajem i Idempotency-Key. Numer zwracany jest natychmiast.
Pobierz kod
GET /otp-numbers/:id sprawdza na żywo SMS lub poczekaj na wydarzenie webhook otp.completed.
Wyślij ponownie lub zwróć
Brak jeszcze kodu? Spróbuj /resend lub /cancel, aby natychmiastowy pełny zwrot na Twój portfel.
Zamów numer OTP w jednym żądaniu
clientReference to Twój własny nieprzezroczysty identyfikator — dołącz go, aby uzgodnić zamówienia z Twoimi wewnętrznymi rekordami klientów.
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"
}'Pełny cykl życia zamówienia OTP
Katalog, zamawianie, wysyłka ponowna, anulowanie/zwrot oraz webhooki — jedno spójne API JSON.
/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/balancePełna dokumentacja żądań/odpowiedzi oraz twoje klucze znajdują się w twoimpanelupo zalogowaniu się.
Kto korzysta z API weryfikacji OTP
Każdy produkt, który potrzebuje prawdziwego numeru telefonu do jednego kroku weryfikacji.
Platformy weryfikacji SMS
Sprzedawaj numery OTP swoim własnym klientom pod własną marką, z własnym narzutem na każdej usłudze.
QA i automatyzacja testów
Twórz jednorazowe konta testowe w usługach produkcyjnych bez używania osobistych numerów telefonów.
Narzędzia dla botów i agencji
Programowo przydzielaj numery w przepływach pracy tworzenia kont dla klientów.
Narzędzia dla programistów
Oferuj funkcję 'weryfikacja za pomocą SMS' w swojej aplikacji lub SDK bez posiadania infrastruktury telekomunikacyjnej.
Wystarczająco niezawodne, aby rozliczać własnych klientów
Klucze idempotencji
Bezpiecznie ponawiaj próby przy przekroczeniu limitu czasu — ten sam Klucz-Idempotencji zawsze zwraca oryginalne zamówienie, nigdy duplikatu.
Podpisane webhooki
d wydarzenia otp.completed, number.provisioned i number.provisioning_failed, podpisane za pomocą X-VRNUM-Signature.
Automatyczne ponawianie prób
Nieudane dostarczenia webhooków są ponawiane według harmonogramu (5 min, 30 min, 2 h, 6 h, 24 h), zanim poddamy się.
Przejrzyste limity żądań
60 żądań/minutę na klucz z nagłówkami X-RateLimit-* w każdej odpowiedzi.
Rozliczenia finansowane z portfela
Brak faktur ani subskrypcji — zamówienia i zwroty są od razu księgowane na Twoim saldzie w momencie ich wystąpienia.
Stabilne kody błędów
Każdy błąd zwraca znormalizowany kod JSON, na którym można niezawodnie polegać w integracji.
Najczęściej zadawane pytania
Czy mogę odsprzedawać numery OTP za pośrednictwem API VRNUM?
Tak. Endpointy otp-catalog i otp-numbers zwracają wyłącznie Twój cenę odsprzedaży. Ustaw własną marżę dla każdej usługi i kraju — Twoi klienci nigdy nie zobaczą wewnętrznego kosztu VRNUM.
Co się stanie, jeśli kod OTP nigdy nie dotrze?
Wywołaj POST /otp-numbers/:id/cancel na aktywacji, która nadal oczekuje, aby otrzymać pełny zwrot na portfel. Możesz również najpierw wywołać punkt końcowy resend.
Jak długo ważna jest aktywacja OTP za pośrednictwem API?
Każda aktywacja pozostaje aktywna przez 20 minut od momentu utworzenia. Anuluj przed jej wygaśnięciem, aby otrzymać pełny zwrot, jeśli kod nie dotrze.
Jak uniknąć podwójnego obciążenia klienta przy ponownej próbie?
Wyślij nagłówek Idempotency-Key przy POST /otp-numbers. Ponowne wywołanie tego samego żądania z tym samym kluczem zwraca oryginalne zamówienie zamiast tworzyć nowe.
Czy mogę otrzymywać zdarzenia dostarczenia w czasie rzeczywistym zamiast odpytywania?
Tak. Zarejestruj punkt końcowy webhook i odbieraj podpisane zdarzenia otp.completed w momencie ich wystąpienia, zamiast odpytywania.
Które usługi są obsługiwane przez API?
Ponad 80 usług, w tym WhatsApp, Telegram, Google, Instagram, Facebook, Discord i inne. Wywołaj GET /otp-catalog, aby zobaczyć aktualną listę.
Rozpocznij odsprzedaż numerów OTP już dziś
Utwórz bezpłatne konto, wygeneruj swój klucz API i uruchom swój pierwszy numer OTP w kilka minut.