API Numerów Wirtualnych
dla Resellerów
Programowo zapewniaj dedykowane wirtualne numery telefonów miesięczne i roczne, ustalaj własną cenę odsprzedaży i buduj swoją własną markę weryfikacji SMS — bez posiadania ani jednej karty SIM.
Dlaczego budować na API VRNUM zamiast własnych umów z operatorami
Pozyskiwanie prawdziwych numerów od operatorów mobilnych oznacza umowy SIM, sprzęt, wymogi zgodności oraz miesiące oczekiwania, zanim będziesz mógł sprzedać nawet jedną weryfikację. API VRNUM omija to wszystko.
Otrzymujesz natychmiastowy dostęp do aktywnego zasobu miesięcznych i rocznych numerów wirtualnych w ponad 50 krajach, z własną marżą dodaną do każdej ceny zwracanej przez API. Twoi klienci widzą tylko Twoją markę i Twoją cenę.
Od klucza API do Twojej pierwszej sprzedaży
Cztery kroki do działającej integracji dla resellerów.
Wygeneruj klucz API
Utwórz darmowe konto VRNUM i wygeneruj klucz w zakładce Developers. Jeden aktywny klucz na konto.
Zasil portfel
Doładuj kryptowalutą. Każde zamówienie jest pobierane z twojego salda — brak faktur, brak ręcznego rozliczania.
Przeczytaj katalog
Wywołaj GET /catalog, aby zobaczyć aktualne kraje, warunki subskrypcji i ceny. Dodaj swoją marżę przed ich wyświetleniem.
Provision na żądanie
POST /numbers z Idempotency-Key, aby natychmiast przypisać numer, a następnie sprawdzaj status lub używaj webhooków do dostawy.
Provision numer w jednym żądaniu
clientReference is your own opaque ID — attach it to reconcile orders against your internal customer records.
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"
}'Everything you need to run the full order lifecycle
Catalog, provisioning, SMS retrieval, renewal, auto-renew, and webhooks — one consistent 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/balanceFull request/response docs and your keys live in your dashboard after you sign in.
Who builds on the virtual number API
Any business that needs a supply of real phone numbers without owning telecom infrastructure.
Telecom resellers
Launch your own numbers-as-a-service brand on top of live carrier inventory without a single SIM contract.
Założyciele SaaS i aplikacji
Dodaj obsługę numerów telefonów do procesu rejestracji lub weryfikacji w swoim produkcie za pomocą kilku wywołań API.
Agencje deweloperskie
Dostarczaj funkcje obsługi numerów dla aplikacji klientów bez konieczności negocjowania własnych umów z operatorami.
Zespoły QA i automatyzacji
Udostępniaj jednorazowe, ale prawdziwe numery na żądanie do automatycznych testów rejestracji i weryfikacji.
Stworzone do produkcji, nie do demonstracji
Klucze idempotencji
Ponawiaj bezpiecznie próby w przypadku przekroczenia limitu czasu — ten sam Idempotency-Key zawsze zwraca oryginalne zamówienie, nigdy duplikatu.
Podpisane webhooki
zdarzenia number.provisioned, number.provisioning_failed i sms.received, podpisane X-VRNUM-Signature (HMAC-SHA256).
Automatyczne ponawianie prób
Nieudane dostarczenia webhooków są ponawiane według harmonogramu backoff (5 min, 30 min, 2 h, 6 h, 24 h), zanim poddamy się.
Przejrzyste limity szybkości
60 żądań/minutę na klucz z nagłówkami X-RateLimit-* w każdej odpowiedzi, dzięki czemu można przewidywalnie się wycofać.
Rozliczenia finansowane z portfela
Brak faktur ani subskrypcji za dostęp do API — zamówienia są odliczane od salda natychmiast po ich powodzeniu.
Stabilne kody błędów
Każdy błąd zwraca znormalizowany kod JSON, na którym Twoja integracja może niezawodnie działać, a nie tylko status HTTP.
Najczęściej zadawane pytania
Czy mogę odsprzedawać wirtualne numery VRNUM pod własną marką?
Tak. API zwraca tylko Twoją cenę odsprzedaży — Twoi klienci nigdy nie zobaczą wewnętrznego kosztu VRNUM ani źródłowego operatora. Ustalasz własną marżę dla każdego kraju i usługi.
Jak uzyskać dostęp do API wirtualnych numerów?
Utwórz darmowe konto VRNUM, otwórz zakładkę Deweloperzy i wygeneruj klucz API. Brak oczekiwania na zatwierdzenie, brak miesięcznej opłaty za API — płacisz tylko z salda portfela przy provisioningu numeru.
Jakie uwierzytelnianie stosuje API?
Uwierzytelnianie za pomocą tokena Bearer. Wyślij swój klucz API w nagłówku Authorization: Bearer lub w nagłówku X-API-Key przy każdym żądaniu.
Czy istnieje ryzyko podwójnych zamówień, jeśli żądanie przekroczy czas oczekiwania?
Nie. Każdy endpoint zakupu akceptuje nagłówek Idempotency-Key — jeśli wyślesz to samo żądanie z tym samym kluczem, otrzymasz pierwotne zamówienie zamiast podwójnej opłaty.
Jak otrzymywać powiadomienia, gdy numer jest gotowy lub przychodzi SMS?
Zarejestruj URL webhooka w zakładce Deweloperzy. VRNUM wysyła podpisane zdarzenia (number.provisioned, number.provisioning_failed, sms.received) na Twój endpoint, automatycznie ponawiając nieudane dostarczenia.
Jakie są limity zapytań API?
60 żądań na klucz na minutę. Każda odpowiedź zawiera nagłówki X-RateLimit-Limit, X-RateLimit-Remaining i X-RateLimit-Reset, dzięki czemu możesz odpowiednio zwolnić tempo.
Rozpocznij odsprzedaż numerów wirtualnych już dziś
Utwórz darmowe konto, wygeneruj swój klucz API i udostępnij swój pierwszy numer wirtualny w kilka minut.